Appendix A -- Message Map Functions in the Microsoft Foundation Class Library

Appendix A

Message Map Functions in the Microsoft Foundation Class Library

HANDLERS FOR WM_COMMAND MESSAGES

Map Entry	Function Prototype
ON_COMMAND(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_COMMAND_EX(<id>, <memberFxn>)	afx_msg BOOL memberFxn(UINT);
ON_COMMAND_EX_RANGE(<id>, <idLast>, <memberFxn>)	afx_msg BOOL memberFxn(UINT);
ON_COMMAND_RANGE(<id>, <idLast>, <memberFxn>)	afx_msg void memberFxn(UINT);
ON_UPDATE_COMMAND_UI(<id>, <memberFxn>)	afx_msg void memberFxn(CCmdUI*);
ON_UPDATE_COMMAND_UI_RANGE (<id>, <idLast>, <memberFxn>)	afx_msg void memberFxn(CCmdUI*);
ON_UPDATE_COMMAND_UI_REFLECT (<memberFxn>)	afx_msg void memberFxn(CCmdUI*);

HANDLERS FOR CHILD WINDOW NOTIFICATION MESSAGES

Map Entry	Function Prototype
Generic Control Notification Codes
ON_CONTROL(<wNotifyCode>, <id>, <memberFxn>)	afx_msg void memberFxn();
ON_CONTROL_RANGE(<wNotifyCode>, <id> <idLast>, <memberFxn>)	afx_msg void memberFxn(UINT);
ON_CONTROL_REFLECT(<wNotifyCode>, <memberFxn>)	afx_msg void memberFxn();
ON_CONTROL_REFLECT_EX(<wNotifyCode>, <memberFxn>)	afx_msg BOOL memberFxn();
ON_NOTIFY(<wNotifyCode>, <id>, <memberFxn>)	afx_msg void memberFxn(NMHDR*, LRESULT*);
ON_NOTIFY_EX(<wNotifyCode>, <id>, <memberFxn>)	afx_msg BOOL memberFxn(UINT, NMHDR*, LRESULT*);
ON_NOTIFY_EX_RANGE(<wNotifyCode>, <id>, <idLast>, <memberFxn>)	afx_msg BOOL memberFxn(UINT, NMHDR*, LRESULT*);
ON_NOTIFY_RANGE(<wNotifyCode>, <id>, <idLast>, <memberFxn>)	afx_msg void memberFxn(UINT, NMHDR*, LRESULT*);
ON_NOTIFY_REFLECT(<wNotifyCode>, <memberFxn>)	afx_msg void memberFxn(NMHDR*, LRESULT*);
ON_NOTIFY_REFLECT_EX(<wNotifyCode>, <memberFxn>)	afx_msg BOOL memberFxn(NMHDR*, LRESULT*);
User Button Notification Codes
ON_BN_CLICKED(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_BN_DOUBLECLICKED(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_BN_KILLFOCUS(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_BN_SETFOCUS(<id>, <memberFxn>)	afx_msg void memberFxn();
Combo Box Notification Codes
ON_CBN_CLOSEUP(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_CBN_DBLCLK(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_CBN_DROPDOWN(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_CBN_EDITCHANGE(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_CBN_EDITUPDATE(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_CBN_ERRSPACE(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_CBN_KILLFOCUS(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_CBN_SELCHANGE(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_CBN_SELENDCANCEL(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_CBN_SELENDOK(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_CBN_SETFOCUS(<id>, <memberFxn>)	afx_msg void memberFxn();
Check List Box Notification Codes
ON_CLBN_CHKCHANGE(<id>, <memberFxn>)	afx_msg void memberFxn();
Edit Control Notification Codes
ON_EN_CHANGE(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_EN_ERRSPACE(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_EN_HSCROLL(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_EN_KILLFOCUS(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_EN_MAXTEXT(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_EN_SETFOCUS(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_EN_UPDATE(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_EN_VSCROLL(<id>, <memberFxn>)	afx_msg void memberFxn();
List Box Notification Codes
ON_LBN_DBLCLK(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_LBN_ERRSPACE(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_LBN_KILLFOCUS(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_LBN_SELCANCEL(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_LBN_SELCHANGE(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_LBN_SETFOCUS(<id>, <memberFxn>)	afx_msg void memberFxn();
Static Control Notification Codes
ON_STN_CLICKED(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_STN_DBLCLK(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_STN_DISABLE(<id>, <memberFxn>)	afx_msg void memberFxn();
ON_STN_ENABLE(<id>, <memberFxn>)	afx_msg void memberFxn();

HANDLERS FOR WINDOW NOTIFICATION MESSAGES

Map Entry	Function Prototype
ON_WM_ACTIVATE()	afx_msg void OnActivate(UINT, CWnd*, BOOL);
ON_WM_ACTIVATEAPP()	afx_msg void OnActivateApp(BOOL, HTASK);
ON_WM_ASKCBFORMATNAME()	afx_msg void OnAskCbFormatName(UINT, LPTSTR);
ON_WM_CANCELMODE()	afx_msg void OnCancelMode();
ON_WM_CAPTURECHANGED()	afx_msg void OnCaptureChanged(CWnd*);
ON_WM_CHANGECBCHAIN()	afx_msg void OnChangeCbChain(HWND, HWND);
ON_WM_CHAR()	afx_msg void OnChar(UINT, UINT, UINT);
ON_WM_CHARTOITEM()	afx_msg int OnCharToItem(UINT, CListBox*, UINT);
ON_WM_CHARTOITEM_REFLECT()	afx_msg int CharToItem(UINT, UINT);
ON_WM_CHILDACTIVATE()	afx_msg void OnChildActivate();
ON_WM_CLOSE()	afx_msg void OnClose();
ON_WM_COMPACTING()	afx_msg void OnCompacting(UINT);
ON_WM_COMPAREITEM()	afx_msg int OnCompareItem(int, LPCOMPAREITEMSTRUCT);
ON_WM_COMPAREITEM_REFLECT()	afx_msg int CompareItem (LPCOMPAREITEMSTRUCT);
ON_WM_CONTEXTMENU()	afx_msg void OnContextMenu(CWnd*, CPoint);
ON_WM_COPYDATA()	afx_msg BOOL OnCopyData(CWnd*, COPYDATASTRUCT*);
ON_WM_CREATE()	afx_msg int OnCreate(LPCREATESTRUCT);
ON_WM_CTLCOLOR()	afx_msg HBRUSH OnCtlColor(CDC*, CWnd*, UINT);
ON_WM_CTLCOLOR_REFLECT()	afx_msg HBRUSH CtlColor(CDC*, UINT);
ON_WM_DEADCHAR()	afx_msg void OnDeadChar(UINT, UINT, UINT);
ON_WM_DELETEITEM()	afx_msg void OnDeleteItem(int, LPDELETEITEMSTRUCT);
ON_WM_DELETEITEM_REFLECT()	afx_msg void DeleteItem (LPDELETEITEMSTRUCT)
ON_WM_DESTROY()	afx_msg void OnDestroy();
ON_WM_DESTROYCLIPBOARD()	afx_msg void OnDestroyClipboard();
ON_WM_DEVICECHANGE()	afx_msg BOOL OnDeviceChange(UINT, DWORD);
ON_WM_DEVMODECHANGE()	afx_msg void OnDevModeChange(LPTSTR);
ON_WM_DRAWCLIPBOARD()	afx_msg void OnDrawClipboard();
ON_WM_DRAWITEM()	afx_msg void OnDrawItem(int, LPDRAWITEMSTRUCT);
ON_WM_DRAWITEM_REFLECT()	afx_msg void DrawItem (LPDRAWITEMSTRUCT);
ON_WM_DROPFILES()	afx_msg void OnDropFiles(HDROP);
ON_WM_ENABLE()	afx_msg void OnEnable(BOOL);
ON_WM_ENDSESSION()	afx_msg void OnEndSession(BOOL);
ON_WM_ENTERIDLE()	afx_msg void OnEnterIdle(UINT, CWnd*);
ON_WM_ENTERMENULOOP()	afx_msg void OnEnterMenuLoop(BOOL);
ON_WM_ERASEBKGND()	afx_msg BOOL OnEraseBkgnd(CDC*);
ON_WM_EXITMENULOOP()	afx_msg void OnExitMenuLoop(BOOL);
ON_WM_FONTCHANGE()	afx_msg void OnFontChange();
ON_WM_GETDLGCODE()	afx_msg UINT OnGetDlgCode();
ON_WM_GETMINMAXINFO()	afx_msg void OnGetMinMaxInfo (MINMAXINFO*);
ON_WM_HELPINFO()	afx_msg BOOL OnHelpInfo(HELPINFO*);
ON_WM_HSCROLL()	afx_msg void OnHScroll(UINT, UINT, CScrollBar*);
ON_WM_HSCROLL_REFLECT()	afx_msg void HScroll(UINT, UINT);
ON_WM_HSCROLLCLIPBOARD()	afx_msg void OnHScrollClipboard(CWnd*, UINT, UINT);
ON_WM_ICONERASEBKGND()	afx_msg void OnIconEraseBkgnd(CDC*);
ON_WM_INITMENU()	afx_msg void OnInitMenu(CMenu*);
ON_WM_INITMENUPOPUP()	afx_msg void OnInitMenuPopup(CMenu*, UINT, BOOL);
ON_WM_KEYDOWN()	afx_msg void OnKeyDown(UINT, UINT, UINT);
ON_WM_KEYUP()	afx_msg void OnKeyUp(UINT, UINT, UINT);
ON_WM_KILLFOCUS()	afx_msg void OnKillFocus(CWnd*);
ON_WM_LBUTTONDBLCLK()	afx_msg void OnLButtonDblClk(UINT, CPoint);
ON_WM_LBUTTONDOWN()	afx_msg void OnLButtonDown(UINT, CPoint);
ON_WM_LBUTTONUP()	afx_msg void OnLButtonUp(UINT, CPoint);
ON_WM_MBUTTONDBLCLK()	afx_msg void OnMButtonDblClk(UINT, CPoint);
ON_WM_MBUTTONDOWN()	afx_msg void OnMButtonDown(UINT, CPoint);
ON_WM_MBUTTONUP()	afx_msg void OnMButtonUp(UINT, CPoint);
ON_WM_MDIACTIVATE()	afx_msg void OnMDIActivate(BOOL, CWnd*, CWnd*);
ON_WM_MEASUREITEM()	afx_msg void OnMeasureItem(int, LPMEASUREITEMSTRUCT);
ON_WM_MEASUREITEM_REFLECT()	afx_msg void MeasureItem (LPMEASUREITEMSTRUCT);
ON_WM_MENUCHAR()	afx_msg LRESULT OnMenuChar(UINT, UINT, CMenu*);
ON_WM_MENUSELECT()	afx_msg void OnMenuSelect(UINT, UINT, HMENU);
ON_WM_MOUSEACTIVATE()	afx_msg int OnMouseActivate(CWnd*, UINT, UINT);
ON_WM_MOUSEMOVE()	afx_msg void OnMouseMove(UINT, CPoint);
ON_WM_MOUSEWHEEL()	afx_msg BOOL OnMouseWheel(UINT, short, CPoint);
ON_WM_MOVE()	afx_msg void OnMove(int, int);
ON_WM_MOVING()	afx_msg void OnMoving(UINT, LPRECT);
ON_WM_NCACTIVATE()	afx_msg BOOL OnNcActivate(BOOL);
ON_WM_NCCALCSIZE()	afx_msg void OnNcCalcSize(BOOL, NCCALCSIZE_PARAMS*);
ON_WM_NCCREATE()	afx_msg BOOL OnNcCreate (LPCREATESTRUCT);
ON_WM_NCDESTROY()	afx_msg void OnNcDestroy();
ON_WM_NCHITTEST()	afx_msg UINT OnNcHitTest(CPoint);
ON_WM_NCLBUTTONDBLCLK()	afx_msg void OnNcLButtonDblClk(UINT, CPoint);
ON_WM_NCLBUTTONDOWN()	afx_msg void OnNcLButtonDown(UINT, CPoint);
ON_WM_NCLBUTTONUP()	afx_msg void OnNcLButtonUp(UINT, CPoint);
ON_WM_NCMBUTTONDBLCLK()	afx_msg void OnNcMButtonDblClk(UINT, CPoint);
ON_WM_NCMBUTTONDOWN()	afx_msg void OnNcMButtonDown(UINT, CPoint);
ON_WM_NCMBUTTONUP()	afx_msg void OnNcMButtonUp(UINT, CPoint);
ON_WM_NCMOUSEMOVE()	afx_msg void OnNcMouseMove(UINT, CPoint);
ON_WM_NCPAINT()	afx_msg void OnNcPaint();
ON_WM_NCRBUTTONDBLCLK()	afx_msg void OnNcRButtonDblClk(UINT, CPoint);
ON_WM_NCRBUTTONDOWN()	afx_msg void OnNcRButtonDown(UINT, CPoint);
ON_WM_NCRBUTTONUP()	afx_msg void OnNcRButtonUp(UINT, CPoint);
ON_WM_PAINT()	afx_msg void OnPaint();
ON_WM_PAINTCLIPBOARD()	afx_msg void OnPaintClipboard(CWnd*, HGLOBAL);
ON_WM_PALETTECHANGED()	afx_msg void OnPaletteChanged(CWnd*);
ON_WM_PALETTEISCHANGING()	afx_msg void OnPaletteIsChanging(CWnd*);
ON_WM_PARENTNOTIFY()	afx_msg void OnParentNotify(UINT, LPARAM);
ON_WM_PARENTNOTIFY_REFLECT()	afx_msg void ParentNotify(UINT, LPARAM);
ON_WM_QUERYDRAGICON()	afx_msg HCURSOR OnQueryDragIcon();
ON_WM_QUERYENDSESSION()	afx_msg BOOL OnQueryEndSession();
ON_WM_QUERYNEWPALETTE()	afx_msg BOOL OnQueryNewPalette();
ON_WM_QUERYOPEN()	afx_msg BOOL OnQueryOpen();
ON_WM_RBUTTONDBLCLK()	afx_msg void OnRButtonDblClk(UINT, CPoint);
ON_WM_RBUTTONDOWN()	afx_msg void OnRButtonDown(UINT, CPoint);
ON_WM_RBUTTONUP()	afx_msg void OnRButtonUp(UINT, CPoint);
ON_WM_RENDERALLFORMATS()	afx_msg void OnRenderAllFormats();
ON_WM_RENDERFORMAT()	afx_msg void OnRenderFormat(UINT);
ON_WM_SETCURSOR()	afx_msg BOOL OnSetCursor(CWnd*, UINT, UINT);
ON_WM_SETFOCUS()	afx_msg void OnSetFocus(CWnd*);
ON_WM_SETTINGCHANGE()	afx_msg void OnSettingChange(UINT, LPCTSTR);
ON_WM_SHOWWINDOW()	afx_msg void OnShowWindow(BOOL, UINT);
ON_WM_SIZE()	afx_msg void OnSize(UINT, int, int);
ON_WM_SIZECLIPBOARD()	afx_msg void OnSizeClipboard(CWnd*, HGLOBAL);
ON_WM_SIZING()	afx_msg void OnSizing(UINT, LPRECT);
ON_WM_SPOOLERSTATUS()	afx_msg void OnSpoolerStatus(UINT, UINT);
ON_WM_STYLECHANGED()	afx_msg void OnStyleChanged(int, LPSTYLESTRUCT);
ON_WM_STYLECHANGING()	afx_msg void OnStyleChanging(int, LPSTYLESTRUCT);
ON_WM_SYSCHAR()	afx_msg void OnSysChar(UINT, UINT, UINT);
ON_WM_SYSCOLORCHANGE()	afx_msg void OnSysColorChange();
ON_WM_SYSCOMMAND()	afx_msg void OnSysCommand(UINT, LPARAM);
ON_WM_SYSDEADCHAR()	afx_msg void OnSysDeadChar(UINT, UINT, UINT);
ON_WM_SYSKEYDOWN()	afx_msg void OnSysKeyDown(UINT, UINT, UINT);
ON_WM_SYSKEYUP()	afx_msg void OnSysKeyUp(UINT, UINT, UINT);
ON_WM_TCARD()	afx_msg void OnTCard(UINT, DWORD);
ON_WM_TIMECHANGE()	afx_msg void OnTimeChange();
ON_WM_TIMER()	afx_msg void OnTimer(UINT);
ON_WM_VKEYTOITEM()	afx_msg int OnVKeyToItem(UINT, CListBox*, UINT);
ON_WM_VKEYTOITEM_REFLECT()	afx_msg int VKeyToItem(UINT, UINT);
ON_WM_VSCROLL()	afx_msg void OnVScroll(UINT, UINT, CScrollBar*);
ON_WM_VSCROLL_REFLECT()	afx_msg void VScroll(UINT, UINT);
ON_WM_VSCROLLCLIPBOARD()	afx_msg void OnVScrollClipboard(CWnd*, UINT, UINT);
ON_WM_WINDOWPOSCHANGED()	afx_msg void OnWindowPosChanged (WINDOWPOS*);
ON_WM_WINDOWPOSCHANGING()	afx_msg void OnWindowPosChanging (WINDOWPOS*);
ON_WM_WININICHANGE()	afx_msg void OnWinIniChange(LPCTSTR);

USER-DEFINED MESSAGE CODES

Map Entry	Function Prototype
ON_MESSAGE(<message>, <memberFxn>)	afx_msg LRESULT memberFxn(WPARAM, LPARAM);
ON_REGISTERED_MESSAGE (<nMessageVariable>,<memberFxn>)	afx_msg LRESULT memberFxn(WPARAM, LPARAM);
ON_REGISTERED_THREADMESSAGE(<nMessageVariable>, <memberFxn>)	afx_msg void memberFxn(WPARAM, LPARAM);
ON_THREAD_MESSAGE (<message>, <memberFxn>)	afx_msg void memberFxn(WPARAM, LPARAM);