Élément VisibilityItem

Article
01/13/2024

L’élément VisibilityItem détermine la visibilité statique des commandes et des barres d’outils. Chaque entrée identifie une commande ou un menu, ainsi qu’un contexte d’interface utilisateur de commande associé. Visual Studio détecte les commandes, les menus et les barres d’outils, ainsi que leur visibilité, sans charger les VSPackages qui les définissent. L’IDE utilise la IsCmdUIContextActive méthode pour déterminer si un contexte d’interface utilisateur de commande est actif.

Une fois le VSPackage chargé, Visual Studio s’attend à ce que la visibilité des commandes soit déterminée par VSPackage plutôt que par le VisibilityItemfichier . Pour déterminer la visibilité de votre commande, vous pouvez implémenter le BeforeQueryStatus gestionnaire d’événements ou la méthode, selon la QueryStatus façon dont vous avez implémenté votre commande.

Une commande ou un menu qui a un VisibilityItem élément s’affiche uniquement lorsque le contexte associé est actif. Vous pouvez associer une seule commande, un menu ou une barre d’outils à un ou plusieurs contextes d’interface utilisateur de commande en incluant une entrée pour chaque combinaison de contexte de commande. Si une commande ou un menu est associé à plusieurs contextes d’interface utilisateur de commande, la commande ou le menu est visible lorsqu’un des contextes de l’interface utilisateur de commande associé est actif.

L’élément VisibilityItem s’applique uniquement aux commandes, menus et barres d’outils, et non aux groupes. Un élément qui n’a pas d’élément associé VisibilityItem est visible chaque fois que son menu parent est actif.

Syntaxe

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
guid	Obligatoire. GUID de l’identificateur de commande GUID/ID.
id	Obligatoire. ID de l’identificateur de commande GUID/ID.
contexte	Obligatoire. Contexte d’interface utilisateur dans lequel la commande est visible.
Condition	facultatif. Consultez les attributs conditionnels.

Éléments enfants

Aucun

Éléments parents

Élément	Description
Élément VisibilityConstraints	L’élément `VisibilityConstraints` détermine la visibilité statique des groupes de commandes et de barres d’outils.

Notes

Les contextes d’interface utilisateur Visual Studio standard sont définis dans le chemin d’installation du Kit de développement logiciel (SDK) Visual Studio\VisualStudioIntegration\Common\Inc\vsshlids.h, ainsi que dans les UIContextGuids classes et UIContextGuids80 les classes. Un ensemble plus complet de contextes d’interface utilisateur est défini dans la VSConstants classe.

Exemple

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

Partager via