Fungsi panggilan balik LPSETUPHOOKPROC (commdlg.h)
Fungsi panggilan balik yang ditentukan aplikasi atau yang ditentukan pustaka yang digunakan dengan fungsi PrintDlg . Prosedur kait menerima pesan atau pemberitahuan yang ditujukan untuk prosedur kotak dialog default kotak dialog Penyetelan Cetak .
Jenis LPSETUPHOOKPROC mendefinisikan penunjuk ke fungsi panggilan balik ini. SetupHookProc adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi atau yang ditentukan pustaka.
Sintaks
LPSETUPHOOKPROC Lpsetuphookproc;
UINT_PTR Lpsetuphookproc(
HWND unnamedParam1,
UINT unnamedParam2,
WPARAM unnamedParam3,
LPARAM unnamedParam4
)
{...}
Parameter
unnamedParam1
Handel ke kotak dialog Penyetelan Cetak yang pesannya dimaksudkan.
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 .
Mengembalikan nilai
Jika prosedur kait mengembalikan nol, prosedur kotak dialog default memproses pesan.
Jika prosedur kait mengembalikan nilai bukan nol, prosedur kotak dialog default mengabaikan pesan.
Keterangan
Kotak dialog Penyetelan Cetak telah digantikan oleh kotak dialog Penyetelan Halaman , yang harus digunakan oleh aplikasi baru. Namun, untuk kompatibilitas, fungsi PrintDlg terus mendukung tampilan kotak dialog Penyetelan Cetak . Anda bisa menyediakan prosedur hook SetupHookProc untuk kotak dialog Penyetelan Cetak untuk memproses pesan atau pemberitahuan yang ditujukan untuk prosedur kotak dialog.
Untuk mengaktifkan prosedur kait, gunakan struktur PRINTDLG yang Anda berikan ke fungsi pembuatan dialog. Tentukan alamat prosedur kait di anggota lpfnSetupHook dan tentukan bendera PD_ENABLESETUPHOOK di anggota Bendera .
Prosedur kotak dialog default memproses pesan WM_INITDIALOG sebelum meneruskannya ke prosedur kait. Untuk semua pesan lainnya, prosedur kait menerima pesan terlebih dahulu. Kemudian, nilai pengembalian prosedur kait menentukan apakah prosedur dialog default memproses pesan atau mengabaikannya.
Jika prosedur kait memproses pesan WM_CTLCOLORDLG , prosedur tersebut harus mengembalikan handel kuas yang valid untuk melukis latar belakang kotak dialog. Secara umum, jika prosedur kait memproses pesan WM_CTLCOLOR* , prosedur tersebut harus mengembalikan handel kuas yang valid untuk melukis latar belakang kontrol yang ditentukan.
Jangan panggil fungsi EndDialog dari prosedur kait. Sebagai gantinya, prosedur kait dapat memanggil fungsi PostMessage untuk memposting pesan WM_COMMAND dengan nilai IDABORT ke prosedur kotak dialog. Memposting IDABORT menutup kotak dialog dan menyebabkan fungsi kotak dialog mengembalikan FALSE. Jika Anda perlu tahu mengapa prosedur kait menutup kotak dialog, Anda harus menyediakan mekanisme komunikasi Anda sendiri antara prosedur kait dan aplikasi Anda.
Anda dapat mensubkelas kontrol standar dari kotak dialog umum. Namun, prosedur kotak dialog juga dapat mensubkelas kontrol. Karena itu, Anda harus mengontrol subkelas saat prosedur kait memproses pesan WM_INITDIALOG . Ini memastikan bahwa prosedur subkelas Anda menerima pesan khusus kontrol sebelum prosedur subkelas yang diatur oleh prosedur kotak dialog.
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) |
Lihat juga
Konseptual
Referensi
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk