macro TreeView_SetCheckState (commctrl.h)

Article
10/24/2024

Définit l’image d’état de l’élément sur « coché » ou « décochée ». Vous pouvez également utiliser directement le message TVM_SETITEM.

Syntaxe

UINT TreeView_SetCheckState(
   HWND      hwndTV,
   HTREEITEM hti,
   BOOL      fCheck
);

Paramètres

hwndTV

Type : HWND

Gérez le contrôle d’arborescence.

hti

Type : HTREEITEM

Gérer l’élément.

fCheck

Type : BOOL

Valeur qui indique l’image d’état affichée. Définissez fCheck sur TRUE pour afficher l’image d’état vérifiée ou FALSE pour afficher l’image non cochée.

Valeur de retour

Type : UINT

La valeur de retour n’est pas utilisée.

Remarques

Un contrôle d’arborescence peut avoir deux listes d’images. La liste d’images normale stocke les images sélectionnées, non sélectionnées et superposées. Les cases à cocher sont stockées dans la liste d’images d’état et affichées à gauche de l’image normale correspondante. Les images d’état sont spécifiées par un index à base unique. Un index de zéro indique qu’il n’y a pas d’image d’état. Consultez Tree-View listes d’images pour une discussion sur la façon de gérer les images d’arborescence.

Si vous souhaitez définir vos propres images d’état, cette macro part du principe que les images vérifiées et décochées ont les mêmes index que la liste d’images standard : 1 pour les images désactivées et 2 pour vérifiées.

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

Partager via