MenuFlyoutItem.KeyboardAcceleratorTextOverride Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Controls

Ruft eine Zeichenfolge ab, die die Standard-Tastenkombinationszeichenfolge überschreibt, die einem Tastaturbeschleunigungsbeschleunigung zugeordnet ist, oder legt diese fest.

Beispiel für ein Menü mit Tastaturbeschleunigungen für verschiedene Menüelemente

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

Eigenschaftswert

String

Platform::String

winrt::hstring

Die Zeichenfolge, um die Standard-Tastenkombinationszeichenfolge zu ersetzen. Der Standardwert ist NULL.

Verwenden Sie ein einzelnes Leerzeichen für keinen Text.

Windows-Anforderungen

Gerätefamilie	Windows 10, version 1803 (eingeführt in 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v6.0)

Hinweise

Windows 10 Version 1703 wurden Tastenkombinationen eingeführt. Diese Verknüpfungen wurden jedoch nicht mit der Benutzeroberfläche der entsprechenden Steuerelemente angezeigt.

Ab Windows 10 Version 1803 zeigen Steuerelemente standardmäßig die entsprechenden Tastenkombinationen an, wenn KeyboardAccelerators deklariert werden.

Der Überschreibungstext wird nicht angezeigt, wenn das System eine angefügte Tastatur nicht erkennen kann (Sie können dies selbst über die KeyboardPresent-Eigenschaft überprüfen).

Versionskompatibilität

Die KeyboardAcceleratorTextOverride-Eigenschaft ist vor Windows 10 Version 1803 nicht verfügbar. Wenn die Einstellung "Mindestplattformversion" Ihrer App in Microsoft Visual Studio kleiner ist als die "eingeführte Version", die im Block Anforderungen weiter unten auf dieser Seite angezeigt wird, müssen Sie Ihre App entwerfen und testen, um dies zu berücksichtigen. Weitere Informationen finden Sie unter Adaptiver Versionscode.

Um Ausnahmen zu vermeiden, wenn Ihre App in früheren Versionen von Windows 10 ausgeführt wird, legen Sie diese Eigenschaft nicht in XAML fest, oder verwenden Sie sie nicht, ohne eine Laufzeitprüfung durchzuführen. In diesem Beispiel wird gezeigt, wie Sie die ApiInformation-Klasse verwenden, um zu überprüfen, ob diese Eigenschaft vorhanden ist, bevor Sie sie festlegen.

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

Weitere Informationen

• Tastaturkürzel