TreeView_GetItem macro (commctrl.h)

Artigo
10/24/2024

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

Sintaxe

BOOL TreeView_GetItem(
   HWND     hwnd,
   LPTVITEM pitem
);

Parâmetros

hwnd

Tipo: HWND

Manipule para o controle de exibição de árvore.

pitem

Tipo: LPTVITEM

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

Valor de retorno

Tipo: BOOL

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

Observações

Quando a mensagem TVM_GETITEM é enviada, o hItem membro do TVITEM ou TVITEMEX identifica o item sobre o qual recuperar informações e a máscara membro especifica os atributos a serem recuperados.

Se o sinalizador TVIF_TEXT estiver definido na máscara membro do TVITEM ou estrutura 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. O texto retornado não será necessariamente armazenado no buffer original passado pelo aplicativo. É possível que pszText aponte para o texto em um novo buffer em vez de colocá-lo no buffer antigo.

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