énumération _NSTCSTYLE (shobjidl_core.h)

Décrit les caractéristiques d’un contrôle d’arborescence d’espaces de noms donné.

Syntax

typedef enum _NSTCSTYLE {
  NSTCS_HASEXPANDOS = 0x1,
  NSTCS_HASLINES = 0x2,
  NSTCS_SINGLECLICKEXPAND = 0x4,
  NSTCS_FULLROWSELECT = 0x8,
  NSTCS_SPRINGEXPAND = 0x10,
  NSTCS_HORIZONTALSCROLL = 0x20,
  NSTCS_ROOTHASEXPANDO = 0x40,
  NSTCS_SHOWSELECTIONALWAYS = 0x80,
  NSTCS_NOINFOTIP = 0x200,
  NSTCS_EVENHEIGHT = 0x400,
  NSTCS_NOREPLACEOPEN = 0x800,
  NSTCS_DISABLEDRAGDROP = 0x1000,
  NSTCS_NOORDERSTREAM = 0x2000,
  NSTCS_RICHTOOLTIP = 0x4000,
  NSTCS_BORDER = 0x8000,
  NSTCS_NOEDITLABELS = 0x10000,
  NSTCS_TABSTOP = 0x20000,
  NSTCS_FAVORITESMODE = 0x80000,
  NSTCS_AUTOHSCROLL = 0x100000,
  NSTCS_FADEINOUTEXPANDOS = 0x200000,
  NSTCS_EMPTYTEXT = 0x400000,
  NSTCS_CHECKBOXES = 0x800000,
  NSTCS_PARTIALCHECKBOXES = 0x1000000,
  NSTCS_EXCLUSIONCHECKBOXES = 0x2000000,
  NSTCS_DIMMEDCHECKBOXES = 0x4000000,
  NSTCS_NOINDENTCHECKS = 0x8000000,
  NSTCS_ALLOWJUNCTIONS = 0x10000000,
  NSTCS_SHOWTABSBUTTON = 0x20000000,
  NSTCS_SHOWDELETEBUTTON = 0x40000000,
  NSTCS_SHOWREFRESHBUTTON
} ;

Constantes

NSTCS_HASEXPANDOS Valeur : 0x1 Le contrôle affiche un triangle, appelé expando, sur le bord le plus à gauche des éléments qui ont des éléments enfants. Cliquer sur l’élément expando développe l’élément pour afficher les enfants de l’élément. N’a aucun effet lorsqu’il est combiné avec NSTCS_SHOWTABSBUTTON, NSTCS_SHOWDELETEBUTTON ou NSTCS_SHOWREFRESHBUTTON. Mappe au style de contrôle d’arborescence TVS_HASBUTTONS .
NSTCS_HASLINES Valeur : 0x2 Le contrôle dessine des lignes à gauche des éléments d’arborescence qui mènent à leurs éléments parent individuels. N’a aucun effet lorsqu’il est combiné avec NSTCS_SHOWTABSBUTTON, NSTCS_SHOWDELETEBUTTON ou NSTCS_SHOWREFRESHBUTTON. Mappe au style de contrôle d’arborescence TVS_HASLINES .
NSTCS_SINGLECLICKEXPAND Valeur : 0x4 Un élément se développe pour afficher ses éléments enfants en réponse à un simple clic de souris. Mappe au style de contrôle d’arborescence TVS_SINGLEEXPAND .
NSTCS_FULLROWSELECT Valeur : 0x8 La sélection d’un élément remplit la ligne avec du texte inverse à la fin de la zone de fenêtre, quelle que soit la longueur du texte. Lorsque cette option n’est pas déclarée, seule la zone derrière le texte est inversée. Cette valeur ne peut pas être combinée avec NSTCS_HASLINES. Mappe au style de contrôle d’arborescence TVS_FULLROWSELECT .
NSTCS_SPRINGEXPAND Valeur : 0x10 Lorsqu’un élément est sélectionné et développé et que vous sélectionnez un deuxième élément, la première sélection se réduit automatiquement. Il s’agit de l’inverse du style de contrôle de l’arborescence TVS_EX_NOSINGLECOLLAPSE .
NSTCS_HORIZONTALSCROLL Valeur : 0x20 La zone de la fenêtre qui contient l’arborescence des éléments d’espace de noms a une barre de défilement horizontale. Mappe au style Windows WS_HSCROLL .
NSTCS_ROOTHASEXPANDO Valeur : 0x40 L’élément racine est précédé d’un expando qui permet l’expansion de l’élément racine. Mappe au style de contrôle d’arborescence TVS_LINESATROOT .
NSTCS_SHOWSELECTIONALWAYS Valeur : 0x80 Le nœud d’un élément est décrit lorsque le contrôle n’a pas le focus. Mappe au style de contrôle d’arborescence TVS_SHOWSELALWAYS .
NSTCS_NOINFOTIP Valeur : 0x200 N’affichez pas d’info-bulles lorsque le curseur de la souris se trouve sur un élément. Il s’agit de l’inverse du style de contrôle TVS_INFOTIP arborescence.
NSTCS_EVENHEIGHT Valeur : 0x400 Définit la hauteur des éléments sur une hauteur égale. Par défaut, la hauteur des éléments peut être égale ou impaire. Il s’agit de l’inverse du style de contrôle de l’arborescence TVS_NONEVENHEIGHT .
NSTCS_NOREPLACEOPEN Valeur : 0x800 Ne remplacez pas la commande Ouvrir dans le menu contextuel par une fonction définie par l’utilisateur.
NSTCS_DISABLEDRAGDROP Valeur : 0x1000 N’autorisez pas les opérations de glisser-déplacer dans le contrôle. Notez que vous pouvez toujours faire glisser un élément à partir de l’extérieur du contrôle et le déposer sur le contrôle. Correspond au style de contrôle d’arborescence TVS_DISABLEDRAGDROP .
NSTCS_NOORDERSTREAM Valeur : 0x2000 Ne persistez pas à réorganiser les modifications. Utilisé avec NSTCS_FAVORITESMODE. Si le mode favoris n’est pas spécifié, cet indicateur n’a aucun effet.
NSTCS_RICHTOOLTIP Valeur : 0x4000 Utilisez une info-bulle enrichie. Les info-bulles enrichies affichent l’icône de l’élément en plus du texte de l’élément. Une info-bulle standard affiche uniquement le texte de l’élément. L’arborescence affiche des info-bulles uniquement pour les éléments de l’arborescence partiellement visibles. Mappe au style de contrôle d’arborescence TVS_EX_RICHTOOLTIP . NSTCS_RICHTOOLTIP n’a aucun effet, sauf s’il est combiné avec NSTCS_NOINFOTIP et/ou NSTCS_FAVORITESMODE. Si NSTCS_NOINFOTIP n’est pas spécifié, l’arborescence affiche une info-bulle au lieu d’une info-bulle. Si NSTCS_FAVORITESMODE n’est pas spécifié, le contrôle d’arborescence de l’espace de noms définit toujours le style TVS_EX_RICHTOOLTIP .
NSTCS_BORDER Valeur : 0x8000 Dessinez une bordure mince autour du contrôle. Correspond à WS_BORDER.
NSTCS_NOEDITLABELS Valeur : 0x10000 N’autorisez pas la création d’une zone d’édition sur place, ce qui permettrait à l’utilisateur de renommer l’élément donné. Il s’agit de l’inverse du style de contrôle de l’arborescence TVS_EDITLABELS .
NSTCS_TABSTOP Valeur : 0x20000 Si le contrôle est hébergé, vous pouvez tabstop dans le contrôle. Correspond à WS_EX_CONTROLPARENT.
NSTCS_FAVORITESMODE Valeur : 0x80000 Le contrôle a l’apparence de la bande de favoris dans Windows XP.
NSTCS_AUTOHSCROLL Valeur : 0x100000 Lorsque vous pointez le pointeur de la souris sur un élément qui s’étend au-delà de la fin de la fenêtre de contrôle, le contrôle défile automatiquement horizontalement afin que l’élément apparaisse plus complètement dans la zone de fenêtre. Mappe au style de contrôle d’arborescence TVS_EX_AUTOHSCROLL .
NSTCS_FADEINOUTEXPANDOS Valeur : 0x200000 Si le contrôle n’a pas le focus et que des éléments sont précédés de expandos, ces expandos ne sont visibles que lorsque le pointeur de la souris est proche du contrôle. Mappe au style de contrôle d’arborescence TVS_EX_FADEINOUTEXPANDOS .
NSTCS_EMPTYTEXT Valeur : 0x400000 Si un élément n’a pas d’enfants et n’est pas développé, cet élément contient une ligne de texte au niveau enfant qui indique « empty ».
NSTCS_CHECKBOXES Valeur : 0x800000 Les éléments ont case activée zones sur le côté gauche. Ces zones case activée peuvent être de type partiel, d’exclusion ou grisé, qui correspondent aux indicateurs NSTCS_PARTIALCHECKBOXES, NSTCS_EXCLUSIONCHECKBOXES et NSTCS_DIMMEDCHECKBOXES. Correspond au style de contrôle d’arborescence TVS_CHECKBOXES .
NSTCS_PARTIALCHECKBOXES Valeur : 0x1000000 Ajoute une icône de case à cocher sur le côté gauche d’un élément donné avec un carré au centre, qui indique que le nœud est partiellement sélectionné. Doit être combiné avec NSTCS_CHECKBOXES. Mappe au style de contrôle d’arborescence TVS_EX_PARTIALCHECKBOXES .
NSTCS_EXCLUSIONCHECKBOXES Valeur : 0x2000000 Ajoute une icône de case à cocher sur le côté gauche d’un élément donné contenant un X rouge, ce qui indique que l’élément est exclu de la sélection actuelle. Sans cette icône d’exclusion, la sélection d’un élément parent inclut la sélection de ses éléments enfants. Doit être combiné avec NSTCS_CHECKBOXES. Mappe au style de contrôle d’arborescence TVS_EX_EXCLUSIONCHECKBOXES .
NSTCS_DIMMEDCHECKBOXES Valeur : 0x4000000 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 indique qu’un nœud est sélectionné parce que son parent est sélectionné. Doit être combiné avec NSTCS_CHECKBOXES. Mappe au style de contrôle d’arborescence TVS_EX_DIMMEDCHECKBOXES .
NSTCS_NOINDENTCHECKS Valeur : 0x8000000 Les cases à cocher se trouvent à l’extrémité gauche de la zone de fenêtre au lieu d’être mises en retrait. Correspond au style de contrôle d’arborescence TVS_EX_NOINDENTSTATE .
NSTCS_ALLOWJUNCTIONS Valeur : 0x10000000 Autoriser les jonctions. Un point de jonction, ou simplement une jonction, est une racine d’une extension d’espace de noms qui est normalement affichée par Windows Explorer en tant que dossier dans les affichages arborescence et dossier. Pour que Windows Explorer d’afficher les fichiers et sous-dossiers de votre extension, vous devez spécifier l’emplacement du dossier racine dans la hiérarchie de l’espace de noms Shell. Les jonctions existent dans le système de fichiers en tant que fichiers, mais ne sont pas traitées comme des fichiers. Par exemple, un fichier compressé avec une extension de nom de fichier .zip, qui pour le système de fichiers n’est qu’un fichier. Toutefois, si ce fichier est traité comme une jonction, il peut représenter un espace de noms entier. Cela permet au contrôle d’arborescence d’espaces de noms de traiter les fichiers compressés et les jonctions similaires comme des dossiers plutôt que comme des fichiers.
NSTCS_SHOWTABSBUTTON Valeur : 0x20000000 Affiche une flèche à droite d’un élément si l’élément est un dossier. L’action associée à la flèche est spécifique à l’implémentation. Ne peut pas être combiné avec NSTCS_SHOWDELETEBUTTON ou NSTCS_SHOWREFRESHBUTTON.
NSTCS_SHOWDELETEBUTTON Valeur : 0x40000000 Affiche un X rouge sur le côté droit d’un élément. L’action associée au X est spécifique à l’implémentation. Ne peut pas être combiné avec NSTCS_SHOWTABSBUTTON ou NSTCS_SHOWREFRESHBUTTON.
NSTCS_SHOWREFRESHBUTTON Affiche un bouton Actualiser à droite d’un élément. L’action associée au bouton est spécifique à l’implémentation. Ne peut pas être combiné avec NSTCS_SHOWTABSBUTTON ou NSTCS_SHOWDELETEBUTTON.

Remarques

Trois valeurs n’ont effet que conjointement avec NSTCS_CHECKBOXES : NSTCS_PARTIALCHECKBOXES, NSTCS_EXCLUSIONCHECKBOXES et NSTCS_DIMMEDCHECKBOXES. Les icônes associées à ces états sont insérées dans la liste d’images d’état comme suit :

Emplacement d’image	Image	Indicateurs associés
0	Vide	NSTCS_CHECKBOXES
1	Désactivé	NSTCS_CHECKBOXES
2	Activé	NSTCS_CHECKBOXES
3	Partial	NSTCS_CHECKBOXES | NSTCS_PARTIALCHECKBOXES
4	Exclusion (X rouge)	NSTCS_CHECKBOXES | NSTCS_EXCLUSIONCHECKBOXES

Configuration requise

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	shobjidl_core.h (inclure Shobjidl.h)

Voir aussi

INameSpaceTreeControl2::GetControlStyle

INameSpaceTreeControl2::SetControlStyle

INameSpaceTreeControl::Initialize