访问密钥

访问键是键盘快捷方式，可以通过为用户提供直观的方式，使用键盘快速导航和与应用程序的可见用户界面进行交互，而无需使用指针设备（如触摸或鼠标），从而提高 Windows 应用程序的可用性和可访问性。

Windows 应用程序通过称为键提示的视觉线索，为跨平台控件提供内置支持，支持基于键盘的访问键和相关的 UI 反馈。

有关使用键盘快捷方式调用 Windows 应用程序中的常见作的详细信息，请参阅 加速器键 主题。

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

概述

访问键是 Alt 键与一个或多个字母数字键的组合，通常也被称为mnemonic，一般是依次按下而不是同时按下。

键提示是在用户按下 Alt 键时，显示在支持访问键的控件旁边的徽章。 每个键提示都包含用于激活相关控件的字母数字键。

按 Alt 键可初始化access键功能，并在键提示中显示所有当前可用的键组合。 后续按键由访问键框架处理，无效按键将被拒绝，直到按下有效的访问键，或者按下 Enter、Esc、Tab 或箭头键停用访问键，并将按键处理返回到应用程序。

Microsoft Office应用为访问键提供广泛的支持。 下图显示了在 Word 的“开始”选项卡中激活了访问键功能（请注意，它支持数字和多个击键）。

Microsoft Word 中访问键的键提示徽章

Microsoft Word 中访问键的键提示徽章

若要向控件添加access键，请使用 AccessKey 属性。 此属性的值指定了访问键序列、快捷键（如果为单个字母数字）和按键提示。

<Button Content="Accept" AccessKey="A" Click="AcceptButtonClick" />

何时使用访问密钥

我们建议您在用户界面中适当指定快捷键，并在所有自定义控件中支持快捷键。

1. 访问键提升应用程序的可访问性，此功能惠及包括那些每次只能按一个键或难以使用鼠标的用户。

   设计良好的键盘 UI 是软件辅助功能的重要方面。 它使视力障碍或具有某些运动障碍的用户能够导航应用并与其功能交互。 此类用户可能无法操作鼠标，而是依赖于各种辅助技术，例如键盘增强工具、屏幕键盘、屏幕放大器、屏幕阅读器和语音输入工具。 对于这些用户，全面的命令覆盖率至关重要。

2. 访问键使你的应用更易于使用，适合喜欢通过键盘进行交互的高级用户。

   经验丰富的用户通常倾向于使用键盘，因为基于键盘的命令可以更快地输入，并且不需要他们从键盘中删除手。 对于这些用户，效率和一致性至关重要;仅对最常用的命令而言，全面性非常重要。

设置访问密钥范围

当屏幕上有许多支持access键的元素时，我们建议将access键范围限定为减少 认知负载。 这样可最大程度地减少屏幕上access键的数量，从而使它们更易于定位，并提高效率和工作效率。

例如，Microsoft Word 提供两个访问键范围：用于功能区选项卡的主区域，和用于所选选项卡上命令的次要区域。

下列图像展示了 Word 中的两种访问密钥范围。 第一个显示主要access键，允许用户选择选项卡和其他顶级命令，第二个显示主选项卡的辅助access键。

Microsoft Word中的主要访问键

Microsoft Word 中的次级访问键

对于不同范围内的元素，可以复制访问键。 在前面的示例中，“2”是主区域中撤消的访问键，也是次要区域中的“斜体”。

下面介绍如何定义访问密钥范围。

<CommandBar x:Name="MainCommandBar" AccessKey="M" >
    <AppBarButton AccessKey="G" Icon="Globe" Label="Go"/>
    <AppBarButton AccessKey="S" Icon="Stop" Label="Stop"/>
    <AppBarSeparator/>
    <AppBarButton AccessKey="R" Icon="Refresh" Label="Refresh" IsAccessKeyScope="True">
        <AppBarButton.Flyout>
            <MenuFlyout>
                <MenuFlyoutItem AccessKey="A" Icon="Globe" Text="Refresh A" />
                <MenuFlyoutItem AccessKey="B" Icon="Globe" Text="Refresh B" />
                <MenuFlyoutItem AccessKey="C" Icon="Globe" Text="Refresh C" />
                <MenuFlyoutItem AccessKey="D" Icon="Globe" Text="Refresh D" />
            </MenuFlyout>
        </AppBarButton.Flyout>
    </AppBarButton>
    <AppBarButton AccessKey="B" Icon="Back" Label="Back"/>
    <AppBarButton AccessKey="F" Icon="Forward" Label="Forward"/>
    <AppBarSeparator/>
    <AppBarToggleButton AccessKey="T" Icon="Favorite" Label="Favorite"/>
    <CommandBar.SecondaryCommands>
        <AppBarToggleButton Icon="Like" AccessKey="L" Label="Like"/>
        <AppBarButton Icon="Setting" AccessKey="S" Label="Settings" />
    </CommandBar.SecondaryCommands>
</CommandBar>

CommandBar 的

CommandBar 主范围和支持的访问键

CommandBar 的

CommandBar 辅助范围和支持的访问键

避免访问键冲突

当同一作用域中的两个或多个元素具有重复的access键或以相同的字母数字字符开头时，会发生Access键冲突。

系统通过处理添加到可视化树的第一个元素的access键（忽略所有其他元素）来解决重复access键。

当多个access键以相同的字符（例如，“A”、“A1”和“AB”）开头时，系统将处理单个字符access键并忽略所有其他字符。

通过使用唯一的访问键或限定命令来避免冲突。

选择访问密钥

选择访问密钥时，请考虑以下事项：

• 使用单个字符以尽量减少击键次数，并默认支持加速键（Alt+AccessKey）
• 避免使用两个以上的字符
• 避免访问键冲突
• 避免难以区分其他字符的字符，例如字母“I”和数字“1”或字母“O”和数字“0”
• 使用来自其他常用应用的知名先例（例如 Word（“F”表示“文件”、“H”表示“主页”等）
• 使用命令名称的第一个字符，或与帮助召回的命令有密切关联的字符
  • 如果已分配第一个字母，请使用尽可能接近命令名称的第一个字母（“N”for Insert）
  • 使用命令名称中一个独特的辅音（例如“W”代表视图）
  • 使用命令名称中的元音。

本地化访问密钥

如果你的应用将采用多种语言进行本地化，则还应考虑对访问键进行本地化。 例如，在 en-US 中，“H” 代表“Home”，在 es-ES 中，“I” 代表“Inicio”。

在标记中使用 x：Uid 扩展应用本地化资源，如下所示：

<Button Content="Home" AccessKey="H" x:Uid="HomeButton" />

每个语言的资源将添加到project中的相应字符串文件夹：

英语和西班牙语资源字符串文件夹

本地化的访问密钥在项目的 resources.resw 文件中指定：

指定 resources.resw 文件中指定的 AccessKey 属性

有关详细信息，请参阅 翻译 UI 资源

键提示定位

键提示显示为相对于其相应 UI 元素的浮动徽标，并考虑到其他 UI 元素、其他快捷键提示和屏幕边缘的位置。

通常，默认键提示位置已足够，并且为自适应 UI 提供内置支持。

自动键提示放置示例

但是，如果您需要对键提示定位进行更多的控制，我们建议执行如下操作：

1. 明显的关联原则：用户可以轻松地将控件与键提示相关联。

   a。 键提示应靠近具有访问键（所有者）的元素。
   b. 键提示应避免覆盖具有访问键的已启用元素。
   c. 如果无法将键提示放置在其所有者附近，则它应与所有者重叠。 

2. 可发现性：用户可以使用键提示快速发现控件。

   a。 键提示绝不能与其他键提示重叠。  

3. 轻松扫描： 用户可以快速略读键提示。

   a。 键提示应彼此对齐，并与 UI 元素对齐。 b. 键提示应尽可能多地分组。 

相对位置

使用 KeyTipPlacementMode 属性自定义每个元素或每个组的键提示的位置。

放置模式包括：上、下、右、左、隐藏、居中和自动。

键提示放置模式

控件的中心线用于计算键提示的水平和垂直对齐方式。

以下示例演示如何使用 StackPanel 容器的 KeyTipPlacementMode 属性设置一组控件的键提示位置。

<StackPanel Background="{ThemeResource ApplicationPageBackgroundThemeBrush}" KeyTipPlacementMode="Top">
  <Button Content="File" AccessKey="F" />
  <Button Content="Home" AccessKey="H" />
  <Button Content="Insert" AccessKey="N" />
</StackPanel>

偏移

通过使用元素的 KeyTipHorizontalOffset 和 KeyTipVerticalOffset 属性，可以更精细地控制键提示的位置。

KeyTipHorizontalOffset 属性用于指示键提示向左或向右移动的距离。

设置按钮的垂直和水平键提示偏移量

<Button
  Content="File"
  AccessKey="F"
  KeyTipPlacementMode="Bottom"
  KeyTipHorizontalOffset="20"
  KeyTipVerticalOffset="-8" />

屏幕边缘对齐 {#screen-edge-alignment .ListParagraph}

键提示的位置会根据屏幕边缘自动调整，以确保键提示完全可见。 发生这种情况时，控件与键提示标记对齐点之间的距离可能会与水平和垂直偏移量所指定的值有所不同。

键提示根据屏幕边缘自动定位

键提示样式

建议对平台主题（包括高对比度）使用内置键提示支持。

如果需要指定自己的键提示样式，请使用应用程序资源，例如 KeyTipFontSize（字号）、KeyTipFontFamily（字体系列）、KeyTipBackground（背景）、KeyTipForeground（前台）、KeyTipPadding（填充）、KeyTipBorderBrush（边框颜色）和 KeyTipBorderThemeThickness（边框粗细）。

键提示自定义选项

此示例演示如何更改这些应用程序资源：

<Application.Resources>
 <SolidColorBrush Color="DarkGray" x:Key="MyBackgroundColor" />
 <SolidColorBrush Color="White" x:Key="MyForegroundColor" />
 <SolidColorBrush Color="Black" x:Key="MyBorderColor" />
 <StaticResource x:Key="KeyTipBackground" ResourceKey="MyBackgroundColor" />
 <StaticResource x:Key="KeyTipForeground" ResourceKey="MyForegroundColor" />
 <StaticResource x:Key="KeyTipBorderBrush" ResourceKey="MyBorderColor"/>
 <FontFamily x:Key="KeyTipFontFamily">Consolas</FontFamily>
 <x:Double x:Key="KeyTipContentThemeFontSize">18</x:Double>
 <Thickness x:Key="KeyTipBorderThemeThickness">2</Thickness>
 <Thickness x:Key="KeyTipThemePadding">4,4,4,4</Thickness>
</Application.Resources>

快速访问键和旁白

XAML 框架公开自动化属性，使UI 自动化客户端能够发现有关用户界面中的元素的信息。

如果在 UIElement 或 TextElement 控件上指定 AccessKey 属性，则可以使用 AutomationProperties.AccessKey 属性获取此值。 每次元素获得焦点时，辅助功能客户端（如讲述人）都会读取此属性的值。

相关文章

• 键盘交互
• 键盘快捷键

示例

• WinUI 3 展示