PropSheet_RemovePage makro (prsht.h)

Menghapus halaman dari lembar properti. Anda dapat menggunakan makro ini atau mengirim pesan PSM_REMOVEPAGE secara eksplisit.

Sintaks

void PropSheet_RemovePage(
   hDlg,
   index,
   hpage
);

Parameter

hDlg

Jenis: HWND

Tangani ke lembar properti.

index

Jenis: int

Indeks berbasis nol halaman yang akan dihapus.

hpage

Jenis: HPROPSHEETPAGE

Tangani ke halaman yang akan dihapus.

Mengembalikan nilai

Tidak ada

Keterangan

Aplikasi dapat menentukan halaman yang akan dihapus dengan menetapkan nilai untuk indeks atau hpage. Jika nilai ditetapkan ke indeks dan hpage, hpage lebih diutamakan.

Sejumlah pesan dan satu panggilan fungsi terjadi saat lembar properti memanipulasi daftar halaman. Saat tindakan ini sedang berlangsung, mencoba mengubah daftar halaman akan memiliki hasil yang tidak dapat diprediksi. Oleh karena itu, Anda tidak boleh menggunakan makro PropSheet_RemovePage dalam implementasi PropSheetPageProc atau saat menangani pemberitahuan berikut dan pesan Windows.

• PSN_APPLY
• PSN_KILLACTIVE
• PSN_RESET
• PSN_SETACTIVE
• WM_DESTROY
• WM_INITDIALOG

Jika Anda perlu mengubah halaman lembar properti saat menangani salah satu pesan ini atau saat PropSheetPageProc sedang beroperasi, posting sendiri pesan Windows privat. Aplikasi Anda tidak akan menerima pesan tersebut sampai setelah pengelola lembar properti menyelesaikan tugasnya. Kemudian Anda dapat mengubah daftar halaman.

Pemberitahuan berikut juga dipengaruhi oleh modifikasi lembar properti.

• PSN_WIZBACK
• PSN_WIZNEXT

Anda dapat menambahkan atau menghapus halaman sebagai respons terhadap pemberitahuan ini, asalkan Anda mengembalikan (melalui DWL_MSGRESULT) nilai bukan nol untuk menentukan halaman baru yang diinginkan. Namun, perhatikan bahwa jika Anda menghapus halaman yang terletak sebelum halaman saat ini (yang memiliki indeks yang lebih kecil dari halaman saat ini), PSN_KILLACTIVE mungkin dikirim ke halaman yang salah.

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