Bagikan melalui

PropSheet_CancelToClose makro (prsht.h)

  • Artikel

Digunakan saat perubahan yang dilakukan karena pemberitahuan PSN_APPLY terbaru tidak dapat dibatalkan. Anda juga dapat mengirim pesan PSM_CANCELTOCLOSE secara eksplisit.

Sintaks

void PropSheet_CancelToClose(
   hDlg
);

Parameter

hDlg

Jenis: HWND

Tangani ke lembar properti.

Nilai kembali

Tidak ada

Keterangan

PSM_CANCELTOCLOSE menonaktifkan tombol Batalkan dan mengubah teks tombol OK menjadi "Tutup". Anda dapat menggunakan makro ini atau mengirim pesan PSM_CANCELTOCLOSE secara eksplisit.

Sebagian besar lembar properti menunggu untuk melakukan perubahan yang tidak dapat diubah hingga pemberitahuan PSN_APPLY diterima. Namun, dalam beberapa keadaan, lembar properti dapat membuat perubahan yang tidak dapat diubah di luar urutan PSN_APPLY/PSN_RESET standar. Salah satu contohnya adalah lembar properti yang berisi tombol Edit yang digunakan untuk menampilkan kotak subdialog untuk mengedit properti. Saat pengguna mengklik OK untuk mengirimkan perubahan, halaman lembar properti memiliki beberapa opsi:

  • Ini dapat merekam perubahan tetapi menunggu hingga menerima pemberitahuan PSN_APPLY untuk menerapkannya. Ini adalah pendekatan yang disukai.
  • Ini dapat menerapkan perubahan segera setelah keluar dari kotak subdialog, tetapi ingat pengaturan aslinya. Pengaturan tersebut dapat digunakan untuk memulihkan status asli jika pemberitahuan PSN_RESET diterima.
  • Ini dapat segera menerapkan perubahan dan tidak mencoba memulihkan pengaturan asli ketika menerima pemberitahuan PSN_RESET . Pendekatan ini tidak disarankan, tetapi mungkin diperlukan jika perubahan terlalu jauh untuk dua opsi lainnya menjadi praktis.
Untuk opsi ketiga, aplikasi harus mengirim pesan PSM_CANCELTOCLOSE ke lembar properti. Ini menunjukkan kepada pengguna bahwa perubahan yang dilakukan dengan kotak subdialog tidak dapat dibalik dengan mengklik tombol Batal .
Catatan Makro ini tidak didukung saat menggunakan gaya panduan Aero (PSH_AEROWIZARD).
 

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header prsht.h