Élément de VisibilityItemVisibilityItem Element

Le VisibilityItem élément détermine la visibilité statique des commandes et des barres d’outils.The VisibilityItem element determines the static visibility of commands and toolbars. Chaque entrée identifie une commande ou un menu et également un contexte de l’interface utilisateur de commande associée.Every entry identifies a command or menu, and also an associated command UI context. Visual Studio détecte les commandes, menus et barres d’outils et leur visibilité, sans charger les VSPackages qui les définissent.Visual Studio detects commands, menus, and toolbars, and their visibility, without loading the VSPackages that define them. L’IDE utilise le IsCmdUIContextActive méthode pour déterminer si un contexte de l’interface utilisateur de commande est actif.The IDE uses the IsCmdUIContextActive method to determine whether a command UI context is active.

Une fois le VSPackage est chargé, Visual Studio attend la visibilité de commande est déterminée par le VSPackage plutôt que VisibilityItem.After the VSPackage is loaded, Visual Studio expects command visibility to be determined by the VSPackage rather than the VisibilityItem. Pour déterminer la visibilité de votre commande, vous pouvez implémenter soit le BeforeQueryStatus Gestionnaire d’événements ou la QueryStatus (méthode), selon la façon dont vous avez implémenté votre commande.To determine your command's visibility, you can implement either the BeforeQueryStatus event handler or the QueryStatus method, depending on how you have implemented your command.

Une commande ou un menu qui a un VisibilityItem élément apparaît uniquement lorsque le contexte associé est actif.A command or menu that has a VisibilityItem element appears only when the associated context is active. Vous pouvez associer une commande unique, un menu ou une barre d’outils avec un ou plusieurs contextes d’interface utilisateur de commande en incluant une entrée pour chaque combinaison de contexte de la commande.You can associate a single command, menu, or toolbar with one or more command UI contexts by including an entry for each command-context combination. Si une commande ou un menu est associé à plusieurs contextes d’interface utilisateur de commande, puis la commande ou un menu est visible lorsque l’un des contextes d’interface utilisateur de la commande associée est actif.If a command or menu is associated with multiple command UI contexts, then the command or menu is visible when any one of the associated command UI contexts is active.

Le VisibilityItem élément s’applique uniquement aux commandes, menus et barres d’outils, pas aux groupes.The VisibilityItem element applies only to commands, menus, and toolbars, not to groups. Un élément qui n’a pas un VisibilityItem élément est visible lorsque son menu parent est actif.An element that does not have a related VisibilityItem element is visible whenever its parent menu is active.

SyntaxeSyntax

<VisibilityItem  
  guid ="="cmdGuidMyProductCommands"  
  id=="cmdidAddWidget"  
  context="guidNotViewSourceMode"/>  

Attributs et élémentsAttributes and Elements

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.The following sections describe attributes, child elements, and parent elements.

AttributsAttributes

AttributAttribute DescriptionDescription
GUIDguid Obligatoire.Required. Le GUID de l’identificateur de commande/ID GUID.The GUID of the GUID/ID command identifier.
IDid Obligatoire.Required. ID de l’identificateur de commande/ID GUID.The ID of the GUID/ID command identifier.
contextecontext Obligatoire.Required. Le contexte de l’interface utilisateur dans laquelle la commande est visible.The UI context in which the command is visible.
ConditionCondition Facultatif.Optional. Consultez attributs conditionnels.See Conditional Attributes.

Éléments enfantsChild Elements

AucunNone

Éléments parentsParent Elements

ÉlémentElement DescriptionDescription
Élément VisibilityConstraintsVisibilityConstraints Element Le VisibilityConstraints élément détermine la visibilité statique de groupes de commandes et des barres d’outils.The VisibilityConstraints element determines the static visibility of groups of commands and toolbars.

NotesRemarks

Les contextes d’interface utilisateur Visual Studio standards sont définis dans le chemin d’installation de Visual Studio SDK\VisualStudioIntegration\Common\Inc\vsshlids.h fichier ainsi que dans les UIContextGuids et UIContextGuids80 classes.The standard Visual Studio UI contexts are defined in the Visual Studio SDK installation path\VisualStudioIntegration\Common\Inc\vsshlids.h file as well as in the UIContextGuids and UIContextGuids80 classes. Un ensemble plus complet de contextes d’interface utilisateur est défini dans la VSConstants classe.A more complete set of UI contexts is defined in the VSConstants class.

ExempleExample

<VisibilityConstraints>  
  <VisibilityItem guid="cmdSetGuidMyProductCommands"     id="cmdidAddWidget"  
    context="guidNotViewSourceMode"/>  
</VisibilityConstraints>  

Voir aussiSee Also

IsCmdUIContextActive
BeforeQueryStatus
VSConstants
UIContextGuids
UIContextGuids80
Élément de VisibilityConstraints VisibilityConstraints Element
Fichiers Visual Studio Command Table (.Vsct)Visual Studio Command Table (.Vsct) Files