teclas de acceso

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 para que los usuarios naveguen e interactúen rápidamente con la interfaz de usuario visible de una aplicación utilizando el teclado en lugar de un dispositivo apuntador (como la entrada táctil o el mouse).

La aplicación de Windows proporciona compatibilidad integrada en los controles de la plataforma para las teclas de acceso basadas en teclado y los comentarios de la interfaz de usuario asociados a través de pistas visuales conocidas como "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 access es una combinación de la tecla Alt y una o varias teclas alfanuméricas(a veces denominadas mnemonic) normalmente presionadas secuencialmente, en lugar de simultáneamente.

Las Keytips son distintivos que se muestran junto a los controles que admiten teclas de acceso cuando se presiona la tecla Alt. Cada sugerencia de tecla contiene las teclas alfanuméricas que activan el control asociado.

Nota:

Los métodos abreviados de teclado se admiten automáticamente para teclas de acceso con un único 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 tecla de acceso y se muestran todas las combinaciones de teclas actualmente disponibles en los consejos de teclas. Las pulsaciones de teclas posteriores se gestionan mediante el sistema de teclas 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 Intro, Esc, Tab o de Flecha para desactivar las teclas de acceso y devolver el control de las pulsaciones a la aplicación.

Las aplicaciones de Microsoft Office proporcionan un amplio soporte para las claves de acceso. En la imagen siguiente se muestra la pestaña Inicio de Word con teclas de acceso activadas (observe la compatibilidad con números y varias combinaciones de teclas).

Insignias KeyTip para teclas de acceso en Microsoft Word

Para agregar una clave access 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 guía para teclas.

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

Cuándo usar claves de acceso

Recomendamos que especifique teclas de acceso siempre que corresponda en la interfaz de usuario y admita teclas de acceso en todos los controles personalizados.

1. Teclas de acceso hacen que tu 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 tienen dificultades para usar un ratón.

   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. Teclas de acceso hacen que la aplicación sea más fácil de usar 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.

Establecer el ámbito de clave de acceso

Cuando hay muchos elementos en la pantalla que admiten claves de acceso, se recomienda establecer el ámbito de las claves de acceso para reducir la carga cognitiva. Esto minimiza el número de claves de acceso en la pantalla, facilitando su 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 siguientes imágenes se muestran los dos ámbitos de clave de acceso en Word. En la primera se muestran las claves de access principales que permiten a un usuario seleccionar una pestaña y otros comandos de nivel superior, y el segundo muestra las claves de access secundarias para la pestaña Inicio.

Claves de acceso primarias de Microsoft Word

Teclas de acceso secundario en Microsoft Word

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

Aquí mostramos cómo definir un ámbito para una 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>

Ámbito principal de CommandBar y claves de acceso admitidas

claves de acceso secundario para

Ámbito secundario de CommandBar y teclas de acceso admitidas

Evitar colisiones de claves de acceso

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

El sistema resuelve las claves de acceso duplicadas procesando la clave de acceso del primer elemento agregado al árbol visual, ignorando todas las demás.

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

Evite colisiones mediante teclas de acceso únicas o limitando el alcance de los comandos.

Elegir claves de acceso

Tenga en cuenta lo siguiente al elegir 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 claves 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 una consonante distintiva del nombre de comando ("W" para Vista)
  • Use una vocal del nombre del comando.

Localizar claves de acceso

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

Utiliza la extensión x:Uid en el código de marcado para aplicar recursos localizados como se muestra aquí abajo:

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

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

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

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

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 sugerencia de tecla

La sugerencias de teclas 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 sugerencias de teclas 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.

Ejemplo de colocación automática de keytips

Sin embargo, si necesita más control sobre el posicionamiento de la sugerencia de tecla, recomendamos lo siguiente:

1. Principio de asociación obvio: el usuario puede asociar fácilmente el control a la sugerencia de tecla.

   a) La información sobre claves debe estar cerca de al elemento que tiene la clave de acceso (el propietario).
   b. La información sobre las teclas debe evitar cubrir los elementos habilitados que tengan teclas 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 descubrir rápidamente el control con la sugerencia de tecla.

   a) La sugerencia de tecla nunca se superpone con otra sugerencia de tecla.  

3. Fácil escaneo: El usuario puede ojear los consejos de teclas fácilmente.

   a) keytips deben alinearse entre sí y con el elemento de la UI. b. "Los keytips deben agruparse tanto como sea posible." 

Posición relativa

Utilice la propiedad KeyTipPlacementMode para personalizar la colocación del indicador de tecla por elemento o por grupo.

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

modos de colocación de etiquetas de tecla

La línea central del control se utiliza para calcular la alineación vertical y horizontal del keytip.

En el ejemplo siguiente se muestra cómo establecer la ubicación de las teclas de un grupo de controles usando 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>

Compensaciones

Utilice las propiedades KeyTipHorizontalOffset y KeyTipVerticalOffset de un elemento para un control aún más granular de la ubicación del keytip.

Nota:

Los desplazamientos no se pueden establecer cuando KeyTipPlacementMode está configurado en automático.

La propiedad KeyTipHorizontalOffset indica cuán lejos mover la información de tecla a la izquierda o a la derecha.

Establecer desplazamientos verticales y horizontales de la etiqueta de teclas 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 punta de tecla se ajusta automáticamente en función del borde de la pantalla para asegurar que la punta de tecla esté totalmente visible. Cuando esto ocurre, la distancia entre el control y el punto de alineación de la clave puede diferir de los valores especificados para los ajustes horizontales y verticales.

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

Estilo de indicaciones de teclas

Se recomienda usar el soporte de keytips integrado en los temas de la plataforma, incluido el alto contraste.

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

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>

Teclas de acceso y Narrador

El marco XAML expone las propiedades de automatización que permiten a los clientes de UI Automation 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.

Artículos relacionados

• Interacciones de teclado
• Aceleradores de teclado

Muestras

• galería de WinUI 3