macro TreeView_SelectSetFirstVisible (commctrl.h)

Fait défiler le contrôle d’arborescence verticalement pour vous assurer que l’élément spécifié est visible. Si possible, l’élément spécifié devient le premier élément visible en haut de la fenêtre du contrôle. Vous pouvez utiliser cette macro ou la macro TreeView_Select, ou envoyer explicitement le message TVM_SELECTITEM.

Syntaxe

BOOL TreeView_SelectSetFirstVisible(
   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

Les contrôles d’arborescence affichent autant d’éléments que dans la fenêtre. Si l’élément spécifié se trouve près du bas de la hiérarchie des éléments du contrôle, il peut ne pas devenir le premier élément visible, en fonction du nombre d’éléments qui s’adaptent à la fenêtre.

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_SelectSetFirstVisible équivaut à envoyer le message TVM_SELECTITEM avec son indicateur de paramètre défini sur la valeur TVGN_FIRSTVISIBLE.

Exigences