Partager via


Élément VisibilityItem

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

Une fois le VSPackage chargé, Visual Studio s'attend à ce que la visibilité de commande soit déterminé par le VSPackage plutôt qu' VisibilityItem. pour déterminer la visibilité de votre commande, vous pouvez appliquer le gestionnaire d'événements d' BeforeQueryStatus ou la méthode d' QueryStatus , selon la façon dont vous avez implémenté votre commande.

Une commande ou un menu qui ont un élément d' VisibilityItem apparaît uniquement lorsque le contexte associé est actif. Vous pouvez associer une commande unique, un menu, une barre d'outils avec un ou plusieurs contextes de la commande interface utilisateur en incluant une entrée pour chaque combinaison de commande-contexte. Si une commande ou menu est associée à plusieurs contextes de la commande interface utilisateur, la commande de menu est visible lorsque de les contextes associés de la commande interface utilisateur sont actives.

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

<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. Le GUID de l'identificateur de commande de GUID/ID.

id

Obligatoire. L'ID de l'identificateur de commande de GUID/ID.

contexte

Obligatoire. le contexte d'interface utilisateur dans lequel la commande est visible.

Condition

Facultatif. Consultez Attributs conditionnels de schéma XML VSCT.

Éléments enfants

Aucun

Éléments parents

Élément

Description

VisibilityConstraints, élément

l'élément d' VisibilityConstraints détermine la visibilité statique des groupes de commandes et de barres d'outils.

Notes

Les contextes standard d'interface utilisateur de Visual Studio sont définis dans le fichier de Chemin d'installation du kit de développement Visual Studio\VisualStudioIntegration\Common\Inc \ vsshlids.h ainsi que dans les classes d' UIContextGuids et d' UIContextGuids80 . Un jeu plus complet des contextes d'interface utilisateur est défini dans la classe d' VSConstants .

Exemple

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

Voir aussi

Référence

VisibilityConstraints, élément

IsCmdUIContextActive

BeforeQueryStatus

VSConstants

UIContextGuids

UIContextGuids80

Autres ressources

Tableau de commande Visual Studio (. fichiers de Vsct)