Compartir a través de

Estructura HDITEMW (commctrl.h)

  • Artículo

Contiene información sobre un elemento de un control de encabezado. Esta estructura reemplaza a la estructura de HD_ITEM.

Sintaxis

typedef struct _HD_ITEMW {
  UINT    mask;
  int     cxy;
  LPWSTR  pszText;
  HBITMAP hbm;
  int     cchTextMax;
  int     fmt;
  LPARAM  lParam;
  int     iImage;
  int     iOrder;
  UINT    type;
  void    *pvFilter;
  UINT    state;
} HDITEMW, *LPHDITEMW;

Miembros

mask

Tipo: UINT de

Marcas que indican qué otros miembros de la estructura contienen datos válidos o deben rellenarse. Este miembro puede ser una combinación de los siguientes valores:

Valor Significado
HDI_BITMAP
 El miembro hbm es válido.
HDI_DI_SETITEM
 Mientras controla el mensaje HDM_GETITEM, es posible que el control de encabezado no tenga todos los valores necesarios para completar la solicitud. En este caso, el control debe volver a llamar a la aplicación para los valores a través de la notificación HDN_GETDISPINFO. Si HDI_DI_SETITEM se ha pasado en el mensaje de HDM_GETITEM, el control almacenará en caché los valores devueltos de HDN_GETDISPINFO (de lo contrario, los valores permanecen sin establecer).
HDI_FORMAT
 El miembro fmt es válido.
HDI_FILTER
 Los de tipo y miembros de pvFilter son válidos. Se usa para filtrar los valores especificados en el tipo miembro.
HDI_HEIGHT
 Igual que HDI_WIDTH.
HDI_IMAGE
 El miembro iImage es válido y especifica la imagen que se va a mostrar con el elemento.
HDI_LPARAM
 El miembro lParam es válido.
HDI_ORDER
 El miembro iOrder es válido y especifica el valor de orden del elemento.
HDI_STATE

versión 6.00 y posteriores. El estado miembro es válido.
HDI_TEXT
 Los miembros de pszText y cchTextMax son válidos.
HDI_WIDTH
 El miembro cxy es válido y especifica el ancho del elemento.

cxy

Tipo: int

Ancho o alto del elemento.

pszText

Tipo: LPTSTR de

Puntero a una cadena de elemento. Si el texto se recupera del control , este miembro debe inicializarse para que apunte a un búfer de caracteres. Si este miembro se establece en LPSTR_TEXTCALLBACK, el control solicitará información de texto para este elemento mediante el envío de un código de notificación de HDN_GETDISPINFO. Tenga en cuenta que, aunque el control de encabezado permite almacenar una cadena de cualquier longitud como texto de elemento, solo se muestran los primeros 260 TCHARs.

hbm

Tipo: HBITMAP de

Identificador del mapa de bits del elemento.

cchTextMax

Tipo: int

Longitud de la cadena de elemento, en TCHARs. Si el texto se recupera del control , este miembro debe contener el número de de TCHAR en la dirección especificada por pszText.

fmt

Tipo: int

Marcas que especifican el formato del elemento.

Valor Significado
justificación de texto :
 Establezca una de las marcas siguientes para especificar la justificación de texto:
HDF_CENTER
 El contenido del elemento se centra.
HDF_LEFT
 El contenido del elemento está alineado a la izquierda.
HDF_RIGHT
 El contenido del elemento está alineado a la derecha.
pantalla de :
 Establezca una de las marcas siguientes para controlar la presentación:
HDF_BITMAP
 El elemento muestra un mapa de bits.
HDF_BITMAP_ON_RIGHT
 El mapa de bits aparece a la derecha del texto.
HDF_OWNERDRAW
 El propietario del control de encabezado dibuja el elemento.
HDF_STRING
 El elemento muestra una cadena.
combinar marcas:
 El valor anterior se puede combinar con:
HDF_IMAGE
 Mostrar una imagen de una lista de imágenes. Especifique la lista de imágenes enviando un mensaje de HDM_SETIMAGELIST. Especifique el índice de la imagen en el miembro de iImage de esta estructura.
HDF_JUSTIFYMASK
 Aísle los bits correspondientes a las tres marcas de justificación enumeradas en la tabla anterior.
HDF_RTLREADING
 Normalmente, las ventanas muestran texto de izquierda a derecha (LTR). Windows se puede reflejado para mostrar idiomas como hebreo o árabe que leen de derecha a izquierda (RTL). Normalmente, el texto del encabezado se lee en la misma dirección que el texto de su ventana primaria. Si se establece HDF_RTLREADING, el texto del encabezado leerá en la dirección opuesta del texto de la ventana primaria.
HDF_SORTDOWN

versión 6.00 y posteriores. Dibuja una flecha abajo en este elemento. Normalmente se usa para indicar que la información de la ventana actual se ordena en esta columna en orden descendente. Esta marca no se puede combinar con HDF_IMAGE o HDF_BITMAP.
HDF_SORTUP

versión 6.00 y posteriores. Dibuja una flecha arriba en este elemento. Normalmente se usa para indicar que la información de la ventana actual se ordena en esta columna en orden ascendente. Esta marca no se puede combinar con HDF_IMAGE o HDF_BITMAP.
HDF_CHECKBOX

versión 6.00 y posteriores. El elemento muestra una casilla. La marca solo es válida cuando el estilo HDS_CHECKBOXES se establece primero en el control de encabezado.
HDF_CHECKED

versión 6.00 y posteriores. El elemento muestra una casilla activada. La marca solo es válida cuando también se establece HDF_CHECKBOX.
HDF_FIXEDWIDTH

versión 6.00 y posteriores. La acción del usuario no puede modificar el ancho del elemento para cambiar su tamaño.
HDF_SPLITBUTTON

versión 6.00 y posteriores. El elemento muestra un botón de división. La HDN_DROPDOWN notificación se envía cuando se hace clic en el botón de división.

lParam

Tipo: LPARAM de

Datos de elementos definidos por la aplicación.

iImage

Tipo: int

Índice de base cero de una imagen dentro de la lista de imágenes. La imagen especificada se mostrará en el elemento de encabezado además de cualquier imagen especificada en el campo hbm . Si iImage se establece en I_IMAGECALLBACK, el control solicita información de texto para este elemento mediante un código de notificación de HDN_GETDISPINFO. Para borrar la imagen, establezca este valor en I_IMAGENONE.

iOrder

Tipo: int

Orden en el que aparece el elemento dentro del control de encabezado, de izquierda a derecha. Es decir, el valor del elemento de extremo izquierdo es 0. El valor del siguiente elemento a la derecha es 1, etc.

type

Tipo: UINT de

Tipo de filtro especificado por pvFilter. Entre los tipos posibles se incluyen:

Valor Significado
HDFT_ISSTRING
 Datos de cadena.
HDFT_ISNUMBER
 Datos numéricos.
HDFT_HASNOVALUE
 Ignore pvFilter.
HDFT_ISDATE

versión 6.00 y posteriores. Datos de fecha. El miembro pvFilter es un puntero a una estructura de SYSTEMTIME.

pvFilter

Tipo: void*

Dirección de un elemento de datos definido por la aplicación. El tipo de filtro de datos se determina estableciendo el valor de marca del miembro. Use la marca HDFT_ISSTRING para indicar una cadena y HDFT_ISNUMBER para indicar un entero. Cuando se usa la marca HDFT_ISSTRING pvFilter es un puntero a una estructura HDTEXTFILTER.

state

Tipo: UINT de

El estado. El único valor válido admitido para este miembro es el siguiente:

Valor Significado
HDIS_FOCUSED
 El elemento tiene el foco del teclado.

Observaciones

Nota Comctl32.dll versión 6 no se puede redistribuir, pero se incluye en Windows. Para usar Comctl32.dll versión 6, especifíquelo en un manifiesto. Para obtener más información sobre los manifiestos, vea Habilitación de estilos visuales.
 

Nota

El encabezado commctrl.h define HDITEM como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de commctrl.h