Элемент VisibilityItem

Статья
10/10/2023

Элемент VisibilityItem определяет статическую видимость команд и панелей инструментов. Каждая запись определяет команду или меню, а также связанный контекст пользовательского интерфейса команды. Visual Studio обнаруживает команды, меню и панели инструментов и их видимость без загрузки VSPackages, определяющих их. Интегрированная среда разработки IsCmdUIContextActive использует метод, чтобы определить, активен ли контекст пользовательского интерфейса команды.

После загрузки VSPackage Visual Studio ожидает, что видимость команды определяется vsPackage, а не .VisibilityItem Чтобы определить видимость команды, можно реализовать обработчик BeforeQueryStatus событий или QueryStatus метод в зависимости от того, как вы реализовали команду.

Команда или меню с элементом отображается только в том случае, если связанный VisibilityItem контекст активен. Можно связать одну команду, меню или панель инструментов с одним или несколькими контекстами пользовательского интерфейса команд, включая запись для каждой комбинации контекста команд. Если команда или меню связаны с несколькими контекстами пользовательского интерфейса команды, команда или меню отображается, когда активен любой из связанных контекстов пользовательского интерфейса команды.

Элемент VisibilityItem применяется только к командам, меню и панелям инструментов, а не к группам. Элемент, не имеющий связанного VisibilityItem элемента, отображается всякий раз, когда его родительское меню активно.

Синтаксис

<VisibilityItem
  guid="cmdGuidMyProductCommands"
  id="cmdidAddWidget"
  context="guidNotViewSourceMode"/>

Элементы и атрибуты

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут	Description
guid	Обязательно. GUID идентификатора команды GUID/ID.
id	Обязательно. Идентификатор идентификатора команды GUID/ID.
контекстные	Обязательно. Контекст пользовательского интерфейса, в котором отображается команда.
Condition	Необязательно. См . условные атрибуты.

Дочерние элементы

нет

Родительские элементы

Элемент	Description
Элемент VisibilityConstraints	Элемент `VisibilityConstraints` определяет статическую видимость групп команд и панелей инструментов.

Замечания

Стандартные контексты пользовательского интерфейса Visual Studio определяются в пути установки пакета SDK Visual Studio\VisualStudioIntegration\Common\Inc\vsshlids.h, а также в UIContextGuids классах и UIContextGuids80 классах. Более полный набор контекстов пользовательского интерфейса определяется в VSConstants классе.

Пример

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

Поделиться через