TreeView_Select macro (commctrl.h)

Article
08/22/2023

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 les macros TreeView_SelectItem, TreeView_SelectSetFirstVisible ou TreeView_SelectDropTarget , ou vous pouvez envoyer le message TVM_SELECTITEM explicitement.

Syntaxe

void TreeView_Select(
   hwnd,
   hitem,
   code
);

Paramètres

hwnd

Type : HWND

Gérez le contrôle d’arborescence.

hitem

Type : HTREEITEM

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

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	Garantit 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 possible 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, selon le nombre d’éléments dans la fenêtre.

Valeur de retour

None

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 .

Configuration requise


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

Partager via