macro Header_GetItem (commctrl.h)

Obtém informações sobre um item em um controle de cabeçalho. Você pode usar essa macro ou enviar a mensagem HDM_GETITEM explicitamente.

Sintaxe

void Header_GetItem(
   hwndHD,
   i,
   phdi
);

Parâmetros

hwndHD

Tipo: HWND

Um identificador para o controle de cabeçalho.

i

Tipo: int

O índice do item para o qual as informações devem ser recuperadas.

phdi

Tipo: LPHDITEM

Um ponteiro para uma estrutura HDITEM . Quando a mensagem é enviada, o membro da máscara indica o tipo de informação que está sendo solicitada. Quando a mensagem retorna, os outros membros recebem as informações solicitadas. Se o membro da máscara especificar zero, a mensagem retornará TRUE , mas não copiará nenhuma informação para a estrutura.

Retornar valor

Nenhum

Comentários

Se o sinalizador HDI_TEXT estiver definido no membro de máscara da estrutura HDITEM , o controle poderá alterar o membro pszText da estrutura para apontar para o novo texto em vez de preencher o buffer com o texto solicitado. Os aplicativos não devem assumir que o texto sempre será colocado no buffer solicitado.

A macro Header_GetItem é definida da seguinte maneira:

#define Header_GetItem(hwndHD, index, phdi)      \

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

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	commctrl.h