Claves de acceso

Las teclas de acceso son métodos abreviados de teclado que mejoran la facilidad de uso y la accesibilidad de las aplicaciones de Windows al proporcionar una manera intuitiva de que los usuarios naveguen e interactúen rápidamente con la interfaz de usuario visible de una aplicación a través de un teclado en lugar de un dispositivo de puntero (como la entrada táctil o el mouse).

La aplicación de Windows proporciona compatibilidad integrada entre los controles de plataforma para las teclas de acceso basadas en teclado y los comentarios de la interfaz de usuario asociados a través de indicaciones visuales denominadas keytips.

Nota

Un teclado es indispensable para los usuarios con ciertas discapacidades (consulte Accesibilidad del teclado) y también es una herramienta importante para los usuarios que lo prefieren como una manera más eficaz de interactuar con una aplicación.

Consulte el tema Teclas de aceleración para obtener más información sobre cómo invocar acciones comunes en una aplicación de Windows con métodos abreviados de teclado.

Para crear sus propios métodos abreviados de teclado personalizados, consulte el tema Eventos de teclado.

Información general

Una tecla de acceso es una combinación de la tecla Alt y una o varias teclas alfanuméricas (a veces denominadas mnemonic), que normalmente se presionan secuencialmente, en lugar de simultáneamente.

Las información sobre claves son distintivos que se muestran junto a controles que admiten las teclas de acceso cuando el usuario presiona la tecla Alt. Cada información sobre claves contiene las claves alfanuméricas que activan el control asociado.

Nota

Los métodos abreviados de teclado se admiten automáticamente para las teclas de acceso con un solo carácter alfanumérico. Por ejemplo, al presionar simultáneamente Alt+F en Word, se abre el menú Archivo sin mostrar información sobre teclas.

Al presionar la tecla Alt se inicializa la funcionalidad de la clave de acceso y se muestran todas las combinaciones de teclas disponibles actualmente en la información sobre teclas. Las pulsaciones de teclas posteriores se controlan mediante el marco de claves de acceso, que rechaza las teclas no válidas hasta que se presiona una tecla de acceso válida, o bien se presionan las teclas Entrar, Esc, Tab o Flecha para desactivar las teclas de acceso y devolver el control de pulsaciones de teclas a la aplicación.

Las aplicaciones de Microsoft Office proporcionan una amplia compatibilidad con las claves de acceso. En la imagen siguiente se muestra la pestaña Inicio de Word con las teclas de acceso activadas (tenga en cuenta la compatibilidad con números y varias pulsaciones de tecla).

Keytip badges for access keys in Microsoft Word

Distintivos de información sobre claves de acceso en Microsoft Word

Para agregar una clave de acceso a un control, use la propiedad AccessKey. El valor de esta propiedad especifica la secuencia de teclas de acceso, el acceso directo (si es un solo alfanumérico) y la información sobre claves.

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

Cuándo usar las claves de acceso

Se recomienda especificar las claves de acceso siempre que corresponda en la interfaz de usuario y admitir las claves de acceso en todos los controles personalizados.

  1. Las teclas de acceso hacen que la aplicación sea más accesible para los usuarios con discapacidades motoras, incluidos aquellos usuarios que solo pueden presionar una tecla a la vez o tener dificultades para usar un mouse.

    Una interfaz de usuario de teclado bien diseñada es un aspecto importante de la accesibilidad de software. Permite a los usuarios con discapacidades visuales o que tengan ciertas discapacidades motoras para navegar por una aplicación e interactuar con sus características. Es posible que estos usuarios no puedan operar un mouse y, en su lugar, confiar en diversas tecnologías de asistencia, como herramientas de mejora de teclado, teclados en pantalla, agrandadores de pantalla, lectores de pantalla y utilidades de entrada de voz. Para estos usuarios, la cobertura completa de comandos es fundamental.

  2. Las teclas de acceso hacen que la aplicación sea más utilizable para los usuarios avanzados que prefieren interactuar a través del teclado.

    Los usuarios experimentados suelen tener una gran preferencia por usar el teclado, ya que los comandos basados en teclado se pueden escribir más rápidamente y no requieren que quiten sus manos del teclado. Para estos usuarios, la eficiencia y la coherencia son cruciales; la integralidad solo es importante para los comandos usados con más frecuencia.

Establecimiento del ámbito de la clave de acceso

Cuando hay muchos elementos en la pantalla que admiten claves de acceso, se recomienda determinar el ámbito de las claves de acceso para reducir la carga cognitiva. Esto minimiza el número de teclas de acceso en la pantalla, lo que facilita la localización y mejora la eficiencia y la productividad.

Por ejemplo, Microsoft Word proporciona dos ámbitos de clave de acceso: un ámbito principal para las pestañas de la cinta de opciones y un ámbito secundario para los comandos de la pestaña seleccionada.

En las imágenes siguientes se muestran los dos ámbitos de clave de acceso en Word. En la primera se muestran las claves de acceso principales que permiten a un usuario seleccionar una pestaña y otros comandos de nivel superior, y el segundo muestra las claves de acceso secundarias para la pestaña Inicio.

Primary access keys in Microsoft WordClaves de acceso principales en Microsoft Word

Secondary access keys in Microsoft WordClaves de acceso secundarias en Microsoft Word

Las claves de acceso se pueden duplicar para los elementos de distintos ámbitos. En el ejemplo anterior, "2" es la clave de acceso para Deshacer en el ámbito principal y también "Cursiva" en el ámbito secundario.

Aquí se muestra cómo definir un ámbito de clave de acceso.

<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>

Primary access keys for CommandBar

Ámbito principal de CommandBar y claves de acceso admitidas

Secondary access keys for CommandBar

Ámbito secundario de CommandBar y claves de acceso admitidas

Windows 10 Creators Update y versiones anteriores

Antes de Windows 10 Fall Creators Update, algunos controles, como CommandBar, no admitieron ámbitos de clave de acceso integrados.

En el ejemplo siguiente se muestra cómo admitir CommandBar SecondaryCommands con claves de acceso, que están disponibles una vez que se invoca un comando primario (similar a la cinta de opciones de Word).

<local:CommandBarHack 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>
</local:CommandBarHack>
public class CommandBarHack : CommandBar
{
    CommandBarOverflowPresenter secondaryItemsControl;
    Popup overflowPopup;

    public CommandBarHack()
    {
        this.ExitDisplayModeOnAccessKeyInvoked = false;
        AccessKeyInvoked += OnAccessKeyInvoked;
    }

    protected override void OnApplyTemplate()
    {
        base.OnApplyTemplate();

        Button moreButton = GetTemplateChild("MoreButton") as Button;
        moreButton.SetValue(Control.IsTemplateKeyTipTargetProperty, true);
        moreButton.IsAccessKeyScope = true;

        // SecondaryItemsControl changes
        secondaryItemsControl = GetTemplateChild("SecondaryItemsControl") as CommandBarOverflowPresenter;
        secondaryItemsControl.AccessKeyScopeOwner = moreButton;

        overflowPopup = GetTemplateChild("OverflowPopup") as Popup;
    }

    private void OnAccessKeyInvoked(UIElement sender, AccessKeyInvokedEventArgs args)
    {
        if (overflowPopup != null)
        {
            overflowPopup.Opened += SecondaryMenuOpened;
        }
    }

    private void SecondaryMenuOpened(object sender, object e)
    {
        //This is not necessary given we are automatically pushing the scope.
        var item = secondaryItemsControl.Items.First();
        if (item != null && item is Control)
        {
            (item as Control).Focus(FocusState.Keyboard);
        }
        overflowPopup.Opened -= SecondaryMenuOpened;
    }
}

Evitar colisiones de teclas de acceso

Las colisiones de teclas de acceso se producen cuando dos o más elementos del mismo ámbito tienen claves de acceso duplicadas o comienzan con los mismos caracteres alfanuméricos.

El sistema resuelve las claves de acceso duplicadas mediante el procesamiento de la clave de acceso del primer elemento agregado al árbol visual, ignorando todos los demás.

Cuando varias teclas de acceso comienzan con el mismo carácter (por ejemplo, "A", "A1" y "AB"), el sistema procesa la clave de acceso de un solo carácter y omite todos los demás.

Evite colisiones mediante claves de acceso únicas o comandos de ámbito.

Elegir claves de acceso

Tenga en cuenta lo siguiente al elegir las claves de acceso:

  • Use un solo carácter para minimizar las pulsaciones de tecla y admitir teclas de aceleración de forma predeterminada (Alt+AccessKey)
  • Evite usar más de dos caracteres
  • Evitar colisiones de teclas de acceso
  • Evite caracteres difíciles de diferenciar de otros caracteres, como la letra "I" y el número "1" o la letra "O" y el número "0".
  • Use precedentes conocidos de otras aplicaciones populares, como Word ("F" para "Archivo", "H" para "Inicio", etc.)
  • Use el primer carácter del nombre del comando o un carácter con una asociación cercana al comando que ayuda con la recuperación.
    • Si la primera letra ya está asignada, use una letra lo más cercana posible a la primera letra del nombre de comando ("N" para Insertar)
    • Usar un consonante distintivo del nombre de comando ("W" para la vista)
    • Use una vocal del nombre del comando.

Localizar claves de acceso

Si la aplicación se va a localizar en varios idiomas, también debe considerar la posibilidad de localizar las claves de acceso. Por ejemplo, para "H" para "Home" en-US y "I" para "Incio" en es-ES.

Use la extensión x:Uid en el marcado para aplicar recursos localizados como se muestra aquí:

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

Los recursos de cada idioma se agregan a las carpetas string correspondientes del proyecto:

English and Spanish resource string folders

Carpetas de cadenas de recursos en inglés y español

Las claves de acceso localizadas se especifican en el archivo resources.resw de los proyectos:

Specify the AccessKey property specified in the resources.resw file

Especifique la propiedad AccessKey especificada en el archivo resources.resw.

Para obtener más información, consulte Traducción de recursos de interfaz de usuario.

Posicionamiento de información sobre claves

Las información sobre claves se muestran como distintivos flotantes en relación con su elemento de interfaz de usuario correspondiente, teniendo en cuenta la presencia de otros elementos de la interfaz de usuario, otras información sobre claves y el borde de la pantalla.

Normalmente, la ubicación predeterminada de la información sobre claves es suficiente y proporciona compatibilidad integrada con la interfaz de usuario adaptable.

Example of automatic keytip placement

Ejemplo de selección automática de ubicación de la información sobre claves

Sin embargo, si necesita más control sobre el posicionamiento de la información sobre claves, se recomienda lo siguiente:

  1. Principio de asociación obvio: el usuario puede asociar fácilmente el control a la información sobre claves.

    a. La información sobre claves debe estar cerca del elemento que tiene la clave de acceso (el propietario).
    b. La información sobre claves debe evitar cubrir los elementos habilitados que tienen claves de acceso.
    c. Si no se puede colocar una información sobre claves cerca de su propietario, debe superponerse al propietario. 

  2. Detectabilidad: el usuario puede detectar rápidamente el control con la información sobre claves.

    a. La información sobre claves nunca se superpone a otra información sobre claves.  

  3. Escaneo fácil: el usuario puede esquiar la información sobre teclas fácilmente.

    a. keytips debe alinearse entre sí y con el elemento de la interfaz de usuario. b. La información sobre claves debe agruparse tanto como sea posible. 

Posición relativa

Utilice la propiedad KeyTipPlacementMode para personalizar la ubicación de la información sobre claves por elemento o por grupo.

Los modos de selección de ubicación son: Top, Bottom, Right, Left, Hidden, Center y Auto.

Screenshot showing the relative positions of the keytip placement modes

modos de selección de ubicación de la información sobre claves

La línea central del control se usa para calcular la alineación vertical y horizontal de la información sobre claves.

En el ejemplo siguiente se muestra cómo establecer la ubicación de la información sobre claves de un grupo de controles mediante la propiedad KeyTipPlacementMode de un contenedor StackPanel.

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

desplazamientos

Use las propiedades KeyTipHorizontalOffset y KeyTipVerticalOffset de un elemento para un control aún más granular de la ubicación de la información sobre claves.

Nota

Los desplazamientos no se pueden establecer cuando KeyTipPlacementMode está establecido en Automático.

La propiedad KeyTipHorizontalOffset indica hasta qué punto se mueve la información sobre claves a la izquierda o a la derecha.

Screenshot of vertical and horizontal keytip offsets for a button

Establecer desplazamientos de información sobre teclas verticales y horizontales para un botón

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

Alineación del borde de la pantalla {#screen-edge-alignment . ListParagraph}

La ubicación de una información sobre claves se ajusta automáticamente en función del borde de la pantalla para asegurarse de que la información sobre claves esté totalmente visible. Cuando esto ocurre, la distancia entre el control y el punto de alineación de información clave puede diferir de los valores especificados para los desplazamientos horizontales y verticales.

Screenshot of keytip screen edge alignment

La información sobre claves se coloca automáticamente en función del borde de la pantalla.

Estilo de información sobre claves

Se recomienda usar la compatibilidad de la información clave integrada con temas de plataforma, incluido el contraste alto.

Si necesita especificar sus propios estilos de información sobre claves, use recursos de aplicación como KeyTipFontSize (tamaño de fuente), KeyTipFontFamily (familia de fuentes), KeyTipBackground (fondo), KeyTipForeground (primer plano), KeyTipPadding (relleno), KeyTipBorderBrush(color de borde) y KeyTipBorderThemeThickness (grosor del borde).

Screenshot of keytip customization options, including font, order, and color

opciones de personalización de keytip

En este ejemplo se muestra cómo cambiar estos recursos de aplicación:

<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>

Claves de acceso y Narrador

El marco XAML expone las propiedades de automatización que permiten a los clientes de automatización de la interfaz de usuario detectar información sobre los elementos de la interfaz de usuario.

Si especifica la propiedad AccessKey en un control UIElement o TextElement, puede usar la propiedad AutomationProperties.AccessKey para obtener este valor. Los clientes de accesibilidad, como Narrador, leen el valor de esta propiedad cada vez que un elemento obtiene el foco.

Muestras