makro PropSheet_AddPage (prsht.h)

Menambahkan halaman baru ke akhir lembar properti yang sudah ada. Anda dapat menggunakan makro ini atau mengirim pesan PSM_ADDPAGE secara eksplisit.

Sintaksis

BOOL PropSheet_AddPage(
   HWND           hDlg,
   HPROPSHEETPAGE hpage
);

Parameter

hDlg

Jenis: HWND

Tangani ke lembar properti.

hpage

Jenis: HPROPSHEETPAGE

Tangani ke halaman untuk ditambahkan. Halaman harus dibuat oleh panggilan sebelumnya ke fungsi CreatePropertySheetPage.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya.

Komentar

Halaman baru seharusnya tidak lebih besar dari halaman terbesar yang saat ini ada di lembar properti karena lembar properti tidak diubah ukurannya agar pas dengan halaman baru.

Sejumlah pesan dan satu panggilan fungsi terjadi saat lembar properti sedang 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_AddPage dalam implementasi PropSheetPageProc atau saat menangani pemberitahuan berikut dan pesan Microsoft 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 manajer lembar properti menyelesaikan tugasnya. Kemudian Anda dapat mengubah daftar halaman.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	prsht.h