加速键（或键盘加速键）为键盘快捷方式，可以为用户提供一种直观的方式，使其能够调用常用操作或命令而无需导航应用 UI，从而改善 Windows 应用程序的实用功能和辅助功能。

注意

对于残疾人士用户而言，键盘是必不可少的工具（请参阅键盘辅助功能），并且对于将键盘认为是与应用交互的较有效方法的用户而言，键盘也非常重要。

有关使用键盘快捷方式导航 Windows 应用程序的 UI 的详细信息，请参阅访问键主题。

若要创建你自己的自定义键盘快捷方式，请参阅键盘事件主题。

快捷方式由两种类型的键组成：修改键和非修改键。 修改键包括 Shift、菜单、Ctrl 和 Windows 键，这些键通过 VirtualKeyModifiers 公开。 非修改键包括所有 VirtualKey，如 Delete、F3、空格键、箭头键、Esc 以及所有字母数字和标点符号键。

注意

快捷方式通常包括功能键 F1 到 F12 或标准键与一个或多个配对的修改键（Ctrl、Shift）的某种组合。 例如，如果用户按 Ctrl+Shift+M，框架将检查修改键（Ctrl 和 Shift），并触发加速键（如果存在）。

许多 XAML 控件都有内置的键盘加速键。 例如，ListView 支持使用 Ctrl+A 来选择列表中的所有项，RichEditBox 支持使用 Ctrl+Tab 在文本框中插入一个制表符。 这些内置键盘加速键称为控件加速键，只有当焦点位于元素或其子项之一时才会执行。 你使用此处所讨论的键盘加速键 API 定义的加速键被称为应用加速键。

键盘加速键并非适用于每一项操作，但通常与菜单中公开的命令相关联（并且应该用菜单项内容来指定）。 快捷方式也可能与没有等效菜单项的操作相关联。 但是，因为用户依赖于应用程序菜单来发现和了解可用的命令集，所以你应该尝试让加速键的发现尽可能容易（使用标签或既定模式对此有帮助）。

加速键会自动重复（例如，当用户按 Ctrl+Shift 然后按住 M 时，会重复调用加速键，直到松开 M 为止）。 此行为无法修改。

菜单项标签中所描述的键盘加速键

我们建议你在 UI 的合适位置指定键盘加速键并在所有自定义控件中支持加速键。

键盘快捷方式使运动障碍用户（包括一次只能按下一个键或使用鼠标有困难的用户）更易于访问你的应用。

具有良好设计的键盘 UI 是软件辅助功能的一个重要方面。 它使具有视力缺陷或行动有障碍的用户能够在应用中导航并与应用的功能交互。 这些用户可能无法操作鼠标，而是依靠各种辅助技术，如键盘增强工具、屏幕键盘、屏幕放大器、屏幕阅读器、语音输入实用工具。 对于这些用户，广泛的命令覆盖面非常重要。

对于喜欢通过键盘进行交互的高级用户，键盘加速键可以让他们更轻松地使用应用。

有经验的用户通常强烈倾向于使用键盘，因为可以更为快速地输入可让基于键盘的命令，而无需将双手从键盘上挪开。 对于这些用户，效率性和一致性体验至关重要；综合性体验仅对常用命令十分重要。

使用 KeyboardAccelerator API 在 Windows 应用中创建键盘加速键。 使用这些 API，你不必处理多个 KeyDown 事件即可检测到按下的组合键，并且可以在应用资源中对快捷方式进行本地化。

我们建议你为应用中最常见的操作设置键盘快捷方式并使用菜单项标签或工具提示记录它们。 在此示例中，我们只为重命名和复制命令声明键盘快捷方式。

工具提示中所描述的键盘快捷方式

UIElement 对象具有一个 KeyboardAccelerator 集合，即 KeyboardAccelerators，你可以在其中指定自定义的 KeyboardAccelerator 对象并定义键盘快捷方式的击键：

Key - 用于键盘快捷方式的 VirtualKey。

Modifiers - 用于键盘快捷方式的 VirtualKeyModifiers。 如果未设置 Modifiers，则默认值是“无”。

注意

支持单键（A、Delete、F2、空格键、Esc、多媒体键）快捷方式和多键快捷方式 (Ctrl+Shift+M)。 但是，不支持游戏板虚拟键。

一些快捷方式只能在特定范围内使用，而其他快捷方式则可以在应用范围内使用。

例如，Microsoft Outlook 包含以下快捷方式：

上下文菜单操作仅影响特定区域或元素，例如文本编辑器中的选定字符或播放列表中的歌曲。 因此，我们建议将上下文菜单项的键盘快捷方式的作用域设置为上下文菜单的父项。

使用 ScopeOwner 属性指定键盘快捷方式的作用域。 这段代码演示如何使用限定作用域的键盘快捷方式在 ListView 上实现上下文菜单：

MenuFlyoutItem.KeyboardAccelerators 元素的 ScopeOwner 属性会将快捷方式标记为已限定作用域而非全局（默认为 Null 或全局）。 有关更多详细信息，请参阅本主题后面的解析加速键部分。

KeyboardAccelerator 对象使用 UI 自动化 (UIA) 控件模式在调用加速键时采取相应的操作。

UIA [控件模式] 将公开常见的控件功能。 例如，Button 控件可实现 Invoke 控件模式，以支持 Click 事件（通常，通过单击、双击或按 Enter、预定义的键盘快捷方式或其他击键组合来调用控件）。 使用键盘快捷方式调用控件时，XAML 框架会查找控件是否实现了 Invoke 控件模式，如果已实现，则会激活该模式（侦听 KeyboardAcceleratorInvoked 事件并不需要该模式）。

在以下示例中，Control+S 会触发 Click 事件，因为按钮会实现 Invoke 模式。

如果元素实现多个控件模式，则只能通过快捷方式激活一种模式。 控件模式的优先顺序如下所示：

如果未标识匹配项，则加速器无效，并且会提供调试消息 (“找不到此组件的自动化模式。在 Invoked 事件中实现所有所需行为。在事件处理程序中将 Handled 设置为 true 将禁止显示此消息。”)

KeyboardAccelerator 对象的 Invoked 事件是在执行快捷方式时激发的。 KeyboardAcceleratorInvokedEventArgs 事件对象包含以下属性：

在此，我们将演示如何为 ListView 中的项定义键盘加速键集合，以及如何处理每个加速键的 Invoked 事件。

某些控件在获得焦点时，支持使用内置键盘加速键来替代任何应用定义加速键。 例如，当 TextBox 获得焦点时，Ctrl+C 加速键仅复制当前选定的文本（忽略应用定义加速键并且不执行其他功能）。

虽然我们不建议替代默认控件行为（因为用户熟悉并且会预期此行为），但你可以替代控件的内置键盘加速键。 以下示例演示如何通过 PreviewKeyDown 事件处理程序替代 TextBox 的 Ctrl+C 键盘加速键：

如果禁用控件，则也会禁用关联的快捷方式。 在以下示例中，因为 ListView 的 IsEnabled 属性设置为 false，所以无法调用关联的 Ctrl+A 快捷方式。

父控件和子控件可以共享相同快捷方式。 在此情况下，即使子项具有焦点并且禁用了其快捷方式，也可以调用父控件。

诸如“讲述人”之类的屏幕阅读器可以向用户宣布键盘快捷方式组合键。 默认情况下，这是后面跟有键（由“+”符号分隔）的每个修改键（采用 VirtualModifiers 枚举顺序）。 你可以通过 AcceleratorKey AutomationProperties 附加属性自定义此项。 如果指定了多个快捷方式，则仅宣布第一个。

在此示例中，AutomationProperty.AcceleratorKey 会返回字符串“Ctrl+Shift+A”：

注意

设置 AutomationProperties.AcceleratorKey 并不会启用键盘功能，只是向 UIA 框架指示使用了哪些键。

建议在 Windows 应用程序中使键盘加速键保持一致。

用户必须记住键盘加速键并且期望获得相同（或类似）的结果，但这或许并不总能实现，因为各个应用的功能不同。

请注意，某些组合对本地化版本的 Windows 无效。 例如，在西班牙语版本的 Windows 中，Ctrl+N 用于改为粗体，而不是 Ctrl+B。 如果对应用进行了本地化，那么我们建议提供本地化的键盘加速键。

由于 Windows 应用程序的 UI 中一般并不直接说明键盘加速键，因此，你可以通过工具提示提高可发现性，当用户将焦点移动到某个控件、按住某个控件或将鼠标指针悬停在某个控件上时，会自动显示工具提示。 工具提示可以标识某个控件是否有关联的键盘加速键，如果有，将会标识加速键组合。

Windows 10 版本 1803（2018 年 4 月更新）及更高版本

默认情况下，当声明键盘加速键时，所有控件（MenuFlyoutItem 和 ToggleMenuFlyoutItem 除外）都会在工具提示中显示相应的组合键。

注意

如果某个控件定义了多个加速键，工具提示中只显示第一个加速键。

工具提示中的快捷键组合

对于 Button、AppBarButton 和 AppBarToggleButton 对象，键盘加速键将追加到控件的默认工具提示中。 对于 MenuFlyoutItem 和 ToggleMenuFlyoutItem 对象，键盘加速键与浮出控件文本一起显示。

注意

指定工具提示（见以下示例中的 Button1）会替代此行为。

追加到 Button 的默认工具提示的加速键组合

追加到 AppBarButton 的默认工具提示的加速键组合

追加到 MenuFlyoutItem 文本的快捷键组合

通过使用 KeyboardAcceleratorPlacementMode 属性控制显示行为，该属性接受两个值：自动或隐藏。

在某些情况下，你可能需要相对于另一个元素（通常是容器对象）显示工具提示。

下面，我们介绍如何使用 KeyboardAcceleratorPlacementTarget 属性通过网格容器而不是按钮来显示“保存”按钮的键盘加速键组合。

在某些情况下，我们建议使用控件的标签来标识该控件是否有关联的键盘加速键，如果有，将会标识加速键组合。

有些平台控件默认具有此行为，尤其是 MenuFlyoutItem 和 ToggleMenuFlyoutItem 对象，而 AppBarButton 和 AppBarToggleButton 在出现在 CommandBar 的溢出菜单中时具有此行为。

菜单项标签中所描述的键盘加速键

你可以通过 MenuFlyoutItem、ToggleMenuFlyoutItem、AppBarButton 和 AppBarToggleButton 控件的 KeyboardAcceleratorTextOverride 属性覆盖标签的默认加速键文本（无文本时使用一个空格）。

注意

如果系统无法检测连接的键盘（你可以通过 KeyboardPresent 属性自行检查），则不显示覆盖文本。

下面，我们回顾一下键盘加速键的某些低层次方面的内容。

输入事件按特定顺序发生，你可以根据应用的要求拦截和处理这些事件。

在 XAML 中，会像只有一个输入浮升管道那样来处理键击。 KeyDown/KeyUp 事件和字符输入会使用此输入管道。 例如，如果元素具有焦点并且用户按下了某个键，则会对此元素引发 KeyDown 事件，随后对此元素的父项引发此事件，一直向上处理到树顶，直到 args.Handled 属性为 true 为止。

KeyDown 事件也被一些控件用来实现内置的控件快捷方式。 当控件具有键盘快捷方式时，它会处理 KeyDown 事件，这意味着将不会有 KeyDown 事件浮升。 例如，RichEditBox 支持使用 Ctrl+C 进行复制。 当按下 Ctrl 时，KeyDown 事件会被触发并浮升，但是当用户同时按下 C 时，KeyDown 事件会被标记为“已处理”，并且不会被触发（除非将 UIElement.AddHandler 的 handledEventsToo 参数设置为 true）。

由于 CharacterReceived 事件在 TextBox 等文本控件的 KeyDown 事件之后触发，因此，你可以在 KeyDown 事件处理程序中取消字符输入。

预览输入事件在任何其他事件之前触发。 如果不处理这些事件，则会触发具有焦点的元素的快捷方式，然后触发 KeyDown 事件。 这两个事件均会浮升，直到被处理为止。

密钥事件序列的关系图

事件的顺序：

预览 KeyDown 事件 … 应用加速键 OnKeyDown 方法 KeyDown 事件 父项上的应用加速键 父项上的 OnKeyDown 方法 父项上的 KeyDown 事件 （浮升至根） … CharacterReceived 事件 PreviewKeyUp 事件 KeyUp 事件

处理快捷方式事件后，也会将 KeyDown 事件标记为已处理。 KeyUp 事件仍未处理。

键盘快捷方式事件从具有焦点的元素向上浮升至根。 如果未处理事件，那么 XAML 框架会在浮升路径之外寻找其他未限定作用域的应用快捷方式。

如果使用相同的组合键定义了两个键盘快捷方式，则调用可视化树上找到的第一个键盘快捷方式。

仅当焦点在特定作用域内时，才会调用限定作用域的键盘快捷方式。 例如，在包含数十个控件的 Grid 中，只有当焦点位于此 Grid（作用域所有者）内时，才能为控件调用键盘快捷方式。

UIElement.TryInvokeKeyboardAccelerator 方法会调用元素子树中任何匹配的快捷方式。

UIElement.OnProcessKeyboardAccelerators 方法在键盘快捷方式之前执行。 此方法将传递一个 ProcessKeyboardAcceleratorArgs 对象，该对象包含键、修改键以及一个指示是否处理了键盘快捷方式的布尔值。 如果键盘快捷方式被标记为已处理，则它会浮升（因此决不会调用外部键盘快捷方式）。

注意

无论是否被处理，系统始终会触发 OnProcessKeyboardAccelerators（类似于 OnKeyDown 事件）。 你必须检查事件是否被标记为已处理。

在此示例中，我们使用 OnProcessKeyboardAccelerators 和 TryInvokeKeyboardAccelerator 将键盘快捷方式的作用域限定为 Page 对象：

我们建议本地化所有键盘快捷方式。 你可以使用标准资源 (.resw) 文件和 XAML 声明中的 X:uid 属性来执行此操作。 在此示例中，Windows 运行时将自动加载资源。

使用资源文件进行键盘快捷键本地化

下面是以编程方式定义快捷方式的示例：

注意

KeyboardAccelerator 不可共享，并且相同的 KeyboardAccelerator 无法添加到多个元素中。

你可以处理 KeyboardAccelerator.Invoked 事件以覆盖默认的 KeyboardAccelerator 行为。

此示例显示了如何在自定义 ListView 控件中覆盖“全选”命令（Ctrl+A 键盘加速键）。 我们还将 Handled 属性设置为 true 以停止以后的事件浮升。