Partilhar via


HDM_GETITEM mensagem

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

Parâmetros

wParam

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

lParam

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.

Valor retornado

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

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.

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]
Cabeçalho
Commctrl.h
Nomes Unicode e ANSI
HDM_GETITEMW (Unicode) e HDM_GETITEMA (ANSI)