TVM_SELECTITEM message

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 envoyer ce message explicitement ou à l’aide de la macro TreeView_Select, TreeView_SelectItem ou TreeView_SelectDropTarget .

Paramètres

wParam

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 spécifié. La fenêtre parente du contrôle d’arborescence reçoit les codes de notification TVN_SELCHANGING et TVN_SELCHANGED .
TVGN_DROPHILITE	Redessine l’élément spécifié 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.
TVSI_NOSINGLEEXPAND	Lorsqu’un seul élément est sélectionné, garantit que l’arborescence ne développe pas les enfants de cet élément. Cette valeur est valide uniquement si elle est utilisée avec l’indicateur TVGN_CARET. Note: Pour utiliser cet indicateur, vous devez fournir un manifeste spécifiant Comclt32.dll version 6.0. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.

lParam

Handle vers un élément. Si lParam a la valeur NULL, le contrôle est défini pour n’avoir aucun élément sélectionné.

Valeur retournée

Retourne TRUE en cas de réussite, ou FALSE dans le cas contraire.

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 du contrôle reçoit les codes de notification TVN_ITEMEXPANDING et TVN_ITEMEXPANDED .

L’utilisation de la macro TreeView_SelectItem revient à envoyer le message TVM_SELECTITEM avec wParam défini sur la valeur TVGN_CARET. L’utilisation de la macro TreeView_SelectDropTarget revient à envoyer le message TVM_SELECTITEM avec wParam défini sur la valeur TVGN_DROPHILITE. L’utilisation de TreeView_SelectSetFirstVisible équivaut à envoyer le message TVM_SELECTITEM avec wParam 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]
En-tête	Commctrl.h