AppBarButton.KeyboardAcceleratorTextOverride Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Ottiene o imposta una stringa che esegue l'override della stringa di combinazione di tasti predefinita associata a un tasto di scelta rapida.

Esempio di menu che mostra gli acceleratori di tastiera per varie voci di 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

Valore della proprietà

String

Platform::String

winrt::hstring

Stringa per sostituire la stringa di combinazione di tasti predefinita. Il valore predefinito è Null.

Usare uno spazio singolo per nessun testo.

Commenti

Windows 10, versione 1703, ha introdotto i tasti di scelta rapida. Tuttavia, questi collegamenti non sono stati visualizzati con l'interfaccia utente dei controlli corrispondenti.

A partire da Windows 10 versione 1803, quando vengono dichiarati KeyboardAccelerators, i controlli visualizzano le combinazioni di tasti corrispondenti per impostazione predefinita.

Il testo di override non viene presentato se il sistema non è in grado di rilevare una tastiera collegata (è possibile controllarne manualmente tramite la proprietà KeyboardPresent ).

Compatibilità tra versioni

La proprietà KeyboardAcceleratorTextOverride non è disponibile prima di Windows 10 versione 1803. Se l'impostazione "versione minima della piattaforma" dell'app in Microsoft Visual Studio è inferiore alla "versione introdotta" visualizzata nel blocco Requisiti più avanti in questa pagina, è necessario progettare e testare l'app per tenere conto di questo aspetto. Per altre info, vedi Codice adattivo per la versione.

Per evitare eccezioni quando l'app viene eseguita nelle versioni precedenti di Windows 10, non impostare questa proprietà in XAML o usarla senza eseguire un controllo di runtime. Questo esempio mostra come usare la classe ApiInformation per verificare la presenza di questa proprietà prima di impostarla.

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

Vedi anche

• Tasti di scelta rapida