macro TreeView_GetNextItem (commctrl.h)

Articolo
10/24/2024

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

Sintassi

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

Parametri

hwnd

Tipo: HWND

Handle per il controllo visualizzazione albero.

hitem

Tipo: HTREEITEM

Handle per un elemento.

code

Tipo: UINT

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 il 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 di 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. È possibile utilizzare la macro TreeView_GetFirstVisible per inviare questo messaggio.
TVGN_NEXT	Recupera l'elemento di pari livello successivo. È possibile utilizzare la macro TreeView_GetNextSibling per inviare il messaggio.
TVGN_NEXTSELECTED	Windows Vista e versioni successive. Recupera l'elemento selezionato successivo. È 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. Utilizzare 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 il messaggio.
TVGN_PREVIOUSVISIBLE	Recupera il primo elemento visibile che precede l'elemento specificato. L'elemento specificato deve essere visibile. Utilizzare il messaggio TVM_GETITEMRECT per determinare se un elemento è visibile. È possibile utilizzare la macro TreeView_GetPrevVisible per inviare il messaggio.
TVGN_ROOT	Recupera l'elemento più in alto o molto primo del controllo visualizzazione albero. È possibile utilizzare la macro TreeView_GetRoot per inviare il messaggio.

Valore restituito

Tipo: HTREEITEM

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. Per informazioni dettagliate, vedere la sezione Osservazioni.

Osservazioni

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

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	commctrl.h

Condividi tramite