PSN_APPLY kode pemberitahuan

Dikirim ke setiap halaman di lembar properti untuk menunjukkan bahwa pengguna telah mengklik tombol OK, Tutup, atau Terapkan dan ingin semua perubahan diterapkan. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY .

PSN_APPLY 

    lppsn = (LPPSHNOTIFY) lParam; 

Parameter

lParam

Arahkan ke struktur PSHNOTIFY yang berisi informasi tentang kode pemberitahuan, termasuk ID halaman.

Menampilkan nilai

Atur PSNRET_NOERROR untuk menunjukkan bahwa perubahan yang dilakukan pada halaman ini valid dan telah diterapkan. Jika semua halaman diatur PSNRET_NOERROR, lembar properti dapat dihancurkan. Untuk menunjukkan bahwa perubahan yang dilakukan pada halaman ini tidak valid dan untuk mencegah lembar properti dihancurkan, atur salah satu nilai pengembalian berikut:

• PSNRET_INVALID. Lembar properti tidak akan dihancurkan, dan fokus akan dikembalikan ke halaman ini.
• PSNRET_INVALID_NOCHANGEPAGE. Lembar properti tidak akan dihancurkan, dan fokus akan dikembalikan ke halaman yang memiliki fokus saat tombol ditekan.

Untuk mengatur nilai yang dikembalikan, prosedur kotak dialog untuk halaman harus memanggil fungsi SetWindowLong dengan nilai DWL_MSGRESULT, dan prosedur kotak dialog harus mengembalikan TRUE.

Keterangan

Saat pengguna mengklik tombol OK, Terapkan, atau Tutup, lembar properti mengirimkan pemberitahuan PSN_KILLACTIVE ke halaman aktif, memberinya kesempatan untuk memvalidasi perubahan pengguna. Jika perubahan valid, lembar properti mengirimkan kode pemberitahuan PSN_APPLY ke setiap halaman, mengarahkannya untuk menerapkan properti baru ke item yang sesuai.

Catatan

Lembar properti sedang dalam proses memanipulasi daftar halaman saat kode pemberitahuan PSN_APPLY dikirim. Jangan coba menambah, menghapus, atau menyisipkan halaman saat menangani pemberitahuan ini. Melakukannya akan memiliki hasil yang tidak dapat diprediksi.

Anggota lParam dari struktur PSHNOTIFY yang diacu oleh lParam diatur ke TRUE jika pengguna mengklik tombol OK. Ini juga diatur ke TRUE jika pesan PSM_CANCELTOCLOSE telah dikirim dan pengguna mengklik tombol Tutup. Ini diatur ke FALSE jika pengguna mengklik tombol Terapkan.

Struktur PSHNOTIFY berisi struktur NMHDR sebagai anggota pertamanya, hdr. HwndFrom anggota struktur NMHDR ini berisi handel ke lembar properti.

Jangan panggil fungsi EndDialog saat memproses kode pemberitahuan ini.

Lembar properti modal dihancurkan jika pengguna mengklik tombol OK dan setiap halaman mengembalikan nilai PSNRET_NOERROR sebagai respons terhadap PSN_APPLY. Jika ada halaman yang mengembalikan PSNRET_INVALID atau PSNRET_INVALID_NOCHANGEPAGE, proses Terapkan akan segera dibatalkan. Halaman setelah halaman pembatalan tidak akan menerima kode pemberitahuan PSN_APPLY.

Untuk menerima kode pemberitahuan ini, halaman harus mengatur nilai DWL_MSGRESULT ke FALSE sebagai respons terhadap kode pemberitahuan PSN_KILLACTIVE .

Catatan

Kode pemberitahuan ini tidak didukung saat menggunakan gaya wizard 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]
Header	Prsht.h