macro TreeView_SelectSetFirstVisible (commctrl.h)

Fait défiler le contrôle arborescence verticalement pour s’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 vous pouvez envoyer le message TVM_SELECTITEM explicitement.

Syntaxe

void TreeView_SelectSetFirstVisible(
   hwnd,
   hitem
);

Paramètres

hwnd

Type : HWND

Gérez le contrôle arborescence.

hitem

Type : HTREEITEM

Gérez un élément. Si le paramètre hitem a la valeur NULL, le contrôle est défini pour n’avoir aucun élément sélectionné.

Valeur de retour

None

Remarques

Les contrôles d’arborescence affichent autant d’éléments qu’ils le devront dans la fenêtre. Si l’élément spécifié se trouve près du bas de la hiérarchie d’éléments du contrôle, il peut ne pas devenir le premier élément visible, en fonction du nombre d’éléments qui entrent dans 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 paramètre d’indicateur défini sur la valeur TVGN_FIRSTVISIBLE.

Configuration requise

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]
Plateforme cible	Windows
En-tête	commctrl.h