Command.Keytip 属性

  • 项目

表示控件的快捷键提示。

使用情况

<Command.Keytip>
  child elements
</Command.Keytip>

特性

没有属性。

子元素

元素 说明
字符串
 最多可以发生一次

父元素

元素
命令

备注

可选。

每个 Command 元素最多可以发生一次。

Command.Keytip 可以包含类型 为 xs：string 的值，该值限制为任何 Unicode 字符序列，包括空格。

仅当与 Tab 或快速访问工具栏中的控件关联时，Command.Keytip 才能以数字开头。

若要显示对功能区当前状态有效的键提示，请按住 Alt 键。 以下屏幕截图显示了 Windows 7 Microsoft 画图中显示的初始或第一级键提示。 选择第一级键提示后，仅显示二级键提示。

适用于 Windows 7 的 Microsoft paint 中的第一级键提示

Command.Keytip 充当命令的键盘快捷键，除非该命令通过菜单项公开。 在这种情况下，框架将忽略 Command.Keytip 值，而是使用由 Command.LabelTitle 或 UI_PKEY_Label 指定的与号前面的字符。 如果 Command.LabelTitle 或 UI_PKEY_Label 未指定与号，则不会公开任何键提示或键盘快捷键。

如果未为 Command.Keytip 提供任何值，则需要 String 子元素。

注意

如果 Command.Keytip 同时包含值和 String 子元素， 则 String 优先。

默认情况下，框架使用以下字母自动生成键提示：

注意

框架不会保留这些字母。 每个命令都可以根据需要分配给一个或多个命令。

框架通过以下方式解决键提示冲突：

  • 如果一个或多个 Tab 控件与同一个键提示相关联，则每个键提示将追加一个数字，从 1 开始，并按声明顺序递增 (2、3,...) 。 如果向任何 Tab 控件分配字母 F 作为键提示，则会为 应用程序菜单 分配 F1，其余键提示按所述进行调整。
  • 当与 Tab 中的单个控件关联时，键提示 F 对控件和 应用程序菜单都有效。 默认的应用程序菜单键提示不会更改，但优先于活动选项卡上的控件。
  • 如果 Tab 中的 一个或多个控件与同一个键提示相关联，框架会自动重新调整这些控件的键提示，如前所述。

注意

文本颜色略有变化，用于突出显示标准功能区实现中重构的键提示。 对于已自定义功能区颜色的非标准功能区实现，将重写此框架行为，并使用相同的文本颜色显示所有键提示。 有关详细信息，请参阅 自定义功能区颜色。

最大长度是无限制的。

示例

以下示例演示具有 Command.Keytip 声明的 Command 元素的标记。

<Command>
  <Command.Name>cmdSave</Command.Name>
  <Command.Symbol>ID_FILE_SAVE</Command.Symbol>
  <Command.Comment>Save</Command.Comment>
  <Command.Id>25003</Command.Id>
  <Command.LabelTitle>
    <String>
      <String.Content>Label for Save</String.Content>
      <String.Id>59999</String.Id>
      <String.Symbol>strSave</String.Symbol>
    </String>
  </Command.LabelTitle>
  <Command.TooltipTitle>Tooltip title with &amp;&amp; for Save Command</Command.TooltipTitle>
  <Command.TooltipDescription>Tooltip description for Save Command.</Command.TooltipDescription>
  <Command.Keytip>s1</Command.Keytip>
</Command>

要求

要求 值
最低受支持的客户端
 Windows 7 [仅限桌面应用]
最低受支持的服务器
 Windows Server 2008 R2 [仅限桌面应用]

另请参阅

UI_PKEY_Keytip