AppBarToggleButton.KeyboardAcceleratorTextOverride Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 = appBarToggleButton.keyboardAcceleratorTextOverride;
appBarToggleButton.keyboardAcceleratorTextOverride = string;Public Property KeyboardAcceleratorTextOverride As StringValore della proprietà
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">
<AppBarToggleButton x:Name="appBarButtonShuffle" Icon="Shuffle" Label="Shuffle"/>
</CommandBar>
private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBarToggleButton", "KeyboardAcceleratorTextOverride"))
{
appBarButtonCut.KeyboardAcceleratorTextOverride = "Ctrl+S";
}
}