macro Header_GetItem (commctrl.h)

Obtiene información sobre un elemento de un control de encabezado. Puede usar esta macro o enviar el mensaje HDM_GETITEM explícitamente.

Sintaxis

BOOL Header_GetItem(
   HWND     hwndHD,
   int      i,
   LPHDITEM phdi
);

Parámetros

hwndHD

Tipo: HWND

Identificador del control de encabezado.

i

Tipo: int

Índice del elemento para el que se va a recuperar la información.

phdi

Tipo: lpHDITEM

Puntero a una estructura HDITEM. Cuando se envía el mensaje, el máscara miembro indica el tipo de información que se solicita. Cuando el mensaje vuelve, los demás miembros reciben la información solicitada. Si el miembro máscara especifica cero, el mensaje devuelve TRUE pero no copia información en la estructura.

Valor devuelto

Tipo: BOOL de

Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario.

Observaciones

Si la marca HDI_TEXT está establecida en el miembro del de HDITEM, el control puede cambiar el miembro pszText miembro de la estructura para que apunte al nuevo texto en lugar de rellenar el búfer con el texto solicitado. Las aplicaciones no deben suponer que el texto siempre se colocará en el búfer solicitado.

La macro Header_GetItem se define de la siguiente manera:

#define Header_GetItem(hwndHD, i, phdi)      \

    (BOOL)SendMessage((hwndHD), HDM_GETITEM,   \

    (WPARAM)(int)(i), (LPARAM)(LPHDITEM)(phdi))

Requisitos

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