AppBarButton.KeyboardAcceleratorTextOverride Properti

Definisi

Ruang nama:

Microsoft.UI.Xaml.Controls

Mendapatkan atau mengatur string yang mengambil alih string kombinasi tombol default yang terkait dengan akselerator keyboard.

Contoh menu yang memperlihatkan akselerator keyboard untuk berbagai item 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

Nilai Properti

String

Platform::String

winrt::hstring

String untuk mengganti string kombinasi kunci default. Standarnya adalah null.

Gunakan spasi tunggal tanpa teks.

Keterangan

Windows 10, versi 1703, memperkenalkan pintasan akselerator keyboard. Namun, pintasan ini tidak ditampilkan dengan UI kontrol yang sesuai.

Dimulai dengan Windows 10, versi 1803, saat KeyboardAccelerators dideklarasikan, kontrol menampilkan kombinasi tombol yang sesuai secara default.

Teks penimpaan tidak disajikan jika sistem tidak dapat mendeteksi keyboard yang terpasang (Anda dapat memeriksanya sendiri melalui properti KeyboardPresent ).

Kompatibilitas versi

Properti KeyboardAcceleratorTextOverride tidak tersedia sebelum Windows 10, versi 1803. Jika pengaturan 'versi platform minimum' aplikasi Anda di Microsoft Visual Studio kurang dari 'versi yang diperkenalkan' yang ditunjukkan di blok Persyaratan nanti di halaman ini, Anda harus merancang dan menguji aplikasi Anda untuk mempertanyakan hal ini. Untuk informasi selengkapnya, lihat Kode adaptif versi.

Untuk menghindari pengecualian saat aplikasi Anda berjalan pada versi Windows 10 sebelumnya, jangan atur properti ini di XAML atau gunakan tanpa melakukan pemeriksaan runtime. Contoh ini menunjukkan cara menggunakan kelas ApiInformation untuk memeriksa keberadaan properti ini sebelum Anda mengaturnya.

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

Lihat juga

• Akselerator Keyboard