Partager via


styles étendus de contrôle Tree-View

Cette section répertorie les styles étendus utilisés lors de la création de contrôles d’arborescence. La valeur des styles étendus est une combinaison au niveau du bit de ces styles.

Constant Description
TVS_EX_AUTOHSCROLL
Windows Vista. Supprimez la barre de défilement horizontale et faites défiler automatiquement en fonction de la position de la souris.
TVS_EX_DIMMEDCHECKBOXES
Windows Vista. Ajoute une case à cocher sur le côté gauche d’un élément donné qui contient une icône d’une marque de case activée grisée, qui peut indiquer qu’un nœud est sélectionné parce que son parent est sélectionné. Cela inclut un état de case à cocher grisé en plus de 2 états de case à cocher normaux. Ne l’utilisez pas en même temps que le style TVS_CHECKBOXES . Voir la remarque ci-dessous.
TVS_EX_DOUBLEBUFFER
Windows Vista. Spécifie comment l’arrière-plan est effacé ou rempli.
TVS_EX_DRAWIMAGEASYNC
Windows Vista. Récupère les informations de grille de calendrier.
TVS_EX_EXCLUSIONCHECKBOXES
Windows Vista. Ajoute une icône de case à cocher sur le côté gauche d’un élément donné qui contient un X rouge. Cela inclut un état de case à cocher d’exclusion en plus de 2 états de case à cocher normaux. Ne l’utilisez pas en même temps que le style TVS_CHECKBOXES . Voir la remarque ci-dessous.
TVS_EX_FADEINOUTEXPANDOS
Windows Vista. Fondu des boutons expando vers ou vers l’extérieur lorsque la souris s’éloigne ou dans un état de pointage sur le contrôle.
TVS_EX_MULTISELECT
Non pris en charge. Ne pas utiliser.
TVS_EX_NOINDENTSTATE
Windows Vista. Ne mettez pas en retrait l’arborescence des boutons expando.
TVS_EX_NOSINGLECOLLAPSE
Windows Vista. Destiné à un usage interne ; non recommandé pour une utilisation dans les applications. Ne réduisez pas l’élément d’arborescence précédemment sélectionné, sauf s’il a le même parent que la nouvelle sélection. Ce style doit être utilisé avec le style TVS_SINGLEEXPAND .
Note: Ce style peut ne pas être pris en charge dans les versions ultérieures de Comctl32.dll. En outre, ce style n’est pas défini dans commctrl.h. Ajoutez la définition suivante aux fichiers sources de votre application pour utiliser ce style : #define TVS_EX_NOSINGLECOLLAPSE 0x0001
TVS_EX_PARTIALCHECKBOXES
Windows Vista. Ajoute une icône de case à cocher sur le côté le plus à gauche d’un élément donné avec un carré au centre, qui peut indiquer que le nœud est partiellement sélectionné. Cela inclut un état de case à cocher partiel en plus de 2 états de case à cocher normaux. Ne l’utilisez pas en même temps que le style TVS_CHECKBOXES . Voir la remarque ci-dessous.
TVS_EX_RICHTOOLTIP
Windows Vista. Autorisez les info-bulles enrichies dans l’arborescence (dessin personnalisé avec une icône et du texte).

Remarque sur l’utilisation des styles de case à cocher étendus

Le contrôle arborescence a un comportement très spécifique pour les styles de case à cocher. Lorsqu’un style spécifique ou une combinaison de style « EX » est activé, le contrôle le conserve jusqu’à la fin de sa vie (ce qui signifie que vous ne pouvez pas modifier le style de la première case à cocher pendant la durée de vie du contrôle d’arborescence).

Pour créer un contrôle d’arborescence avec des styles de case à cocher étendus, vous devez initialement créer la fenêtre de contrôle sans le style TVS_CHECKBOXES et ajouter (après la création) le style de case à cocher étendu choisi en envoyant le message TVM_SETEXTENDEDSTYLE ou en utilisant la macro TreeView_SetExtendedStyle . Le style de case à cocher étendu peut être n’importe quelle combinaison DE TVS_EX_DIMMEDCHECKBOXES, TVS_EX_EXCLUSIONCHECKBOXES ou TVS_EX_PARTIALCHECKBOXES style.

Le nouveau contrôle d’arborescence fournit les 2 états de case à cocher normaux (activés et décochés) plus 1 à 3 états supplémentaires (fonction du style étendu choisi). Les états normaux sont toujours codés comme 0x1000 et 0x2000, et tous les états supplémentaires sont codés avec les valeurs suivantes (0x3000, 0x4000, 0x5000). Utilisez TVIS_STATEIMAGEMASK constante (0xF000) comme masque pour obtenir ou définir ces états sur/à partir de la structure TVITEM .

Configuration requise

Condition requise Valeur
En-tête
CommCtrl.h