Estructura HDITEMA (commctrl.h)

  • Artículo

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
HDI_BITMAP
 El miembro hbm es válido.
HDI_DI_SETITEM
 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).
HDI_FORMAT
 El miembro fmt es válido.
HDI_FILTER
 Los miembros type y pvFilter son válidos. Se usa para filtrar los valores especificados en el miembro de tipo .
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 miembro de estado es válido.
HDI_TEXT
 Los miembros 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

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
Justificación de texto:
 Establezca una de las siguientes marcas 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.
Mostrar:
 Establezca una de las siguientes marcas para controlar la pantalla:
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
 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.
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 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.
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 de 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 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
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 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
HDIS_FOCUSED
 El elemento tiene el foco del teclado.

Comentarios

Nota Comctl32.dll versión 6 no es redistribuible, pero se incluye en Windows. Para usar Comctl32.dll versión 6, especifíquela 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 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