TVM _ GETNEXTITEM message

Récupère l’élément d’arborescence qui porte la relation spécifiée à un élément spécifié. Vous pouvez envoyer ce message de manière explicite, à l’aide de la macro _ GetNextItem TreeView .

Paramètres

wParam

Indicateur spécifiant l’élément à récupérer. Ce paramètre peut prendre l’une des valeurs suivantes :

Valeur Signification
_signe insertion TVGN
Récupère l’élément actuellement sélectionné. Vous pouvez utiliser la macro TreeView _ GetSelection pour envoyer ce message.
_enfant TVGN
Récupère le premier élément enfant de l’élément spécifié par le paramètre hitem . Vous pouvez utiliser la macro _ GetChild TreeView pour envoyer ce message.
TVGN _ DROPHILITE
Récupère l’élément qui est la cible d’une opération de glisser-déplacer. Vous pouvez utiliser la macro _ GetDropHilight TreeView pour envoyer ce message.
TVGN _ FIRSTVISIBLE
Récupère le premier élément qui est visible dans la fenêtre d’arborescence. Vous pouvez utiliser la macro _ GetFirstVisible TreeView pour envoyer ce message.
TVGN _ LASTVISIBLE
Version 4,71. Récupère le dernier élément développé dans l’arborescence. Cela ne récupère pas le dernier élément visible dans la fenêtre d’arborescence. Vous pouvez utiliser la macro _ GetLastVisible TreeView pour envoyer ce message.
TVGN _ suivant
Récupère l’élément frère suivant. Vous pouvez utiliser la macro _ GetNextSibling TreeView pour envoyer ce message.
TVGN _ NEXTSELECTED
Windows Vista et versions ultérieures. Récupère l'élément sélectionné suivant. Vous pouvez utiliser la macro _ GetNextSelected TreeView pour envoyer ce message.
TVGN _ NEXTVISIBLE
Récupère l’élément visible suivant qui suit l’élément spécifié. L’élément spécifié doit être visible. Utilisez le message TVM _ GETITEMRECT pour déterminer si un élément est visible. Vous pouvez utiliser la macro _ GetNextVisible TreeView pour envoyer ce message.
TVGN _ parent
Récupère le parent de l’élément spécifié. Vous pouvez utiliser la macro TreeView _ GetParent pour envoyer ce message.
TVGN _ précédent
Récupère l’élément frère précédent. Vous pouvez utiliser la macro _ GetPrevSibling TreeView pour envoyer ce message.
TVGN _ PREVIOUSVISIBLE
Récupère le premier élément visible qui précède l’élément spécifié. L’élément spécifié doit être visible. Utilisez le message TVM _ GETITEMRECT pour déterminer si un élément est visible. Vous pouvez utiliser la macro _ GetPrevVisible TreeView pour envoyer ce message.
_racine TVGN
Récupère le premier ou le dernier élément du contrôle Tree-View. Vous pouvez utiliser la macro _ GetRoot TreeView pour envoyer ce message.

lParam

Handle vers un élément.

Valeur de retour

Retourne le handle de l’élément en cas de réussite. Dans la plupart des cas, le message retourne une valeur null pour indiquer une erreur. Pour plus d'informations, consultez la section Notes.

Notes

Ce message retourne la valeur null si l’élément récupéré est le nœud racine de l’arborescence. Par exemple, si vous utilisez ce message avec l' _ indicateur parent TVGN sur un enfant de premier niveau du nœud racine de la vue d’arborescence, le message retourne la valeur null.

Vous pouvez également utiliser l’une des macros associées suivantes :

_GetChild TreeView
_GetDropHilight TreeView
_GetFirstVisible TreeView
_GetLastVisible TreeView
_GetNextSibling TreeView
_GetNextVisible TreeView
TreeView _ GetParent
_GetPrevSibling TreeView
_GetPrevVisible TreeView
_GetRoot TreeView
_GetSelection TreeView

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau Vista uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
En-tête
Commctrl. h