ContentDialog.DefaultButton Properti

Definisi

Ruang nama:

Windows.UI.Xaml.Controls

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

ContentDialogButton

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