Condividi tramite


AppBarButton.KeyboardAcceleratorTextOverride Proprietà

Definizione

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

Si applica a

Vedi anche