MenuFlyoutItem.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 = menuFlyoutItem.keyboardAcceleratorTextOverride;
menuFlyoutItem.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">
    <AppBarToggleButton x:Name="appBarButtonShuffle" Icon="Shuffle" Label="Shuffle"/>
</CommandBar>


<Button Content="Button Flyout">
   <Button.Flyout>
      <MenuFlyout>
         <MenuFlyoutItem x:Name="menuFlyoutItemExample" Text="Item 1" />
         <MenuFlyoutItem Text="Item 2" />
         <MenuFlyoutSeparator />
         <MenuFlyoutSubItem Text="Item 3">
            <MenuFlyoutItem Text="Item 4" />
            <MenuFlyoutSubItem Text="Item 5">
               <MenuFlyoutItem Text="Item 6" />
               <MenuFlyoutItem Text="Item 7" />
            </MenuFlyoutSubItem>
         </MenuFlyoutSubItem>
         <MenuFlyoutSeparator />
         <ToggleMenuFlyoutItem Text="Toggle Menu Item 1" />
      </MenuFlyout>
   </Button.Flyout>
</Button>

private void Button_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.MenuFlyoutItem", "KeyboardAcceleratorTextOverride"))
    {
        menuFlyoutItemExample.KeyboardAcceleratorTextOverride = "Ctrl+S";
    }
}

Confira também

• Aceleradores de teclado