AppBarButton.KeyboardAcceleratorTextOverride Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen einer Zeichenfolge, die die standardtastenkombinationszeichenfolge überschreibt, die einer Zugriffstaste zugeordnet ist.
Beispiel für ein Menü mit Zugriffstasten 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 = appBarButton.keyboardAcceleratorTextOverride;
appBarButton.keyboardAcceleratorTextOverride = string;Public Property KeyboardAcceleratorTextOverride As StringEigenschaftswert
Die Zeichenfolge, die die Standardtastenkombinationszeichenfolge ersetzt. Der Standardwert ist NULL.
Verwenden Sie ein einzelnes Leerzeichen ohne Text.
Hinweise
Windows 10, Version 1703, wurden Tastenkombinationen eingeführt. Diese Tastenkombinationen wurden jedoch nicht mit der Benutzeroberfläche ihrer entsprechenden Steuerelemente angezeigt.
Ab Windows 10, Version 1803, zeigen Steuerelemente standardmäßig die entsprechenden Tastenkombinationen an, wenn KeyboardAccelerators deklariert werden.
Der Außerkraftsetzungstext wird nicht angezeigt, wenn das System keine angeschlossene Tastatur 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 als die im Anforderungsblock weiter unten auf dieser Seite angezeigte "Eingeführte Version" ist, müssen Sie Ihre App entwerfen und testen, um dies zu berücksichtigen. Weitere Informationen finden Sie unter versionsadaptiven Code.
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 Laufzeitüberprüfung durchzuführen. In diesem Beispiel wird gezeigt, wie Sie mithilfe der ApiInformation-Klasse überprüfen, ob diese Eigenschaft vorhanden ist, bevor Sie sie festlegen.
<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";
}
}