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.
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.
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.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 |