Partilhar via


TVM_GETITEM mensagem

Recupera alguns ou todos os atributos de um item de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetItem .

Parâmetros

wParam

Deve ser zero.

lParam

Ponteiro para uma estrutura TVITEM que especifica as informações a serem recuperadas e recebe informações sobre o item. Com a versão 4.71 e posterior, você pode usar uma estrutura TVITEMEX .

Valor retornado

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

Comentários

Quando a mensagem é enviada, o membro hItem da estrutura TVITEM ou TVITEMEX identifica o item sobre o qual recuperar informações e o membro mask especifica os atributos a serem recuperados.

Se o sinalizador TVIF_TEXT estiver definido no membro de máscara da estrutura TVITEM ou TVITEMEX , o membro pszText deverá apontar para um buffer válido e o membro cchTextMax deverá ser definido como o número de caracteres nesse buffer.

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
TVM_GETITEMW (Unicode) e ansi (TVM_GETITEMA )