VisibilityItem – element
Prvek VisibilityItem určuje statickou viditelnost příkazů a panelů nástrojů. Každá položka identifikuje příkaz nebo nabídku a také přidružený kontext uživatelského rozhraní příkazu. Visual Studio rozpozná příkazy, nabídky a panely nástrojů a jejich viditelnost bez načtení balíčků VSPackage, které je definují. Integrované vývojové prostředí (IDE) používá metodu IsCmdUIContextActive k určení, jestli je aktivní kontext uživatelského rozhraní příkazu.
Po načtení balíčku VSPackage sada Visual Studio očekává, že bude viditelnost příkazů určena balíčkem VSPackage, nikoli .VisibilityItem Pokud chcete zjistit viditelnost příkazu, můžete implementovat obslužnou rutinu BeforeQueryStatus události nebo metodu QueryStatus v závislosti na způsobu implementace příkazu.
Příkaz nebo nabídka, která obsahuje VisibilityItem prvek, se zobrazí pouze v případech, kdy je přidružený kontext aktivní. Jeden příkaz, nabídku nebo panel nástrojů můžete přidružit k jednomu nebo více kontextům uživatelského rozhraní příkazů zahrnutím položky pro každou kombinaci kontextu příkazů. Pokud je příkaz nebo nabídka přidružená k více kontextům uživatelského rozhraní příkazů, příkaz nebo nabídka se zobrazí, když je aktivní některý z přidružených kontextů uživatelského rozhraní příkazu.
Tento VisibilityItem prvek se vztahuje pouze na příkazy, nabídky a panely nástrojů, ne na skupiny. Prvek, který nemá související VisibilityItem prvek je viditelný vždy, když je jeho nadřazená nabídka aktivní.
Syntaxe
<VisibilityItem
guid="cmdGuidMyProductCommands"
id="cmdidAddWidget"
context="guidNotViewSourceMode"/>
Atributy a prvky
Následující části popisují atributy, podřízené prvky a nadřazené prvky.
Atributy
| Atribut | Popis |
|---|---|
| guid | Povinný: Identifikátor GUID/ID příkazu. |
| ID | Povinný: ID identifikátoru příkazu GUID/ID. |
| kontext | Povinný: Kontext uživatelského rozhraní, ve kterém je příkaz viditelný. |
| Podmínka | Nepovinné. Viz Podmíněné atributy. |
Podřízené prvky
Nic
Nadřazené prvky
| Element (Prvek) | Popis |
|---|---|
| Element VisibilityConstraints | Prvek VisibilityConstraints určuje statickou viditelnost skupin příkazů a panelů nástrojů. |
Poznámky
Standardní kontexty uživatelského rozhraní sady Visual Studio jsou definovány v instalační cestě sady Visual Studio SDK\VisualStudioIntegration\Common\Inc\vsshlids.h a také v souborech UIContextGuids a UIContextGuids80 třídách. Kompletní sada kontextů uživatelského rozhraní je definována VSConstants ve třídě.
Příklad
<VisibilityConstraints>
<VisibilityItem guid="cmdSetGuidMyProductCommands" id="cmdidAddWidget"
context="guidNotViewSourceMode"/>
</VisibilityConstraints>