VisibilityItem-Element
Das VisibilityItem Element bestimmt die statische Sichtbarkeit von Befehlen und Symbolleisten. Jeder Eintrag identifiziert einen Befehl oder ein Menü sowie einen zugehörigen Befehlsbenutzeroberflächenkontext. Visual Studio erkennt Befehle, Menüs und Symbolleisten sowie deren Sichtbarkeit, ohne die VSPackages zu laden, die sie definieren. Die IDE verwendet die IsCmdUIContextActive Methode, um zu bestimmen, ob ein Befehlsbenutzeroberflächenkontext aktiv ist.
Nachdem das VSPackage geladen wurde, erwartet Visual Studio, dass die Befehlssichtbarkeit durch das VSPackage und nicht durch die VisibilityItem. Um die Sichtbarkeit Des Befehls zu ermitteln, können Sie entweder den BeforeQueryStatus Ereignishandler oder die QueryStatus Methode implementieren, je nachdem, wie Sie den Befehl implementiert haben.
Ein Befehl oder Menü mit einem VisibilityItem Element wird nur angezeigt, wenn der zugeordnete Kontext aktiv ist. Sie können einen einzelnen Befehl, ein Menü oder eine Symbolleiste einem oder mehreren Befehlsbenutzeroberflächenkontexten zuordnen, indem Sie einen Eintrag für jede Befehlskontextkombination einschließen. Wenn ein Befehl oder ein Menü mehreren Befehlsbenutzeroberflächenkontexten zugeordnet ist, ist der Befehl oder das Menü sichtbar, wenn einer der zugehörigen Befehlsbenutzeroberflächenkontexte aktiv ist.
Das VisibilityItem Element gilt nur für Befehle, Menüs und Symbolleisten, nicht für Gruppen. Ein Element, das nicht über ein verwandtes VisibilityItem Element verfügt, ist immer dann sichtbar, wenn das übergeordnete Menü aktiv ist.
Syntax
<VisibilityItem
guid="cmdGuidMyProductCommands"
id="cmdidAddWidget"
context="guidNotViewSourceMode"/>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
| Attribut | BESCHREIBUNG |
|---|---|
| guid | Erforderlich. Die GUID des GUID/ID-Befehlsbezeichners. |
| id | Erforderlich. Die ID des GUID/ID-Befehlsbezeichners. |
| context | Erforderlich. Der Ui-Kontext, in dem der Befehl sichtbar ist. |
| Bedingung | Optional. Siehe Bedingte Attribute. |
Untergeordnete Elemente
Keine
Übergeordnete Elemente
| Element | Beschreibung |
|---|---|
| VisibilityConstraints-Element | Das VisibilityConstraints Element bestimmt die statische Sichtbarkeit von Gruppen von Befehlen und Symbolleisten. |
Hinweise
Die standardmäßigen Visual Studio-UI-Kontexte werden im Visual Studio SDK-Installationspfad\VisualStudioIntegration\Common\Inc\vsshlids.h sowie in den UIContextGuids und UIContextGuids80 klassen definiert. Ein vollständigerer Satz von UI-Kontexten wird in der VSConstants Klasse definiert.
Beispiel
<VisibilityConstraints>
<VisibilityItem guid="cmdSetGuidMyProductCommands" id="cmdidAddWidget"
context="guidNotViewSourceMode"/>
</VisibilityConstraints>