VisibilityItem 元素
VisibilityItem 元素确定命令和工具栏的静态可见性。 每个标识一个命令或菜单和一个关联的命令 UI 上下文。 Visual Studio 检测定义它们的命令,菜单和工具栏和它们的可见性,,而不加载 Vspackage。 IDE 使用 IsCmdUIContextActive 方法确定命令 UI 上下文是否处于活动状态。
在 VSPackage 加载后, Visual Studio 发现命令可见性取决于 VSPackage 而不是 VisibilityItem。 若要确定命令的可见性,可以根据如何执行 BeforeQueryStatus 事件处理程序或 QueryStatus 方法,实现了命令。
有一个 VisibilityItem 元素的命令或菜单仅关联的上下文是活动的。 您可以将一条命令、菜单或工具栏与一个或多个命令 UI 上下文传入包含每个命令上下文组合的项。 如果命令或菜单与多个命令 UI 上下文,则命令或菜单可见,当任何一个关联的命令 UI 上下文处于活动状态时。
VisibilityItem 元素仅适用于命令、菜单和工具栏,不适用于组。 没有一个相关 VisibilityItem 元素中可见,只要其父菜单处于活动状态。
<VisibilityItem
guid ="="cmdGuidMyProductCommands"
id=="cmdidAddWidget"
context="guidNotViewSourceMode"/>
特性和元素
以下几节描述了特性、子元素和父元素。
特性
特性 |
说明 |
---|---|
GUID |
必选。 GUID/ID 订单标识符的 GUID。 |
id |
必选。 GUID/ID 命令 ID 的 ID。 |
Context — 上下文 |
必选。 命令可见 UI 上下文。 |
Condition |
可选。 请参见 VSCT XML 架构条件特性。 |
子元素
无
父元素
元素 |
说明 |
---|---|
VisibilityConstraints 元素确定命令和工具栏组的静态可见性。 |
备注
标准 Visual Studio UI 上下文中定义 Visual Studio SDK 安装路径\VisualStudioIntegration\Common\Inc \ vsshlids.h 文件以及在 UIContextGuids 和 UIContextGuids80 类。 更完整设置 UI 上下文。 VSConstants 类中定义。
示例
<VisibilityConstraints>
<VisibilityItem guid="cmdSetGuidMyProductCommands" id="cmdidAddWidget"
context="guidNotViewSourceMode"/>
</VisibilityConstraints>