Pesan AFX
Pesan ini digunakan dalam MFC.
Pesan
Tabel berikut ini mencantumkan pesan yang digunakan dalam pustaka MFC:
| Pesan | Deskripsi | [di] wParam | lParam (Semua parameter adalah [in] kecuali dinyatakan lain.) | Tampilkan Nilai |
|---|---|---|---|---|
| AFX_WM_ACCGETOBJECT | Tidak digunakan. | Tidak digunakan. | Tidak dapat diterapkan. | Tidak dapat diterapkan. |
| AFX_WM_ACCGETSTATE | Digunakan untuk dukungan aksesibilitas. Kirim pesan ini ke CMFCPopupMenu atau CMFCRibbonPanelMenu untuk mengambil status elemen saat ini. |
Indeks elemen, yang bisa menjadi tombol menu atau pemisah. | Tidak digunakan. | Status elemen. Ini -1 jika indeks tidak valid, 0 jika tombol menu tidak memiliki atribut khusus. Jika tidak, ini adalah kombinasi dari bendera berikut: TBBS_DISABLED — item dinonaktifkan TBBS_CHECKED — item dicentang TBBS_BUTTON — item adalah tombol dorong standar TBBS_PRESSED — tombol ditekan TBBS_INDETERMINATE — status tidak terdefinisi TBBS_SEPARATOR - bukan tombol menu, elemen ini membentuk pemisahan antara item menu lainnya |
| AFX_WM_CHANGE_ACTIVE_TAB | Kerangka kerja mengirimkan pesan ini ke kontrol bilah kontrol yang dapat diubah ukurannya. Proses pesan ini untuk menerima pemberitahuan dari CMFCTabCtrl objek saat pengguna mengubah tab aktif. |
Indeks tab. | Tidak digunakan. | Bukan nol. |
| AFX_WM_CHANGE_CURRENT_FOLDER | Kerangka kerja mengirimkan pesan ini ke induk CMFCShellListCtrl kapan pengguna telah mengubah folder saat ini. |
Tidak digunakan. | Tidak digunakan. | Tidak digunakan. |
| AFX_WM_CHANGEVISUALMANAGER | Kerangka kerja mengirimkan pesan ini ke semua jendela bingkai ketika pengguna mengubah Visual Manager saat ini. Sebagai respons terhadap pesan ini, jendela bingkai menghitung ulang wilayahnya dan menyesuaikan parameter lain sesuai kebutuhan. Anda dapat memproses pesan AFX_WM_CHANGEVISUALMANAGER di aplikasi Jika Anda perlu diberi tahu tentang peristiwa ini. Anda harus memanggil penangan kelas dasar (OnChangeVisualManager) untuk memastikan bahwa pemrosesan internal kerangka kerja peristiwa ini berlangsung. |
Tidak digunakan. | Tidak digunakan. | Tidak digunakan. |
| AFX_WM_CHANGING_ACTIVE_TAB | Dikirim ke induk CMFCTabCtrl objek. Proses pesan ini jika Anda ingin menerima pemberitahuan dari CMFCTabCtrl objek saat pengguna mengatur ulang tab. |
Indeks tab yang sedang diaktifkan. | Tidak digunakan. | Bukan nol. |
| AFX_WM_CHECKEMPTYMINIFRAME | Hanya untuk penggunaan internal. | Tidak dapat diterapkan. | Tidak dapat diterapkan. | Tidak dapat diterapkan. |
| AFX_WM_CREATETOOLBAR | Dikirim dari CMFCToolBarsListPropertyPage saat pengguna membuat toolbar baru selama proses penyesuaian. Anda dapat memproses pesan ini untuk membuat instans objek turunan CMFCToolBar kustom. Jika Anda menangani pesan ini dan membuat toolbar Anda sendiri, hilangkan panggilan ke handler default. |
Tidak digunakan. | Penunjuk ke string yang berisi nama toolbar. | Penunjuk ke toolbar yang baru dibuat. NULL menunjukkan bahwa pembuatan bilah alat dibatalkan. |
| AFX_WM_CUSTOMIZEHELP | Dikirim ke jendela bingkai utama dari lembar CMFCToolbarCustomize Dialog properti kustomisasi saat pengguna menekan tombol Bantuan atau tombol F1. |
Menentukan halaman aktif lembar properti kustomisasi. | Penunjuk ke CMFCToolbarCustomize Dialog objek. |
Nol. |
| AFX_WM_CUSTOMIZETOOLBAR | CMFCToolbarCustomize Dialog Mengirim pesan ini untuk memberi tahu bingkai induk bahwa pengguna membuat bilah alat baru. |
TRUE saat penyesuaian dimulai, FALSE ketika penyesuaian selesai. | Tidak digunakan. | Nol. |
| AFX_WM_DELETETOOLBAR | Dikirim ke jendela bingkai utama saat pengguna akan menghapus toolbar dalam mode kustomisasi. Proses pesan ini untuk mengambil tindakan tambahan saat pengguna menghapus toolbar dalam mode kustomisasi. Anda juga harus memanggil handler default ( OnToolbarDelete), yang menghapus toolbar. Handler default mengembalikan nilai yang menunjukkan apakah mungkin untuk menghapus toolbar. |
Tidak digunakan. | Penunjuk ke objek yang CMFCToolBar akan dihapus. |
Bukan nol jika bilah alat tidak dapat dihapus; jika tidak, 0. |
| AFX_WM_GETDOCUMENTCOLORS | CMFCColorMenuButton mengirim pesan ini ke jendela bingkai utama untuk mengambil warna dokumen. |
Tidak digunakan. | [masuk, keluar] Penunjuk CList<COLORREF, COLORREF> ke objek. |
Nol. |
| AFX_WM_GETDRAGBOUNDS | Hanya untuk penggunaan internal. | Tidak dapat diterapkan. | Tidak dapat diterapkan. | Tidak dapat diterapkan. |
| AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM | Dikirim ke jendela bingkai utama saat pengguna menyoroti item daftar pita. | Indeks item yang disorot | Penunjuk ke CMFCBaseRibbonElement |
Tidak digunakan. |
| AFX_WM_ON_AFTER_SHELL_COMMAND | Dikirim ke induk CMFCShellListCtrl atau CMFCShellTreeCtrl kontrol saat pengguna selesai menjalankan perintah shell. |
ID perintah yang dijalankan pengguna | Tidak digunakan. | Jika aplikasi memproses pesan ini, aplikasi harus mengembalikan nol. |
| AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU | Kerangka kerja mengirimkan pesan ini ke induk pita sebelum menampilkan menu pop-up. Anda dapat memproses pesan ini dan mengubah menu pop-up kapan saja. | Tidak digunakan. | Penunjuk ke CMFCBaseRibbonElement |
Tidak digunakan. |
| AFX_WM_ON_CANCELTABMOVE | Hanya untuk penggunaan internal. | Tidak dapat diterapkan. | Tidak dapat diterapkan. | |
| AFX_WM_ON_CHANGE_RIBBON_CATEGORY | Kerangka kerja mengirimkan pesan ini ke bingkai utama saat pengguna mengubah kategori Kontrol Pita aktif. | Tidak digunakan. | Penunjuk ke CMFCRibbonBar kategori yang telah berubah. |
Tidak digunakan. |
| AFX_WM_ON_CLOSEPOPUPWINDOW | Kerangka kerja mengirimkan pesan ini untuk memberi tahu pemilik CMFCDesktopAlertWnd bahwa jendela akan ditutup. |
Tidak digunakan. | Penunjuk ke CMFCDesktopAlertWnd objek. |
Tidak digunakan. |
| AFX_WM_ON_DRAGCOMPLETE | Hanya untuk penggunaan internal. | Tidak dapat diterapkan. | Tidak dapat diterapkan. | Tidak dapat diterapkan. |
| AFX_WM_ON_GET_TAB_TOOLTIP | Dikirim ke jendela bingkai utama saat jendela tab akan menampilkan tipsalat untuk tab, jika tipsalat kustom diaktifkan. | Tidak digunakan. | Penunjuk ke CMFCTabToolTipInfo struktur. |
Tidak digunakan. |
| AFX_WM_ON_HSCROLL | Dikirim ke kontrol bilah kontrol yang dapat diubah besar. Proses pesan ini untuk menerima pemberitahuan dari CMFCTabCtrl objek ketika peristiwa gulir terjadi di bilah gulir horizontal widget bertab. |
Kata berurutan rendah menentukan nilai bilah gulir yang menunjukkan permintaan pengguliran pengguna. Untuk informasi selengkapnya, lihat tabel nanti dalam topik ini. | Tidak digunakan. | Bukan nol. |
| AFX_WM_ON_MOVE_TAB | Dikirim ke induk jendela bertab saat pengguna menyeret tab ke posisi baru. | Indeks berbasis nol tab dalam posisi aslinya. | [out] Indeks berbasis nol tab di posisi barunya. | Nol. |
| AFX_WM_ON_MOVETABCOMPLETE | Hanya untuk penggunaan internal. | Tidak dapat diterapkan. | Tidak dapat diterapkan. | Tidak dapat diterapkan. |
| AFX_WM_ON_MOVETOTABGROUP | Dikirim ke jendela bingkai utama saat pengguna memindahkan jendela anak MDI dari satu grup bertab ke grup bertab lainnya. | Handel ke jendela bertab (CMFCTabCtrl) tempat jendela anak MDI telah dihapus. |
[out] Handel ke jendela bertab (CMFCTabCtrl) tempat jendela anak MDI telah disisipkan. |
Diabaikan. |
| AFX_WM_ON_PRESS_CLOSE_BUTTON | Dikirim ke induk CDockablePane saat pengguna mengklik tombol Tutup pada keterangan bilah kontrol. |
Tidak digunakan. | Penunjuk ke panel yang dapat ditampung di mana pengguna mengklik tombol Tutup . | TRUE jika panel tidak dapat ditutup; jika tidak FALSE. |
| AFX_WM_ON_RENAME_TAB | Dikirim ke induk jendela bertab setelah pengguna mengganti nama tab yang dapat diedit. | Indeks berbasis nol dari tab yang diganti namanya. | [out] Penunjuk ke string yang berisi nama tab baru. | Nonzero jika aplikasi memproses pesan ini; kerangka kerja akan menekan panggilan ke CMFCBaseTabCtrl::SetTabLabel. Jika nol dikembalikan, maka CMFCBaseTabCtrl::SetTabLabel dipanggil oleh kerangka kerja. |
| AFX_WM_ON_RIBBON_CUSTOMIZE | Dikirim ke bingkai induk saat pengguna memulai kustomisasi. Proses pesan ini jika Anda ingin menampilkan kotak dialog kustomisasi Anda sendiri. | Tidak digunakan. | Penunjuk ke kontrol pita yang akan dikustomisasi. | Bukan nol jika aplikasi memproses pesan ini dan menampilkan kotak dialog kustomisasinya sendiri. Jika aplikasi mengembalikan nol, kerangka kerja akan menampilkan kotak dialog kustomisasi bawaan. |
| AFX_WM_ON_TABGROUPMOUSEMOVE | Hanya untuk penggunaan internal. | Tidak dapat diterapkan. | Tidak dapat diterapkan. | Tidak dapat diterapkan. |
| AFX_WM_POSTSETPREVIEWFRAME | Dikirim untuk memberi tahu bingkai utama bahwa pengguna mengubah mode pratinjau cetak | TRUE menunjukkan bahwa mode pratinjau cetak diatur. FALSE menunjukkan bahwa mode pratinjau cetak dinonaktifkan. | Tidak digunakan. | Tidak digunakan. |
| AFX_WM_PROPERTY_CHANGED | Dikirim ke pemilik kontrol kisi properti (CMFCPropertyGridCtrl) saat pengguna mengubah nilai properti yang dipilih. |
ID kontrol daftar properti. | Penunjuk ke properti (CMFCPropertyGridProperty) yang berubah. |
Tidak digunakan. |
| AFX_WM_RESETCONTEXTMENU | Dikirim ke jendela bingkai utama saat pengguna mengatur ulang menu konteks selama kustomisasi. | ID sumber daya menu konteks. | Penunjuk ke menu konteks saat ini, CMFCPopupMenu. |
Tidak digunakan. |
| AFX_WM_RESETKEYBOARD | Kerangka kerja mengirimkan pesan ini ke jendela bingkai utama saat pengguna mengatur ulang semua akselerator keyboard selama penyesuaian. | Tidak digunakan. | Tidak digunakan. | Tidak digunakan. |
| AFX_WM_RESETMENU | Kerangka kerja mengirimkan pesan ini ke pemilik menu (jendela bingkai) saat pengguna mengatur ulang menu bingkai aplikasi selama penyesuaian | ID sumber daya menu. | Tidak digunakan. | Tidak digunakan. |
| AFX_WM_RESETPROMPT | Kerangka kerja mengirim pesan ini ketika pengguna mereset toolbar dari kotak dialog kustomisasi bilah alat. Handler default menampilkan kotak pesan yang menanyakan apakah pengguna ingin mereset toolbar. | Tidak digunakan. | Tidak digunakan. | Tidak digunakan. |
| AFX_WM_RESETTOOLBAR | Objek CMFCToolBar mengirim pesan ini ketika bilah alat dipulihkan ke status aslinya, yaitu, dimuat dari sumber daya. Proses pesan ini untuk menginstal ulang tombol toolbar yang kelasnya berasal dari CMFCToolbarButton. Untuk informasi selengkapnya, lihat CMFCToolbarComboBoxButton . |
ID sumber daya bilah alat yang statusnya dipulihkan. | Tidak digunakan. | Nol. |
| AFX_WM_SHOWREGULARMENU | CMFCToolbarMenuButton objek mengirimkan pesan ini kepada pemiliknya ketika pengguna mengklik tombol menu reguler. Proses pesan ini setiap kali Anda menggunakan CMFCToolbarMenuButton untuk menampilkan menu pop-up saat pengguna mengklik tombol. |
ID perintah tombol yang mengirim pesan. | Koordinat layar kursor. Kata berurutan rendah menentukan koordinat x. Kata urutan tinggi menentukan koordinat y. | Tidak digunakan. |
| AFX_WM_TOOLBARMENU | Dikirim ke jendela bingkai utama saat pengguna melepaskan tombol kanan mouse saat penunjuk mouse berada di area klien atau non-klien panel. | Tidak digunakan. | Koordinat layar penunjuk mouse. Kata berurutan rendah menentukan koordinat x. Kata urutan tinggi menentukan koordinat y. | Nol jika aplikasi memproses pesan ini; jika tidak, bukan nol. |
| AFX_WM_UPDATETOOLTIPS | Dikirim ke semua pemilik tipsalat untuk menunjukkan bahwa kontrol tipsalat mereka harus dibuat ulang. | Jenis kontrol yang harus memproses pesan ini. Lihat tabel nanti dalam topik ini untuk daftar nilai yang mungkin. | Tidak digunakan. | Tidak digunakan. |
| AFX_WM_WINDOW_HELP | CMFCWindowsManagerDialog mengirim pesan ini ke bingkai induk ketika pengguna mengklik tombol Bantuan , atau memasuki mode bantuan dengan mengklik tombol Keterangan bantuan atau tombol F1. |
Tidak digunakan. | Penunjuk ke instans CMFCWindowsManagerDialog. |
Tidak digunakan. |
Tabel berikut ini memperlihatkan nilai untuk kata rendah parameter lParam dari metode AFX_WM_HSCROLL:
| Nilai | Makna |
|---|---|
| SB_ENDSCROLL | Pengguna mengakhiri gulir. |
| SB_LEFT | Pengguna menggulir ke kiri atas. |
| SB_RIGHT | Pengguna menggulir ke kanan bawah. |
| SB_LINELEFT | Pengguna menggulir ke kiri satu unit. |
| SB_LINERIGHT | Pengguna menggulir ke kanan satu unit. |
| SB_PAGELEFT | Pengguna menggulir ke kiri dengan lebar jendela. |
| SB_PAGERIGHT | Pengguna menggulir ke kanan menurut lebar jendela. |
| SB_THUMBPOSITION | Pengguna telah menyeret kotak gulir (jempol) dan melepaskan tombol mouse. Kata berurutan tinggi menunjukkan posisi kotak gulir di akhir operasi seret. |
| SB_THUMBTRACK | Pengguna menyeret kotak gulir. Pesan AFX_WM_ON_HSCROLL dikirim berulang kali dengan nilai ini hingga pengguna merilis tombol mouse. Kata berurutan tinggi menunjukkan posisi kotak gulir telah diseret. |
Catatan
Kata berurutan tinggi dari parameter lParam menentukan posisi kotak gulir saat ini jika kata urutan rendah SB_THUMBPOSITION atau SB_THUMBTRACK; jika tidak, kata ini tidak digunakan.
Tabel berikut mencantumkan nilai bendera untuk parameter lParam dari pesan AFX_WM_UPDATETOOLTIPS:
| Bendera | Nilai |
|---|---|
| AFX_TOOLTIP_TYPE_DEFAULT | 0x0001 |
| AFX_TOOLTIP_TYPE_TOOLBAR | 0x0002 |
| AFX_TOOLTIP_TYPE_TAB | 0x0004 |
| AFX_TOOLTIP_TYPE_MINIFRAME | 0x0008 |
| AFX_TOOLTIP_TYPE_DOCKBAR | 0x0010 |
| AFX_TOOLTIP_TYPE_EDIT | 0x0020 |
| AFX_TOOLTIP_TYPE_BUTTON | 0x0040 |
| AFX_TOOLTIP_TYPE_TOOLBOX | 0x0080 |
| AFX_TOOLTIP_TYPE_ALL | 0xFFFF |