Estructura HDITEMA (commctrl.h)
Contiene información sobre un elemento de un control de encabezado. Esta estructura sustituye a la estructura HD_ITEM .
Sintaxis
typedef struct _HD_ITEMA {
UINT mask;
int cxy;
LPSTR pszText;
HBITMAP hbm;
int cchTextMax;
int fmt;
LPARAM lParam;
int iImage;
int iOrder;
UINT type;
void *pvFilter;
UINT state;
} HDITEMA, *LPHDITEMA;
Miembros
mask
Tipo: UINT
Marcas que indican qué otros miembros de estructura contienen datos válidos o deben rellenarse. Este miembro puede ser una combinación de los siguientes valores:
| Valor | Significado |
|---|---|
|
El miembro hbm es válido. |
|
Al controlar 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). |
|
El miembro fmt es válido. |
|
Los miembros type y pvFilter son válidos. Se usa para filtrar los valores especificados en el miembro de tipo . |
|
Igual que HDI_WIDTH. |
|
El miembro iImage es válido y especifica la imagen que se va a mostrar con el elemento. |
|
El miembro lParam es válido. |
|
El miembro iOrder es válido y especifica el valor de orden del elemento. |
|
Versión 6.00 y posteriores. El miembro de estado es válido. |
|
Los miembros pszText y cchTextMax son válidos. |
|
El miembro cxy es válido y especifica el ancho del elemento. |
cxy
Tipo: int
Ancho o alto del elemento.
pszText
Tipo: LPTSTR
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 está establecido en LPSTR_TEXTCALLBACK, el control solicitará información de texto para este elemento enviando 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 TCHAR.
hbm
Tipo: HBITMAP
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 TCHARen la dirección especificada por pszText.
fmt
Tipo: int
Marcas que especifican el formato del elemento.
| Valor | Significado |
|---|---|
|
Establezca una de las siguientes marcas para especificar la justificación de texto: |
|
El contenido del elemento se centra. |
|
El contenido del elemento está alineado a la izquierda. |
|
El contenido del elemento está alineado a la derecha. |
|
Establezca una de las siguientes marcas para controlar la pantalla: |
|
El elemento muestra un mapa de bits. |
|
El mapa de bits aparece a la derecha del texto. |
|
El propietario del control de encabezado dibuja el elemento. |
|
El elemento muestra una cadena. |
|
El valor anterior se puede combinar con: |
|
Muestra 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 iImage de esta estructura. |
|
Aísle los bits correspondientes a las tres marcas de justificación enumeradas en la tabla anterior. |
|
Normalmente, las ventanas muestran texto de izquierda a derecha (LTR). Windows se puede reflejar 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. |
|
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. |
|
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. |
|
Versión 6.00 y posteriores. El elemento muestra una casilla. La marca solo es válida cuando el estilo de HDS_CHECKBOXES se establece primero en el control de encabezado. |
|
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. |
|
Versión 6.00 y posteriores. La acción del usuario no puede modificar el ancho del elemento para cambiar su tamaño. |
|
Versión 6.00 y posteriores. El elemento muestra un botón de división. La notificación de HDN_DROPDOWN se envía cuando se hace clic en el botón de división. |
lParam
Tipo: LPARAM
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 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 lejano izquierdo es 0. El valor del siguiente elemento a la derecha es 1, etc.
type
Tipo: UINT
Tipo de filtro especificado por pvFilter. Entre los posibles tipos se incluyen:
| Valor | Significado |
|---|---|
|
Datos de cadena. |
|
Datos numéricos. |
|
Ignore pvFilter. |
|
Versión 6.00 y posteriores. Datos de fecha. El miembro pvFilter es un puntero a una estructura 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
Estado. El único valor válido admitido para este miembro es el siguiente:
| Valor | Significado |
|---|---|
|
El elemento tiene el foco del teclado. |
Comentarios
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 Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Encabezado | commctrl.h |