macro TreeView_Select (commctrl.h)

  • Article

Sélectionne l’élément d’arborescence spécifié, fait défiler l’élément dans l’affichage ou redessine l’élément dans le style utilisé pour indiquer la cible d’une opération de glisser-déplacer. Vous pouvez utiliser cette macro ou le TreeView_SelectItem, TreeView_SelectSetFirstVisibleou TreeView_SelectDropTarget macros, ou envoyer explicitement le message TVM_SELECTITEM.

Syntaxe

BOOL TreeView_Select(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

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é.

code

Type : UINT

Indicateur d’action. Ce paramètre peut être l’une des valeurs suivantes :

Valeur Signification
TVGN_CARET
 Définit la sélection sur l’élément donné. La fenêtre parente du contrôle reçoit les codes de notification TVN_SELCHANGING et TVN_SELCHANGED.
TVGN_DROPHILITE
 Redessine l’élément donné dans le style utilisé pour indiquer la cible d’une opération de glisser-déplacer.
TVGN_FIRSTVISIBLE
 Vérifie que l’élément spécifié est visible et, si possible, l’affiche en haut de la fenêtre du contrôle. 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.

Valeur de retour

Type : BOOL

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

Remarques

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.

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