AppBarButton.KeyboardAcceleratorTextOverride Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Obtém ou define uma cadeia de caracteres que substitui a cadeia de caracteres de combinação de teclas padrão associada a um acelerador de teclado.

Exemplo de um menu mostrando aceleradores de teclado para vários itens de menu

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

String

Platform::String

winrt::hstring

A cadeia de caracteres para substituir a cadeia de caracteres de combinação de teclas padrão. O padrão é nulo.

Use um único espaço para nenhum texto.

Comentários

Windows 10, versão 1703, introduziu atalhos de acelerador de teclado. No entanto, esses atalhos não foram exibidos com a interface do usuário de seus controles correspondentes.

Começando com Windows 10, versão 1803, quando KeyboardAccelerators são declarados, os controles exibem as combinações de teclas correspondentes por padrão.

O texto de substituição não será apresentado se o sistema não conseguir detectar um teclado conectado (você pode verificar isso por conta própria por meio da propriedade KeyboardPresent).

Compatibilidade de versões

A propriedade KeyboardAcceleratorTextOverride não está disponível antes do Windows 10, versão 1803. Se a configuração de "versão mínima da plataforma" do seu aplicativo no Microsoft Visual Studio for menor que a "versão introduzida" mostrada no bloco Requisitos posteriormente nesta página, você deverá projetar e testar seu aplicativo para considerar isso. Para obter mais informações, consulte Código adaptável de versão.

Para evitar exceções quando seu aplicativo é executado em versões anteriores do Windows 10, não defina essa propriedade em XAML nem use-a sem executar um runtime marcar. Este exemplo mostra como usar a classe ApiInformation para marcar para a presença dessa propriedade antes de defini-la.

<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";
    }
}

Confira também

• Aceleradores de teclado