VisibilityItem-Element
Das VisibilityItem-Element bestimmt die statische Sichtbarkeit von Befehlen und Symbolleisten. Jeder Eintrag identifiziert einen Befehl oder Menüs sowie einen zugeordneten Befehlsbenutzeroberflächen Elementkontext. Visual Studio erkennt Befehle, Menüs und Symbolleisten und ihre Sichtbarkeit, ohne das VSPackages zu laden, die sie definiert werden. Die IDE verwendet die IsCmdUIContextActive-Methode, um zu bestimmen, ob ein Befehlsbenutzeroberflächen Elementkontext aktiv ist.
Nach dem Laden von VSPackages Visual Studio handelt, erwartet sichtbarkeit Befehls anstelle von VSPackages VisibilityItembestimmt werden soll. Um die Sichtbarkeit des Befehls zu bestimmen, können Sie entweder den BeforeQueryStatus-Ereignishandler implementieren oder die QueryStatus-Methode, je nachdem, wie Sie den Befehl implementiert haben.
Ein Befehl oder ein Menü mit einem VisibilityItem-Element verfügt, wird nur angezeigt, wenn der zugeordnete Kontext aktiv ist. Sie können einen einzelnen Befehl, ein Menü oder einer Symbolleiste mit einem oder mehreren Befehlsbenutzeroberflächen kontexten zuordnen, indem Sie einen Eintrag für jede Kombination Kontext Befehls einbeziehen. Wenn ein Befehl oder Menüs mit mehreren Befehlsbenutzeroberflächen kontexten zugeordnet ist, ist der Befehl oder das Menü sichtbar, wenn eines der zugeordneten Befehlsbenutzeroberflächen kontexte aktiv ist.
Das VisibilityItem-Element gilt nur an Befehle, Menüs und Symbolleisten, nicht auf Gruppen. Ein Element, das nicht über ein verwandtes VisibilityItem-Element verfügt, ist sichtbar, wenn sein übergeordnetes Menü aktiv ist.
<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 Befehlskennzeichens. |
id |
Erforderlich. Die ID des GUID-/IDBefehlskennzeichens. |
Kontext (Context) |
Erforderlich. Der Benutzeroberfläche-Kontext, in dem der Befehl sichtbar ist. |
Bedingung |
Optional. Weitere Informationen finden Sie unter Bedingte Attribute für das VSCT-XML-Schema. |
Untergeordnete Elemente
None
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
Das VisibilityConstraints-Element bestimmt die statische Sichtbarkeit von Gruppen Befehle und Symbolleisten. |
Hinweise
Die Standardeinstellung kontexte von Visual Studio Benutzeroberfläche werden in Pfad SDK-Installations Visual Studio\ VisualStudioIntegration Inc. \ \ Common \ vsshlids.h-Datei und definiert sowie in den UIContextGuidsUIContextGuids80-Klassen. Ein mehr gesamte Satz Benutzeroberflächen-Kontexte wird in der VSConstants-Klasse definiert.
Beispiel
<VisibilityConstraints>
<VisibilityItem guid="cmdSetGuidMyProductCommands" id="cmdidAddWidget"
context="guidNotViewSourceMode"/>
</VisibilityConstraints>