Fungsi panggilan balik LPPAGEPAINTHOOK (commdlg.h)

Artikel
08/22/2023

Menerima pesan yang memungkinkan Anda mengkustomisasi gambar halaman sampel dalam kotak dialog Penyetelan Halaman . Prosedur hook PagePaintHook adalah fungsi panggilan balik yang ditentukan aplikasi atau yang ditentukan pustaka yang digunakan dengan fungsi PageSetupDlg .

Jenis LPPAGEPAINTHOOK mendefinisikan penunjuk ke fungsi panggilan balik ini. PagePaintHook adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi atau yang ditentukan pustaka.

Sintaks

LPPAGEPAINTHOOK Lppagepainthook;

UINT_PTR Lppagepainthook(
  HWND unnamedParam1,
  UINT unnamedParam2,
  WPARAM unnamedParam3,
  LPARAM unnamedParam4
)
{...}

Parameter

unnamedParam1

Handel ke kotak dialog Penyetelan Halaman .

unnamedParam2

Pengidentifikasi pesan yang diterima.

unnamedParam3

Informasi tambahan tentang pesan. Arti yang tepat tergantung pada nilai parameter unnamedParam2 .

unnamedParam4

Informasi tambahan tentang pesan. Arti yang tepat tergantung pada nilai parameter unnamedParam2 .

Nilai kembali

Jika prosedur hook mengembalikan TRUE untuk salah satu dari tiga pesan pertama dari urutan gambar (WM_PSD_PAGESETUPDLG, WM_PSD_FULLPAGERECT, atau WM_PSD_MINMARGINRECT), kotak dialog tidak mengirim lebih banyak pesan dan tidak menggambar di halaman sampel sampai saat berikutnya sistem perlu menggambar ulang halaman sampel. Jika prosedur hook mengembalikan FALSE untuk ketiga pesan tersebut, kotak dialog akan mengirim pesan yang tersisa dari urutan menggambar.

Jika prosedur kait mengembalikan TRUE untuk salah satu pesan yang tersisa dalam urutan gambar, kotak dialog tidak menggambar bagian yang sesuai dari halaman sampel. Jika prosedur hook mengembalikan FALSE untuk salah satu pesan ini, kotak dialog akan menggambar bagian halaman sampel tersebut.

Keterangan

Kotak dialog Penyetelan Halaman menyertakan gambar halaman sampel yang memperlihatkan bagaimana pilihan pengguna memengaruhi tampilan output yang dicetak. Gambar terdiri dari persegi panjang yang mewakili tipe kertas atau amplop yang dipilih, dengan persegi panjang garis putus-putus yang mewakili margin saat ini, dan karakter parsial (teks Yunani) untuk memperlihatkan tampilan teks pada halaman cetak. Saat Anda menggunakan fungsi PageSetupDlg untuk membuat kotak dialog Penyetelan Halaman , Anda bisa menyediakan prosedur hook PagePaintHook untuk mengkustomisasi tampilan halaman sampel.

Untuk mengaktifkan prosedur kait, gunakan struktur PAGESETUPDLG yang Anda teruskan ke fungsi pembuatan. Tentukan penunjuk ke prosedur kait di anggota lpfnPagePaintHook dan tentukan bendera PSD_ENABLEPAGEPAINTHOOK di anggota Bendera .

Setiap kali kotak dialog akan menggambar konten halaman sampel, prosedur kait menerima pesan berikut dalam urutan daftarnya.

Pesan	Makna
WM_PSD_PAGESETUPDLG	Kotak dialog akan menggambar halaman sampel. Prosedur kait dapat menggunakan pesan ini untuk bersiap menggambar konten halaman sampel.
WM_PSD_FULLPAGERECT	Kotak dialog akan menggambar halaman sampel. Pesan ini menentukan persegi panjang pembatas dari halaman sampel.
WM_PSD_MINMARGINRECT	Kotak dialog akan menggambar halaman sampel. Pesan ini menentukan persegi margin.
WM_PSD_MARGINRECT	Kotak dialog akan menggambar persegi margin.
WM_PSD_GREEKTEXTRECT	Kotak dialog akan menggambar teks Yunani di dalam persegi margin.
WM_PSD_ENVSTAMPRECT	Kotak dialog akan digambar dalam persegi amplop-stempel dari halaman sampel amplop. Pesan ini dikirim hanya untuk amplop.
WM_PSD_YAFULLPAGERECT	Kotak dialog akan menggambar bagian alamat pengirim dari halaman sampel amplop. Pesan ini dikirim untuk amplop dan ukuran kertas lainnya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	commdlg.h (sertakan Windows.h)