Header_GetItem macro (commctrl.h)

Artigo
10/24/2024

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

BOOL Header_GetItem(
   HWND     hwndHD,
   int      i,
   LPHDITEM 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, a máscara de membro indica o tipo de informação que está sendo solicitada. Quando a mensagem é retornada, os outros membros recebem as informações solicitadas. Se a máscara de membro especificar zero, a mensagem retornará TRUE mas não copiará nenhuma informação para a estrutura.

Valor de retorno

Tipo: BOOL

Retorna TRUE se tiver êxito ou false caso contrário.

Observações

Se o sinalizador HDI_TEXT estiver definido na máscara membro 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, i, phdi)      \

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

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

Requisitos

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

Compartilhar via