AppBarButton.KeyboardAcceleratorTextOverride Propiedad

Definición

Obtiene o establece una cadena que invalida la cadena de combinación de teclas predeterminada asociada a un acelerador de teclado.

Ejemplo de un menú que muestra aceleradores de teclado para varios elementos de menú
Ejemplo de un menú que muestra aceleradores de teclado para varios elementos de menú

public:
 property Platform::String ^ KeyboardAcceleratorTextOverride { Platform::String ^ get(); void set(Platform::String ^ value); };
winrt::hstring KeyboardAcceleratorTextOverride();

void KeyboardAcceleratorTextOverride(winrt::hstring value);
public string KeyboardAcceleratorTextOverride { get; set; }
var string = appBarButton.keyboardAcceleratorTextOverride;
appBarButton.keyboardAcceleratorTextOverride = string;
Public Property KeyboardAcceleratorTextOverride As String

Valor de propiedad

String

Platform::String

winrt::hstring

Cadena que se va a reemplazar la cadena de combinación de teclas predeterminada. El valor predeterminado es null.

Use un solo espacio para ningún texto.

Requisitos de Windows

Familia de dispositivos
Windows 10, version 1803 (se introdujo en la versión 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v6.0)

Comentarios

Windows 10, versión 1703, introdujo métodos abreviados de acelerador de teclado . Sin embargo, estos accesos directos no se mostraron con la interfaz de usuario de sus controles correspondientes.

A partir de Windows 10, versión 1803, cuando se declaran los keyboardAccelerators , los controles muestran las combinaciones de teclas correspondientes de forma predeterminada.

El texto de invalidación no se presenta si el sistema no puede detectar un teclado adjunto (puede comprobarlo usted mismo a través de la propiedad KeyboardPresent ).

Compatibilidad de versiones

La propiedad KeyboardAcceleratorTextOverride no está disponible antes de Windows 10, versión 1803. Si la configuración "versión mínima de la plataforma" de la aplicación en Microsoft Visual Studio es menor que la "versión introducida" que se muestra en el bloque Requisitos más adelante en esta página, debe diseñar y probar la aplicación para que tenga en cuenta esto. Para obtener más información, consulta Código adaptable de versión.

Para evitar excepciones cuando la aplicación se ejecute en versiones anteriores de Windows 10, no establezca esta propiedad en XAML ni úsela sin realizar una comprobación en tiempo de ejecución. En este ejemplo se muestra cómo usar la clase ApiInformation para comprobar la presencia de esta propiedad antes de establecerla.

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
    <AppBarButton x:Name="appBarButtonCut" Icon="Cut" Label="Cut"/>
</CommandBar>
private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBarButton", "KeyboardAcceleratorTextOverride"))
    {
        appBarButtonCut.KeyboardAcceleratorTextOverride = "Ctrl+C";
    }
}

Se aplica a

Consulte también