Bagikan melalui

PropSheet_SetWizButtons makro (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.

Sintaks

void PropSheet_SetWizButtons(
   hDlg,
   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 Makna
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

Tidak ada

Keterangan

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 hingga 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 dikirim hingga mencapai kepala antrean pesan, pesan PSM_SETWIZBUTTONS tidak akan dikirimkan sampai setelah wizard kehilangan fokus ke kotak pesan. Akibatnya, lembar properti tidak akan dapat mengatur fokus dengan benar untuk tombol.

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, mengatur PSWIZB_FINISH atau PSWIZB_DISABLEDFINISH mengganti tombol Berikutnya dengan tombol Selesai. Untuk menampilkan tombol Berikutnya dan Selesai secara bersamaan, atur PSH_WIZARDHASFINISH FLAG di anggota dwFlags struktur PROPSHEETHEADER wizard saat Anda membuat wizard. Setiap halaman kemudian akan menampilkan keempat tombol.

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