ContentDialog.DefaultButton Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur nilai yang menunjukkan tombol mana pada dialog yang merupakan tindakan default.
public:
property ContentDialogButton DefaultButton { ContentDialogButton get(); void set(ContentDialogButton value); };
ContentDialogButton DefaultButton();
void DefaultButton(ContentDialogButton value);
public ContentDialogButton DefaultButton { get; set; }
var contentDialogButton = contentDialog.defaultButton;
contentDialog.defaultButton = contentDialogButton;
Public Property DefaultButton As ContentDialogButton
Nilai Properti
Nilai enumerasi. Defaultnya adalah Tidak Ada.
Persyaratan Windows
Rangkaian perangkat |
Windows 10 Creators Update (diperkenalkan dalam 10.0.15063.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v4.0)
|
Keterangan
Anda dapat secara opsional memilih untuk membedakan salah satu dari tiga tombol sebagai tombol default. Menentukan tombol default menyebabkan hal berikut ini terjadi:
- Tombol menerima perawatan visual Tombol Aksen
- Tombol akan merespons tombol ENTER secara otomatis
- Ketika pengguna menekan tombol ENTER pada keyboard, penangan klik yang terkait dengan tombol default akan diaktifkan dan ContentDialogResult akan mengembalikan nilai yang terkait dengan tombol default
- Jika pengguna telah menempatkan fokus pada kontrol yang menangani ENTER, tombol default tidak akan merespons tekan ENTER
- Tombol akan menerima fokus secara otomatis ketika dialog dibuka kecuali konten dialog berisi UI yang dapat difokuskan
Kompatibilitas versi
Properti DefaultButton tidak tersedia sebelum Windows 10, versi 1703. 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.
<ContentDialog x:Name="contentDialog1" Loaded="ContentDialog_Loaded">
...
</ContentDialog>
private void ContentDialog_Loaded(object sender, RoutedEventArgs e)
{
if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.ContentDialog", "DefaultButton"))
{
contentDialog1.DefaultButton = ContentDialogButton.Primary;
}
}