TreeView_GetNextItem macro (commctrl.h)

Artigo
10/24/2024

Recupera o item de exibição de árvore que tem a relação especificada com um item especificado. Você pode usar essa macro, usar uma das macros TreeView_Get descritas abaixo ou enviar a mensagem TVM_GETNEXTITEM explicitamente.

Sintaxe

HTREEITEM TreeView_GetNextItem(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

Parâmetros

hwnd

Tipo: HWND

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

hitem

Tipo: HTREEITEM

Manipule para um item.

code

Tipo: UINT

Sinalizador especificando o item a ser recuperado. Esse parâmetro pode ser um dos seguintes valores:

Valor	Significado
TVGN_CARET	Recupera o item selecionado no momento. Você pode usar a macro TreeView_GetSelection para enviar essa mensagem.
TVGN_CHILD	Recupera o primeiro item filho do item especificado pelo parâmetro hitem. Você pode usar a macro TreeView_GetChild para enviar essa mensagem.
TVGN_DROPHILITE	Recupera o item que é o destino de uma operação de arrastar e soltar. Você pode usar a macro TreeView_GetDropHilight para enviar essa mensagem.
TVGN_FIRSTVISIBLE	Recupera o primeiro item visível. Você pode usar a macro TreeView_GetFirstVisible para enviar essa mensagem.
TVGN_NEXT	Recupera o próximo item irmão. Você pode usar a macro TreeView_GetNextSibling para enviar essa mensagem.
TVGN_NEXTSELECTED	Windows Vista e posterior. Recupera o próximo item selecionado. Você pode usar a macro TreeView_GetNextSelected para enviar essa mensagem.
TVGN_NEXTVISIBLE	Recupera o próximo item visível que segue o item especificado. O item especificado deve estar visível. Use a mensagem TVM_GETITEMRECT para determinar se um item está visível. Você pode usar a macro TreeView_GetNextVisible para enviar essa mensagem.
TVGN_PARENT	Recupera o pai do item especificado. Você pode usar a macro TreeView_GetParent para enviar essa mensagem.
TVGN_PREVIOUS	Recupera o item irmão anterior. Você pode usar a macro TreeView_GetPrevSibling para enviar essa mensagem.
TVGN_PREVIOUSVISIBLE	Recupera o primeiro item visível que precede o item especificado. O item especificado deve estar visível. Use a mensagem TVM_GETITEMRECT para determinar se um item está visível. Você pode usar a macro TreeView_GetPrevVisible para enviar essa mensagem.
TVGN_ROOT	Recupera o item superior ou muito primeiro do controle de exibição de árvore. Você pode usar a macro TreeView_GetRoot para enviar essa mensagem.

Valor de retorno

Tipo: HTREEITEM

Retorna o identificador para o item se bem-sucedido. Para a maioria dos casos, a mensagem retorna um valor NULL para indicar um erro. Consulte a seção Comentários para obter detalhes.

Observações

Essa macro retornará NULL se o item que está sendo recuperado for o nó raiz da árvore. Por exemplo, se você usar essa macro com o sinalizador TVGN_PARENT em um filho de primeiro nível do nó raiz do modo de exibição de árvore, a macro retornará NULL.

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