Share via

TVM_GETNEXTITEM message

  • Article

Récupère l’élément d’arborescence qui porte la relation spécifiée avec un élément spécifié. Vous pouvez envoyer ce message explicitement à l’aide de la macro TreeView_GetNextItem .

Paramètres

wParam

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

Valeur Signification
TVGN_CARET
 Récupère l’élément actuellement sélectionné. Vous pouvez utiliser la macro TreeView_GetSelection pour envoyer ce message.
TVGN_CHILD
 Récupère le premier élément enfant de l’élément spécifié par le paramètre hitem . Vous pouvez utiliser la macro TreeView_GetChild 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 TreeView_GetDropHilight pour envoyer ce message.
TVGN_FIRSTVISIBLE
 Récupère le premier élément visible dans la fenêtre d’arborescence. Vous pouvez utiliser la macro TreeView_GetFirstVisible 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 TreeView_GetLastVisible pour envoyer ce message.
TVGN_NEXT
 Récupère l’élément frère suivant. Vous pouvez utiliser la macro TreeView_GetNextSibling 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 TreeView_GetNextSelected pour envoyer ce message.
TVGN_NEXTVISIBLE
 Récupère l’élément visible suivant 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 TreeView_GetNextVisible 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_PREVIOUS
 Récupère l’élément frère précédent. Vous pouvez utiliser la macro TreeView_GetPrevSibling 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 TreeView_GetPrevVisible pour envoyer ce message.
TVGN_ROOT
 Récupère l’élément le plus haut ou le tout premier du contrôle d’arborescence. Vous pouvez utiliser la macro TreeView_GetRoot pour envoyer ce message.

lParam

Handle vers un élément.

Valeur retournée

Retourne le handle à 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 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 TVGN_PARENT sur un enfant de premier niveau du nœud racine de l’arborescence, le message retourne NULL.

Vous pouvez également utiliser l’une de ces macros associées :
TreeView_GetChild
TreeView_GetDropHilight
TreeView_GetFirstVisible
TreeView_GetLastVisible
TreeView_GetNextSibling
TreeView_GetNextVisible
TreeView_GetParent
TreeView_GetPrevSibling
TreeView_GetPrevVisible
TreeView_GetRoot
TreeView_GetSelection

Spécifications

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