命令标志元素

修改其父元素。

语法

<CommandFlag>DynamicVisibility</CommandFlag>

特性和元素

以下部分介绍有效的元素值。

特性

无。

子元素

说明
AllowParams 指示用户在键入命令规范名称时,可以在“命令”窗口中输入命令参数

有效期: Button
AlwaysCreate 即使没有组或按钮,也会创建菜单。

有效期: Menu
CaseSensitive 用户条目区分大小写。

有效期: Combo
CommandWellOnly 如果命令未显示在顶级菜单上,并且希望使其可用于其他 shell 自定义,例如,将其绑定到键盘快捷方式,则应用此标志。 安装 VSPackage 后,可以通过打开“选项”对话框,然后在键盘环境类别下编辑命令放置来自定义这些命令。 此标志不会影响快捷菜单、工具栏、菜单控制器或子菜单上的放置。

有效期: ButtonCombo
DefaultDisabled 默认情况下,如果未加载实现该命令的 VSPackage 或尚未调用该方法, QueryStatus 则会禁用该命令。

有效期: ButtonCombo
DefaultDocked 默认停靠。 此设置不再适用于工具栏,因为它们始终停靠。
DefaultInvisible 默认情况下,如果实现该命令的 VSPackage 未加载或尚未调用该方法, QueryStatus 则命令不可见。

建议将此与标志组合在一起 DynamicVisibility

有效期: Button, , ComboMenu
DontCache 开发环境不缓存 QueryStatus 此命令的方法结果。

对于菜单,这会告知菜单控制器不缓存其菜单项的文本。 当菜单包含具有动态文本的动态项或项时,请使用此标志。

有效期: ButtonMenu
DynamicAutomationName 指定 QueryStatus 处理程序将响应OLECMDTEXTFEXT_AUTOMATIONNAME,并返回一个字符串,用作控件的自动化名称。 如果使用 OleMenuCommand,则可以在 BeforeQueryStatus 处理程序中设置 AutomationName 属性(如果设置了此标志)。

在 Menu 元素上使用时,此标志仅适用于 MenuController 或 MenuControllerLatched 类型的菜单。

有效期: Button, , ComboMenu
DynamicItemStart 指示动态列表的开头。 这样环境就可以通过在列表项上连续调用 QueryStatus 方法来生成列表,直到返回OLECMDERR_E_UNSUPPORTED标志。 这适用于最近使用的项目(MRU)列表和窗口列表。

有效期: Button
DynamicVisibility 该命令的可见性可以通过方法或通过节中包含的VisibilityConstraints上下文 GUID 进行更改QueryStatus

适用于在菜单和工具窗口工具栏上显示的命令,但不适用于主窗口中显示的顶级工具栏。 当从 QueryStatus 方法返回OLECMDF_INVISIBLE标志时,可以禁用顶级工具栏项,但不能隐藏。 工具窗口工具栏上显示的工具栏命令可以隐藏。

在菜单上,此标志还指示当其所有成员处于隐藏状态时,它应自动隐藏。 此标志通常分配给子菜单,因为顶级菜单已具有此行为。

此标志应与标志组合在一起 DefaultInvisible

有效期: Button, , ComboMenu
FilterKeys 请参阅组合元素下的“筛选键”主题。

有效期: Combo
FixMenuController 如果此命令位于菜单控制器上,则命令始终为默认值;也就是说,每当选择菜单控制器按钮本身时,该命令都处于选中状态。 如果菜单控制器设置了 TextIsAnchorCommand 标志,则菜单控制器还会从具有标志的 FixMenuController 命令中获取其文本。

菜单控制器上只有一个命令应具有 FixMenuController 标志。 如果标记了多个命令,菜单中的最后一个命令将成为默认命令。

有效期: Button
IconAndText 在菜单和工具栏上显示图标和文本。

有效期: Button, , ComboMenu
NoAutoComplete 自动完成功能已禁用。

有效期: Combo
NoButtonCustomize 不要让用户自定义此按钮。

有效期: ButtonCombo
NoKeyCustomize 不要启用键盘自定义。

有效期: ButtonCombo
NoShowOnMenuController 如果此命令位于菜单控制器上,该命令不会显示在下拉列表中。

有效期: Button
NotInTBList 不在可用工具栏列表中显示。 这仅适用于工具栏菜单类型。

有效期: Menu
NoToolbarClose 用户无法关闭工具栏。 这仅适用于工具栏菜单类型。

有效期: Menu
Pict 仅显示工具栏上的图标,但仅显示菜单上的文本。 如果未指定任何图标,则显示工具栏上的可单击空白空间。

有效期: Button
PostExec 使命令不阻塞。 开发环境会延迟执行,直到完成所有预处理查询。

有效期: Button
RouteToDocs 该命令将路由到活动文档。

有效期: Button
StretchHorizontally 设置此标志后,宽度将成为组合框的最小宽度,如果工具栏上有空间,组合框将拉伸以填充可用空间。 仅当工具栏水平停靠,工具栏上只有一个组合框可以使用标志(除了第一个组合框之外的所有组合框上都忽略该标志),才会发生这种情况。

有效期: Combo
TextChanges 命令或菜单文本可以在运行时更改,通常通过 QueryStatus 该方法。

有效期: ButtonMenu
TextChangesButton 有效期: Button
TextIsAnchorCommand 对于菜单控制器,菜单的文本取自默认(定位点)命令。 定位点命令是选择或锁定的最后一个命令。 如果未设置此标志,菜单控制器将使用其自己的 MenuText 字段。 但是,单击菜单控制器仍启用该控制器中最后一个选定的命令。

建议将此标志与标志组合在一 TextChanges 起。

此标志仅适用于 MenuController 或 MenuControllerLatched 类型的菜单。

有效期: Menu
TextMenuCtrlUseMenu 使用 MenuText 菜单控制器上的字段。 默认字段为 ButtonText.

有效期: Button
TextMenuUseButton ButtonText 字段用于菜单。 默认字段 MenuText 为指定字段。

有效期: Button
TextOnly 仅显示工具栏或菜单上的文本,但即使指定了图标,也不显示任何图标。

有效期: Button
TogglePatternAvailable 指示按钮支持检查/闩锁(即,可能会返回OLEMCDF_LATCHED或在 OleMenuCommand 上设置 Checked 属性)。 这样,自动化层就可以公开切换模式,以便屏幕阅读器将读取检查/未检查状态以及按钮文本。

有效期: Button

父元素

元素 说明
Buttons 元素 为 Button 元素元素提供组
Menus 元素 定义 VSPackage 实现的所有菜单。

另请参阅