énumération _NSTCSTYLE (shobjidl_core.h)

  • Article

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