macro TreeView_SelectItem (commctrl.h)

Article
10/24/2024

Sélectionne l’élément d’arborescence spécifié. Vous pouvez utiliser cette macro ou la macro TreeView_Select, ou envoyer explicitement le message TVM_SELECTITEM.

Syntaxe

BOOL TreeView_SelectItem(
   HWND      hwnd,
   HTREEITEM hitem
);

Paramètres

hwnd

Type : HWND

Gérez le contrôle d’arborescence.

hitem

Type : HTREEITEM

Gérer un élément. Si le paramètre hitem est NULL, le contrôle n’a pas d’élément sélectionné.

Valeur de retour

Type : BOOL

Retourne TRUE en cas de réussite ou FALSE sinon.

Remarques

Lorsque vous appelez la macro TreeView_SelectItem, la fenêtre parente du contrôle reçoit les codes de notification TVN_SELCHANGING et TVN_SELCHANGED. En outre, si l’élément spécifié est l’enfant d’un élément parent réduit, la liste des éléments enfants du parent est développée pour révéler l’élément spécifié. Dans ce cas, la fenêtre parente reçoit les codes de notification TVN_ITEMEXPANDING et TVN_ITEMEXPANDED.

L’utilisation de la macro TreeView_SelectItem équivaut à envoyer le message TVM_SELECTITEM avec son indicateur de paramètre défini sur la valeur TVGN_CARET.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	commctrl.h

Partager via