Bagikan melalui


Peta Pesan (MFC)

Bagian referensi ini mencantumkan semua makro pemetaan pesan dan semua CWnd entri peta pesan bersama dengan prototipe fungsi anggota yang sesuai:

Kategori Deskripsi
ON_COMMAND Penangan Pesan Menangani pesan yang WM_COMMAND dihasilkan oleh pilihan menu pengguna atau kunci akses menu.
Penangan Pesan Pemberitahuan Jendela Anak Menangani pesan pemberitahuan dari jendela anak.
WM_ Penangan Pesan Tangani WM_ pesan, seperti WM_PAINT.
Penangan Pesan yang Ditentukan Pengguna Menangani pesan yang ditentukan pengguna.

(Untuk penjelasan tentang terminologi dan konvensi yang digunakan dalam referensi ini, lihat Cara Menggunakan Referensi Silang Peta Pesan.)

Karena Windows adalah sistem operasi berorientasi pesan, sebagian besar pemrograman untuk lingkungan Windows melibatkan penanganan pesan. Setiap kali peristiwa seperti penekanan tombol atau klik mouse terjadi, pesan dikirim ke aplikasi, yang kemudian harus menangani peristiwa.

Pustaka Kelas Microsoft Foundation menawarkan model pemrograman yang dioptimalkan untuk pemrograman berbasis pesan. Dalam model ini, "peta pesan" digunakan untuk menunjuk fungsi mana yang akan menangani berbagai pesan untuk kelas tertentu. Peta pesan berisi satu atau beberapa makro yang menentukan pesan mana yang akan ditangani oleh fungsi mana. Misalnya, peta pesan yang ON_COMMAND berisi makro mungkin terlihat seperti ini:

BEGIN_MESSAGE_MAP(CMyDoc, CDocument)
   ON_COMMAND(ID_MYCMD, &CMyDoc::OnMyCommand)
END_MESSAGE_MAP()

ON_COMMAND Makro digunakan untuk menangani pesan perintah yang dihasilkan oleh menu, tombol, dan kunci akselerator. Makro tersedia untuk memetakan hal berikut:

Pesan Windows

  • Mengontrol pemberitahuan

  • Pesan yang ditentukan pengguna

Pesan Perintah

  • Pesan terdaftar yang ditentukan pengguna

  • Pesan pembaruan antarmuka pengguna

Rentang Pesan

  • Perintah

  • Memperbarui pesan handler

  • Mengontrol pemberitahuan

Meskipun makro peta pesan penting, Anda umumnya tidak perlu menggunakannya secara langsung. Ini karena Panduan Kelas secara otomatis membuat entri peta pesan dalam file sumber Anda saat Anda menggunakannya untuk mengaitkan fungsi penanganan pesan dengan pesan. Setiap kali Anda ingin mengedit atau menambahkan entri peta pesan, Anda bisa menggunakan Panduan Kelas.

Catatan

Panduan Kelas tidak mendukung rentang peta pesan. Anda harus menulis sendiri entri peta pesan ini.

Namun, peta pesan adalah bagian penting dari Pustaka Kelas Microsoft Foundation. Anda harus memahami apa yang mereka lakukan, dan dokumentasi disediakan untuk mereka.

Lihat juga

Struktur, Gaya, Panggilan Balik, serta Peta Pesan