Bagikan melalui

makro PropSheet_SetWizButtons (prsht.h)

  • Artikel

Mengaktifkan atau menonaktifkan tombol Kembali, Berikutnya, dan Selesai dalam wizard dengan memposting pesan PSM_SETWIZBUTTONS. Anda dapat menggunakan makro ini atau mengirim pesan PSM_SETWIZBUTTONS secara eksplisit.

Sintaksis

VOID PropSheet_SetWizButtons(
   HWND  hDlg,
   DWORD dwFlags
);

Parameter

hDlg

Jenis: HWND

Tangani ke lembar properti.

dwFlags

Jenis: DWORD

Nilai yang menentukan tombol wizard mana yang diaktifkan. Anda dapat menggabungkan satu atau beberapa bendera berikut.

Nilai Arti
PSWIZB_BACK
 Aktifkan tombol Kembali. Jika bendera ini tidak diatur, tombol Kembali ditampilkan sebagai dinonaktifkan.
PSWIZB_DISABLEDFINISH
 Tampilkan tombol Selesai yang dinonaktifkan.
PSWIZB_FINISH
 Tampilkan tombol Selesai yang diaktifkan.
PSWIZB_NEXT
 Aktifkan tombol Berikutnya. Jika bendera ini tidak diatur, tombol Berikutnya ditampilkan sebagai dinonaktifkan.

Mengembalikan nilai

Jenis: VOID

Tidak ada nilai yang dikembalikan.

Komentar

Makro ini menggunakan PostMessage untuk mengirim pesan PSM_SETWIZBUTTONS. Jika handler pemberitahuan Anda memanggil PropSheet_SetWizButtons, jangan lakukan apa pun yang akan memengaruhi fokus jendela sampai setelah handler kembali. Misalnya, jika Anda memanggil MessageBox segera setelah memanggil PropSheet_SetWizButtons, kotak pesan akan menerima fokus. Karena pesan yang dikirim dengan PostMessage tidak dikirimkan hingga mencapai kepala antrean pesan, pesan PSM_SETWIZBUTTONS tidak akan dikirimkan sampai wizard kehilangan fokus ke kotak pesan. Akibatnya, lembar properti tidak akan dapat mengatur fokus untuk tombol dengan benar.

Panduan menampilkan tiga atau empat tombol di bawah setiap halaman. Pesan ini digunakan untuk menentukan tombol mana yang diaktifkan. Panduan biasanya menampilkan Kembali, Batal, dan tombol Berikutnya atau Selesai. Anda biasanya hanya mengaktifkan tombol Berikutnya untuk halaman selamat datang, Berikutnya dan Kembali untuk halaman interior, dan Kembali dan Selesai untuk halaman penyelesaian. Tombol Batalkan selalu diaktifkan. Biasanya, pengaturan PSWIZB_FINISH atau PSWIZB_DISABLEDFINISH mengganti tombol Berikutnya dengan tombol Selesai. Untuk menampilkan tombol Berikutnya dan Selesai secara bersamaan, atur PSH_WIZARDHASFINISH FLAG di dwFlags anggota struktur PROPSHEETHEADER wizard saat Anda membuat wizard. Setiap halaman kemudian akan menampilkan keempat tombol.

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