VisibilityItem 元素

VisibilityItem 元素确定命令和工具栏的静态可见性。 每个条目都标识命令或菜单,以及关联的命令 UI 上下文。 Visual Studio 检测命令、菜单和工具栏及其可见性,而无需加载定义它们的 VSPackage。 IDE 使用 IsCmdUIContextActive 该方法来确定命令 UI 上下文是否处于活动状态。

加载 VSPackage 后,Visual Studio 需要由 VSPackage 而不是 VisibilityItemVSPackage 确定命令可见性。 若要确定命令的可见性,可以根据命令的实现方式实现 BeforeQueryStatus 事件处理程序或 QueryStatus 方法。

仅当关联上下文处于活动状态时,才会显示具有 VisibilityItem 元素的命令或菜单。 可以通过包括每个命令上下文组合的条目,将单个命令、菜单或工具栏与一个或多个命令 UI 上下文相关联。 如果命令或菜单与多个命令 UI 上下文相关联,则当任何一个关联的命令 UI 上下文处于活动状态时,该命令或菜单可见。

VisibilityItem 元素仅适用于命令、菜单和工具栏,不适用于组。 每当其父菜单处于活动状态时,不具有相关 VisibilityItem 元素的元素都可见。

语法

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

特性和元素

下列各节描述了特性、子元素和父元素。

特性

属性 说明
guid 必需。 GUID/ID 命令标识符的 GUID。
id 必需。 GUID/ID 命令标识符的 ID。
context 必需。 命令可见的 UI 上下文。
条件 可选。 请参阅 条件属性

子元素

父元素

元素 说明
VisibilityConstraints 元素 VisibilityConstraints 元素确定命令和工具栏组的静态可见性。

注解

标准 Visual Studio UI 上下文在 Visual Studio SDK 安装路径\VisualStudioIntegration\Common\Inc\vsshlids.h 文件中以及类中UIContextGuidsUIContextGuids80定义。 类中 VSConstants 定义了一组更完整的 UI 上下文。

示例

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

另请参阅