messaggio TVM_GETNEXTITEM

Recupera l'elemento della visualizzazione albero che include la relazione specificata con un elemento specificato. È possibile inviare questo messaggio in modo esplicito utilizzando la macro TreeView_GetNextItem .

Parametri

wParam

Flag che specifica l'elemento da recuperare. Questo parametro può essere uno dei valori seguenti:

Valore	Significato
TVGN_CARET	Recupera l'elemento attualmente selezionato. È possibile utilizzare la macro TreeView_GetSelection per inviare questo messaggio.
TVGN_CHILD	Recupera il primo elemento figlio dell'elemento specificato dal parametro hitem . È possibile utilizzare la macro TreeView_GetChild per inviare questo messaggio.
TVGN_DROPHILITE	Recupera l'elemento che rappresenta la destinazione di un'operazione di trascinamento della selezione. È possibile utilizzare la macro TreeView_GetDropHilight per inviare questo messaggio.
TVGN_FIRSTVISIBLE	Recupera il primo elemento visibile nella finestra della visualizzazione albero. È possibile utilizzare la macro TreeView_GetFirstVisible per inviare questo messaggio.
TVGN_LASTVISIBLE	Versione 4.71. Recupera l'ultimo elemento espanso nell'albero. Questo non recupera l'ultimo elemento visibile nella finestra di visualizzazione albero. È possibile utilizzare la macro TreeView_GetLastVisible per inviare questo messaggio.
TVGN_NEXT	Recupera l'elemento di pari livello successivo. È possibile utilizzare la macro TreeView_GetNextSibling per inviare questo messaggio.
TVGN_NEXTSELECTED	Windows Vista e versioni successive. Recupera il successivo elemento selezionato. È possibile utilizzare la macro TreeView_GetNextSelected per inviare questo messaggio.
TVGN_NEXTVISIBLE	Recupera l'elemento visibile successivo che segue l'elemento specificato. L'elemento specificato deve essere visibile. Usare il messaggio TVM_GETITEMRECT per determinare se un elemento è visibile. È possibile utilizzare la macro TreeView_GetNextVisible per inviare questo messaggio.
TVGN_PARENT	Recupera l'elemento padre dell'elemento specificato. È possibile utilizzare la macro TreeView_GetParent per inviare questo messaggio.
TVGN_PREVIOUS	Recupera l'elemento di pari livello precedente. È possibile utilizzare la macro TreeView_GetPrevSibling per inviare questo messaggio.
TVGN_PREVIOUSVISIBLE	Recupera il primo elemento visibile che precede l'elemento specificato. L'elemento specificato deve essere visibile. Usare il messaggio TVM_GETITEMRECT per determinare se un elemento è visibile. È possibile utilizzare la macro TreeView_GetPrevVisible per inviare questo messaggio.
TVGN_ROOT	Recupera l'elemento più in alto o molto primo del controllo di visualizzazione albero. È possibile utilizzare la macro TreeView_GetRoot per inviare questo messaggio.

lParam

Handle per un elemento.

Valore restituito

Restituisce l'handle all'elemento in caso di esito positivo. Per la maggior parte dei casi, il messaggio restituisce un valore NULL per indicare un errore. Vedere la sezione Osservazioni per informazioni dettagliate.

Commenti

Questo messaggio restituirà NULL se l'elemento recuperato è il nodo radice dell'albero. Ad esempio, se si usa questo messaggio con il flag TVGN_PARENT su un elemento figlio di primo livello del nodo radice della visualizzazione albero, il messaggio restituirà NULL.

È anche possibile usare una di queste macro correlate:

TreeView_GetChild
TreeView_GetDropHilight
TreeView_GetFirstVisible
TreeView_GetLastVisible
TreeView_GetNextSibling
TreeView_GetNextVisible
TreeView_GetParent
TreeView_GetPrevSibling
TreeView_GetPrevVisible
TreeView_GetRoot
TreeView_GetSelection

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Commctrl.h