PropSheet_InsertPage makro (prsht.h)

Menyisipkan halaman baru ke dalam lembar properti yang sudah ada. Halaman dapat disisipkan baik pada indeks tertentu atau setelah halaman tertentu. Anda dapat menggunakan makro ini atau mengirim pesan PSM_INSERTPAGE secara eksplisit.

Sintaksis

BOOL PropSheet_InsertPage(
   HWND hDlg,
   HWND index,
   HWND hpage
);

Parameter

hDlg

Jenis: HWND

Tangani ke lembar properti.

index

Jenis: HWND

Di mana halaman akan disisipkan. Atur indeks ke NULL untuk menjadikan halaman baru sebagai halaman pertama. Untuk menentukan di mana halaman baru akan disisipkan, Anda dapat meneruskan indeks atau handel HPROPSHEETPAGE halaman yang sudah ada.

Nilai	Arti
indeks	Jika indeks kurang dari MAXUSHORT (bilangan bulat pendek terbesar yang tidak ditandatangani), indeks berbasis nol menentukan untuk halaman baru. Misalnya, untuk membuat halaman yang disisipkan menjadi halaman ketiga pada lembar properti, atur indeks ke 2. Untuk menjadikannya halaman pertama, atur indeks ke 0. Jika indeks memiliki nilai yang lebih besar dari jumlah halaman dan kurang dari MAXUSHORT, halaman akan ditambahkan.
hpageInsertAfter	Jika Anda mengatur indeks ke handel HPROPSHEETPAGE halaman yang ada, halaman baru akan dimasukkan setelahnya.

hpage

Jenis: HWND

Tangani ke halaman yang akan disisipkan. Halaman harus terlebih dahulu dibuat dengan panggilan ke fungsi CreatePropertySheetPage.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan nilai bukan nol jika halaman berhasil disisipkan, atau nol jika tidak.

Komentar

Halaman setelah titik penyisipan digeser ke kanan untuk mengakomodasi halaman baru.

Lembar properti tidak diubah ukurannya agar pas dengan halaman baru. Jangan membuat halaman baru lebih besar dari halaman terbesar lembar properti.

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_InsertPage dalam implementasi PropSheetPageProc atau saat menangani pemberitahuan dan pesan Windows berikut.

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

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 menyisipkan 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 wizard Aero (PSH_AEROWIZARD).

 

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