macro TreeView_GetNextItem (commctrl.h)

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

void TreeView_GetNextItem(
   hwnd,
   hitem,
   code
);

Parâmetros

hwnd

Tipo: HWND

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

hitem

Tipo: HTREEITEM

Identificador para um item.

code

Tipo: UINT

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

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.

Retornar valor

Nenhum

Comentários

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
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]
Plataforma de Destino	Windows
Cabeçalho	commctrl.h