AppBarButton.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 acceleratore di tastiera.
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 StringValore della proprietà
Stringa da sostituire la stringa di combinazione di chiavi predefinita. Il valore predefinito è Null.
Usare uno spazio singolo per nessun testo.
Requisiti Windows
| Famiglia di dispositivi |
Windows 10, version 1803 (è stato introdotto in 10.0.17134.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v6.0)
|
Commenti
Windows 10, versione 1703, ha introdotto i tasti di scelta rapida. Tuttavia, questi collegamenti non sono stati visualizzati con l'interfaccia utente dei relativi controlli corrispondenti.
A partire da Windows 10, versione 1803, quando i tastiAcceleratori vengono dichiarati, i controlli visualizzano le combinazioni di tasti corrispondenti per impostazione predefinita.
Il testo di override non viene presentato se il sistema non riesce a rilevare una tastiera associata (è possibile controllare se stessi 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 è minore della versione "introdotta" visualizzata nel blocco Requisiti più avanti in questa pagina, è necessario progettare e testare l'app per l'account. Per altre informazioni, vedere Codice adattivo della 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. In questo esempio viene illustrato 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";
}
}