Compartilhar via


TVM_GETNEXTITEM mensagem

Recupera o item de exibição de árvore que tem a relação especificada com um item especificado. Você pode enviar essa mensagem explicitamente usando a macro TreeView_GetNextItem .

Parâmetros

wParam

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 que está visível na janela de exibição de árvore. Você pode usar a macro TreeView_GetFirstVisible para enviar essa mensagem.
TVGN_LASTVISIBLE
Versão 4.71. Recupera o último item expandido na árvore. Isso não recupera o último item visível na janela de exibição de árvore. Você pode usar a macro TreeView_GetLastVisible 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.

lParam

Identificador para um item.

Valor retornado

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

Comentários

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

Você também pode usar uma destas macros relacionadas:

TreeView_GetChild
TreeView_GetDropHilight
TreeView_GetFirstVisible
TreeView_GetLastVisible
TreeView_GetNextSibling
TreeView_GetNextVisible
TreeView_GetParent
TreeView_GetPrevSibling
TreeView_GetPrevVisible
TreeView_GetRoot
TreeView_GetSelection

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