ContentDialog.CloseButtonText Properti

Definisi

Ruang nama:

Windows.UI.Xaml.Controls

Mendapatkan atau mengatur teks untuk ditampilkan pada tombol tutup.

public:
 property Platform::String ^ CloseButtonText { Platform::String ^ get(); void set(Platform::String ^ value); };

winrt::hstring CloseButtonText();

void CloseButtonText(winrt::hstring value);

public string CloseButtonText { get; set; }

var string = contentDialog.closeButtonText;
contentDialog.closeButtonText = string;

Public Property CloseButtonText As String

<ContentDialog CloseButtonText="string"/>

Nilai Properti

String

Platform::String

winrt::hstring

Teks yang akan ditampilkan pada tombol tutup.

Persyaratan Windows

Rangkaian perangkat	Windows 10 Creators Update (diperkenalkan dalam 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v4.0)

Keterangan

Setiap dialog harus berisi tombol tindakan yang aman dan tidak merusak yang memungkinkan pengguna untuk keluar dari dialog dengan percaya diri.

Gunakan tombol tutup untuk membuat tombol ini. Ini memungkinkan Anda untuk menciptakan pengalaman pengguna yang tepat untuk semua input termasuk mouse, keyboard, sentuhan, dan gamepad. Dialog akan ditutup ketika:

• Pengguna mengklik atau mengetuk tombol tutup
• Pengguna menekan tombol kembali sistem
• Pengguna menekan tombol ESC pada keyboard
• Pengguna menekan Gamepad B

Memanggil tombol tutup mengembalikan ContentDialogResult.None.

Kompatibilitas versi

Properti CloseButtonText tidak tersedia sebelum Windows 10, versi 1703. Jika pengaturan 'versi platform minimum' aplikasi Anda di Microsoft Visual Studio kurang dari 'versi yang diperkenalkan' yang ditampilkan di blok Persyaratan nanti di halaman ini, Anda harus menggunakan properti SecondaryButtonText sebagai gantinya. 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", "CloseButtonText"))
    {
        contentDialog1.CloseButtonText = "Cancel";
    }
    else
    {
        contentDialog1.SecondaryButtonText = "Cancel";
    }
}