Fungsi panggilan balik DLGPROC (winuser.h)

Artikel
08/27/2023

Fungsi panggilan balik yang ditentukan aplikasi yang digunakan dengan keluarga fungsi CreateDialog dan DialogBox . Ini memproses pesan yang dikirim ke kotak dialog modal atau tanpa mode. Jenis DLGPROC mendefinisikan penunjuk ke fungsi panggilan balik ini. DialogProc adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.

Sintaks

DLGPROC Dlgproc;

INT_PTR Dlgproc(
  HWND unnamedParam1,
  UINT unnamedParam2,
  WPARAM unnamedParam3,
  LPARAM unnamedParam4
)
{...}

Parameter

unnamedParam1

Jenis: HWND

Handel ke kotak dialog.

unnamedParam2

Jenis: UINT

Pesannya.

unnamedParam3

Jenis: WPARAM

Informasi khusus pesan tambahan.

unnamedParam4

Jenis: LPARAM

Informasi khusus pesan tambahan.

Jenis: INT_PTR

Biasanya, prosedur kotak dialog harus mengembalikan TRUE jika memproses pesan, dan FALSE jika tidak. Jika prosedur kotak dialog mengembalikan FALSE, manajer dialog melakukan operasi dialog default sebagai respons terhadap pesan.

Jika prosedur kotak dialog memproses pesan yang memerlukan nilai pengembalian tertentu, prosedur kotak dialog harus mengatur nilai pengembalian yang diinginkan dengan memanggil SetWindowLong(hwndDlg, DWL_MSGRESULT, lResult) segera sebelum mengembalikan TRUE. Perhatikan bahwa Anda harus segera memanggil SetWindowLong sebelum mengembalikan TRUE; melakukannya lebih awal dapat mengakibatkan nilai DWL_MSGRESULT ditimpa oleh pesan kotak dialog berlapis.

Pesan berikut adalah pengecualian untuk aturan umum yang dinyatakan di atas. Lihat dokumentasi untuk pesan tertentu untuk detail tentang semantik nilai yang dikembalikan.

Nilai kembali

Tidak ada

Keterangan

Anda harus menggunakan prosedur kotak dialog hanya jika Anda menggunakan kelas kotak dialog untuk kotak dialog. Ini adalah kelas default dan digunakan ketika tidak ada kelas eksplisit yang ditentukan dalam templat kotak dialog. Meskipun prosedur kotak dialog mirip dengan prosedur jendela, prosedur ini tidak boleh memanggil fungsi DefWindowProc untuk memproses pesan yang tidak diinginkan. Pesan yang tidak diinginkan diproses secara internal oleh prosedur jendela 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	winuser.h (termasuk Windows.h)