Fungsi DispatchMessageA (winuser.h)

Mengirimkan pesan ke prosedur jendela. Biasanya digunakan untuk mengirimkan pesan yang diambil oleh fungsi GetMessage .

Sintaksis

LRESULT DispatchMessageA(
  [in] const MSG *lpMsg
);

Parameter

[in] lpMsg

Jenis: const MSG*

Penunjuk ke struktur yang berisi pesan.

Mengembalikan nilai

Jenis: LRESULT

Nilai pengembalian menentukan nilai yang dikembalikan oleh prosedur jendela. Meskipun maknanya tergantung pada pesan yang dikirim, nilai pengembalian umumnya diabaikan.

Komentar

Struktur MSG harus berisi nilai pesan yang valid. Jika parameter lpmsg menunjuk ke pesan WM_TIMER dan parameter lParam pesan WM_TIMER tidak null, lParam menunjuk ke fungsi yang dipanggil alih-alih prosedur jendela.

Perhatikan bahwa aplikasi bertanggung jawab untuk mengambil dan mengirimkan pesan input ke kotak dialog. Sebagian besar aplikasi menggunakan perulangan pesan utama untuk ini. Namun, untuk mengizinkan pengguna berpindah ke dan memilih kontrol dengan menggunakan keyboard, aplikasi harus memanggil IsDialogMessage. Untuk informasi selengkapnya, lihat Antarmuka Keyboard Kotak Dialog.

Contoh

Misalnya, lihat Membuat Perulangan Pesan.

Nota

Header winuser.h mendefinisikan DispatchMessage sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
set API	ext-ms-win-ntuser-message-l1-1-0 (diperkenalkan di Windows 8)

Lihat juga

Konseptual

GetMessage

IsDialogMessage

MSG

Pesan dan Antrean Pesan

PeekMessage

Referensi

translateMessage

WM_TIMER