MessageDialog.CancelCommandIndex Properti

Definisi

Ruang nama:

Windows.UI.Popups

Mendapatkan atau mengatur indeks perintah yang ingin Anda gunakan sebagai perintah batalkan. Ini adalah perintah yang diaktifkan saat pengguna menekan tombol ESC.

Tambahkan perintah sebelum Anda mengatur indeks.

public:
 property unsigned int CancelCommandIndex { unsigned int get(); void set(unsigned int value); };

uint32_t CancelCommandIndex();

void CancelCommandIndex(uint32_t value);

public uint CancelCommandIndex { get; set; }

var uInt32 = messageDialog.cancelCommandIndex;
messageDialog.cancelCommandIndex = uInt32;

Public Property CancelCommandIndex As UInteger

Nilai Properti

UInt32

unsigned int

uint32_t

Indeks perintah batalkan.

Keterangan

Gunakan dialog pesan untuk mengirim pesan dan pertanyaan penting atau pemblokiran dari aplikasi.

Nilai

Waktu menggunakan

≥ 0

Dialog ini menawarkan pilihan default yang aman yang setara dengan pembatalan, seperti "Batal" atau "Tutup." Atur CancelCommandIndex ke indeks handler perintah untuk perintah batalkan/tutup tersebut, sehingga ketika pengguna menutup dialog melalui tindakan nonkomital, seperti menekan ESC, API mengembalikan handler perintah yang Anda inginkan. Catatan Umumnya, Anda harus menghindari pembuatan dialog yang dapat diberhentikan dengan cara ini dan peluncuran ulang mengajukan pertanyaan yang sama atau mengirim pesan yang sama lagi dan lagi. Mereka membuat aplikasi berisik dan cenderung mengganggu pengguna.

-1Pengguna diharuskan untuk membuat keputusan eksplisit seperti mengetuk tombol tertentu pada dialog. Ini memastikan bahwa pengguna tidak dapat menutup dialog melalui tindakan non-komital seperti menekan ESC. -2**Tidak disarankan**. Dialog tidak diberhentikan ketika pengguna menekan ESC atau selama aktivasi kontrak masuk; namun, jika aplikasi menggunakan kembali jendela aplikasi utama saat menanggapi aktivasi masuk, penangan perintah dialog tidak akan valid lagi. Karena API tidak menangani perilaku ini, sebaiknya jangan gunakan nilai ini.

Penanganan kesalahan saat pemecatan oleh aktivasi kontrakJika aplikasi menerima aktivasi kontrak masuk (seperti dari Pencarian, Berbagi, Pengaturan, Perangkat, atau kontrak pemilih file) saat dialog ditampilkan, dialog ditutup secara terprogram, terlepas dari nilai properti yang telah ditetapkan untuk CancelCommandIndex.

Untuk membantu Anda menangani kasus ini, API mengembalikan handler perintah dummy. Anda, kemudian, dapat memutuskan cara menangani dan bereaksi terhadap kesalahan.