Element VisibilityItem
Element VisibilityItem określa statyczną widoczność poleceń i pasków narzędzi. Każdy wpis identyfikuje polecenie lub menu, a także skojarzony kontekst interfejsu użytkownika polecenia. Program Visual Studio wykrywa polecenia, menu i paski narzędzi oraz ich widoczność bez ładowania pakietów VSPackage, które je definiują. Środowisko IDE używa IsCmdUIContextActive metody , aby określić, czy kontekst interfejsu użytkownika polecenia jest aktywny.
Po załadowaniu pakietu VSPackage program Visual Studio oczekuje, że widoczność poleceń zostanie określona przez pakiet VSPackage, a nie VisibilityItemelement . Aby określić widoczność polecenia, możesz zaimplementować BeforeQueryStatus program obsługi zdarzeń lub QueryStatus metodę, w zależności od sposobu zaimplementowania polecenia.
Polecenie lub menu z elementem VisibilityItem jest wyświetlane tylko wtedy, gdy skojarzony kontekst jest aktywny. Można skojarzyć pojedyncze polecenie, menu lub pasek narzędzi z co najmniej jednym kontekstem interfejsu użytkownika polecenia, dołączając wpis dla każdej kombinacji kontekstu poleceń. Jeśli polecenie lub menu jest skojarzone z wieloma kontekstami interfejsu użytkownika poleceń, polecenie lub menu jest widoczne, gdy którykolwiek ze skojarzonych kontekstów interfejsu użytkownika polecenia jest aktywny.
Element VisibilityItem dotyczy tylko poleceń, menu i pasków narzędzi, a nie grup. Element, który nie ma powiązanego VisibilityItem elementu, jest widoczny za każdym razem, gdy jego menu nadrzędne jest aktywne.
Składnia
<VisibilityItem
guid="cmdGuidMyProductCommands"
id="cmdidAddWidget"
context="guidNotViewSourceMode"/>
Atrybuty i elementy
W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.
Atrybuty
| Atrybut | opis |
|---|---|
| Identyfikator GUID | Wymagany. Identyfikator GUID/identyfikator polecenia. |
| identyfikator | Wymagany. Identyfikator identyfikatora polecenia GUID/ID. |
| kontekst | Wymagany. Kontekst interfejsu użytkownika, w którym polecenie jest widoczne. |
| Stan | Opcjonalny. Zobacz Atrybuty warunkowe. |
Elementy podrzędne
Brak
Elementy nadrzędne
| Element | opis |
|---|---|
| Element Ograniczenia widoczności | Element VisibilityConstraints określa statyczną widoczność grup poleceń i pasków narzędzi. |
Uwagi
Standardowe konteksty interfejsu użytkownika programu Visual Studio są definiowane w ścieżce instalacji zestawu SDK programu Visual Studio\VisualStudioIntegration\Common\Inc\vsshlids.h, a także w UIContextGuids klasach i UIContextGuids80 . Bardziej kompletny zestaw kontekstów interfejsu użytkownika jest definiowany w VSConstants klasie.
Przykład
<VisibilityConstraints>
<VisibilityItem guid="cmdSetGuidMyProductCommands" id="cmdidAddWidget"
context="guidNotViewSourceMode"/>
</VisibilityConstraints>