macro TreeView_GetNextItem (commctrl.h)

Recupera l'elemento della visualizzazione albero che include la relazione specificata a un elemento specificato. È possibile usare questa macro, usare una delle macro TreeView_Get descritte di seguito o inviare in modo esplicito il messaggio TVM_GETNEXTITEM .

Sintassi

void TreeView_GetNextItem(
   hwnd,
   hitem,
   code
);

Parametri

hwnd

Tipo: HWND

Gestire il controllo visualizzazione albero.

hitem

Tipo: HTREEITEM

Gestire in un elemento.

code

Tipo: UINT

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

Valore	Significato
TVGN_CARET	Recupera l'elemento attualmente selezionato. È possibile usare la macro TreeView_GetSelection per inviare questo messaggio.
TVGN_CHILD	Recupera il primo elemento figlio dell'elemento specificato dal parametro hitem . È possibile usare la macro TreeView_GetChild per inviare questo messaggio.
TVGN_DROPHILITE	Recupera l'elemento di destinazione di un'operazione di trascinamento della selezione. È possibile usare la macro TreeView_GetDropHilight per inviare questo messaggio.
TVGN_FIRSTVISIBLE	Recupera il primo elemento visibile. È possibile usare la macro TreeView_GetFirstVisible per inviare questo messaggio.
TVGN_NEXT	Recupera l'elemento di pari livello successivo. È possibile usare la macro TreeView_GetNextSibling per inviare questo messaggio.
TVGN_NEXTSELECTED	Windows Vista e versioni successive. Recupera il successivo elemento selezionato. È possibile usare 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 usare la macro TreeView_GetNextVisible per inviare questo messaggio.
TVGN_PARENT	Recupera l'elemento padre dell'elemento specificato. È possibile usare la macro TreeView_GetParent per inviare questo messaggio.
TVGN_PREVIOUS	Recupera l'elemento di pari livello precedente. È possibile usare 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 usare la macro TreeView_GetPrevVisible per inviare questo messaggio.
TVGN_ROOT	Recupera l'elemento superiore o molto primo del controllo visualizzazione albero. È possibile usare la macro TreeView_GetRoot per inviare questo messaggio.

Valore restituito

nessuno

Osservazioni

Questa macro restituirà NULL se l'elemento recuperato è il nodo radice dell'albero. Ad esempio, se si usa questa macro con il flag TVGN_PARENT in un elemento figlio di primo livello del nodo radice della visualizzazione albero, la macro restituirà NULL.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commctrl.h