Partilhar via


AppBarButton.KeyboardAcceleratorTextOverride Propriedade

Definição

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

Requisitos do Windows

Família de dispositivos
Windows 10, version 1803 (introduzida na 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v6.0)

Comentários

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

A partir do 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";
    }
}

Aplica-se a

Confira também