Author: Dish ( http://blog.csdn.net/utensil/ )
The reason for using the dynamic event mapping approach may be that you want to use different mappings at different points in the program run, or because the language you are using (e.g. python) doesn't support static mappings, or just because you prefer dynamic mappings . Because the dynamic mapping method allows you to control the details of the event table more precisely, you can even open or close an entry in the event table individually at runtime, while the aforementioned PushEventHandler and PopEventHandler methods can only be used for the entire event table for processing. In addition to this, dynamic event handling allows you to share event functions between different classes.
——"WxWidgets Cross-Platform GUI Development"
preface
In wxWidgets, I prefer dynamic event table, connect personally, and Disconnect at any time, rather than static event table which is rigid and unknown.
However, when writing the dynamic event table, there will be a problem. The event processing part in the official document of wxWidgets describes the macros of various event types required by the static event table in detail, but the macros required by the dynamic event table are detailed. The event type is vague, which brings trouble to our use. The required knowledge is scattered in the wx documentation on the one hand, and buried in <wx/event.h> by verbose code on the other hand. The purpose of this article is to provide a handy manual for dynamic event table enthusiasts, hoping to help everyone.
Most of the wx classes (including windows, dialog boxes, and controls) commonly used to write GUIs inherit from three classes: wxWindowwx, wxEvtHandler, and wxObject. Therefore, in most cases, the member functions of these three classes can be easily used. In the use of the dynamic event table, the most important functions Connect and Disconnect are the member functions of wxEvtHandler. We can bring it over to us for the wx class to handle the event.
Let's take a look at the introduction of the Connect function in the official documentation (I have translated and simplified it, and sometimes, for the sake of clarity of explanation, make some supplementary explanations):
| #TRANSLATE BEGIN wxEvtHandler::ConnectThe Connect function is overloaded three times, each with its own purpose. First version: range kill ([id, lastid] and eventType) void Connect (int id , int lastId , wxEventType eventType , wxObjectEventFunction function , wxObject*userData = NULL , wxEvtHandler* eventSink = NULL ) Second version: precise sniping (id and eventType) void Connect (int id , wxEventType eventType , wxObjectEventFunction function , wxObject* userData = NULL , wxEvtHandler* eventSink = NULL ) Third version: Categorize (eventType only) void Connect (wxEventType eventType , wxObjectEventFunction function , wxObject* userData = NULL ,wxEvtHandler* eventSink = NULL ) This function dynamically associates the given event handler with the EventHandler, ID and even the event type. This is an alternative to static event tables. Press: EventHandler is literally translated as an event handler, or can it be translated as "event handle" (lively imitating the handle)? The following uses "event handles". Parameter meaning: id
lastId
eventType
function
userData
eventSink
例子： frame->Connect( wxID_EXIT, wxEVT_COMMAND_MENU_SELECTED, wxCommandEventHandler(MyFrame::OnQuit) ); 对例子的解释： wxID_EXIT是之前赋给了某一个菜单项的ID。 当该菜单被选择时，会产生一个ID为wxEVT_COMMAND_MENU_SELECTED的事件。 因此MyFrame::OnQuit在被显式转换为wxCommandEventHandler型的“事件手柄”之后，被Connect拉过来处理该事件。 #TRANSLATE END |
就不再翻译Disconnect函数的文档了，因为除了函数名不同，它的所有参数和Connect是一模一样的。它的用途就是断开Connect所建立起来的联系。
实践中写事件处理的时候，通常使用的是Connect的后两种重载版本。参数userData和eventSink的使用是比较少的，而且也有默认值，一般不去理它就可以了。
参数id是你赋给产生了这个事件的窗口、菜单或控件的，你自己心里是清楚的。问题顶多是，你需要使用系统默认的那些ID（比如上面例子里的 wxID_EXIT），而你不知道哪个还哪个。那些ID的列表在官方文档里是有的，不过为了本文作为手册的完整性，将在本文最后给出。
有时是不需要id的，比如鼠标移动的事件：
frame->Connect(wxEVT_MOTION,wxMouseEventHandler(MyFrame::OnMouseMove));
直接把事件ID与事件手柄联系起来。 参数function 的问题大一些，就是这个显式强制类型转换的这个Handler，具体叫wx什么EventHandler呢？这个问题也好解决，因为官方文档里的 Classes By Category里的Event小节已经给出了形如wxFooEvent这样的事件类型的列表，只需要在相应的事件类型后面加上Handler就可以了。 同样为了本文作为手册的完整性，将在本文后面给出全部Handler的列表。
最大的问题出在参数eventType上。形如wxEVT_MOTION、wxEVT_COMMAND_MENU_SELECTED这样的事件ID的名 字，我们从何得知？这些奇形怪状的名字，纵然我们英语很强，也未必能造出和wxWidgets定义的一模一样的名字啊。比如写惯MFC的同好们很容易将鼠 标移动事件ID写为wxMOUSEMOVE或wxMOUSE_MOVE，可这却是错的。最糟糕的是，文档中没有提供这些名字的列表！
有些同好可能发现了，对大部份事件类型的静态事件表的宏的说明中，包含了这方面的重要信息，例如wxPaintEvent里：
EVT_PAINT(func) Process a wxEVT_PAINT event.
左边是静态事件表需要的，右边是动态事件表需要的。左手静态，右手动态，好潇洒啊！然而，倘若你要处理窗口关闭事件（假设该事件的产生不是通过菜单选择，而是点窗口右上角的红叉叉），你跑到wxCloseEvent那里一看：
EVT_CLOSE(func) Process a close event, supplying the member function. This event applies to wxFrame and wxDialog classes.
你晕了……为什么文档编写者连这都不肯告诉你？！于是你尝试着用wxEVT_CLOSE，编译器告诉你不对。已经习惯了没事翻翻头文件的你就跑 到<wx/event.h>里去找了，一搜索就出来了。 原来是wxEVT_CLOSE_WINDOW，这可真是情理之中意料之外啊，反正我当时是接近吐血了……
所幸这个情况并没有出现在大多数基本的事件里，但实际中总会需要处理那些不那么基本的事件的，每次都在这个细节上卡这么久的壳太不划算了。所以我把事件ID列表从<wx/event.h>中抽出来并加以翻译，大家放在手边备查吧。这是本文的主要写作目的。
说了一堆稀哩哗啦的废话，下面进入手册正文。
事件ID列表
·命令事件
wxEVT_COMMAND_BUTTON_CLICKED, 1 wxEVT_COMMAND_CHECKBOX_CLICKED, 2 wxEVT_COMMAND_CHOICE_SELECTED, 3 wxEVT_COMMAND_LISTBOX_SELECTED, 4 wxEVT_COMMAND_LISTBOX_DOUBLECLICKED, 5 wxEVT_COMMAND_CHECKLISTBOX_TOGGLED, 6
以下这一段事件ID由于版本更新，已经移到了<wx/textctrl.h>中进行定义。
#if WXWIN_COMPATIBILITY_EVENT_TYPES wxEVT_COMMAND_TEXT_UPDATED, 7 wxEVT_COMMAND_TEXT_ENTER, 8 wxEVT_COMMAND_TEXT_URL, 13 wxEVT_COMMAND_TEXT_MAXLEN, 14 #endif // WXWIN_COMPATIBILITY_EVENT_TYPES
wxEVT_COMMAND_MENU_SELECTED, 9 wxEVT_COMMAND_SLIDER_UPDATED, 10 wxEVT_COMMAND_RADIOBOX_SELECTED, 11 wxEVT_COMMAND_RADIOBUTTON_SELECTED, 12
wxEVT_COMMAND_SCROLLBAR_UPDATED 现在已废弃不用，转而使用wxEVT_SCROLL。
wxEVT_COMMAND_SCROLLBAR_UPDATED, 13 wxEVT_COMMAND_VLBOX_SELECTED, 14 wxEVT_COMMAND_COMBOBOX_SELECTED, 15 wxEVT_COMMAND_TOOL_RCLICKED, 16 wxEVT_COMMAND_TOOL_ENTER, 17 wxEVT_COMMAND_SPINCTRL_UPDATED, 18
以下两个事件也被废弃了// Sockets and timers send events, too
DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_BASE, wxEVT_SOCKET, 50) wxEVT_TIMER , 80
·鼠标事件
wxEVT_LEFT_DOWN, 100 wxEVT_LEFT_UP, 101 wxEVT_MIDDLE_DOWN, 102 wxEVT_MIDDLE_UP, 103 wxEVT_RIGHT_DOWN, 104 wxEVT_RIGHT_UP, 105 wxEVT_MOTION, 106 wxEVT_ENTER_WINDOW, 107 wxEVT_LEAVE_WINDOW, 108 wxEVT_LEFT_DCLICK, 109 wxEVT_MIDDLE_DCLICK, 110 wxEVT_RIGHT_DCLICK, 111 wxEVT_SET_FOCUS, 112 wxEVT_KILL_FOCUS, 113 wxEVT_CHILD_FOCUS, 114 wxEVT_MOUSEWHEEL, 115
·非客户区（Non-client）鼠标事件
wxEVT_NC_LEFT_DOWN, 200 wxEVT_NC_LEFT_UP, 201 wxEVT_NC_MIDDLE_DOWN, 202 wxEVT_NC_MIDDLE_UP, 203 wxEVT_NC_RIGHT_DOWN, 204 wxEVT_NC_RIGHT_UP, 205 wxEVT_NC_MOTION, 206 wxEVT_NC_ENTER_WINDOW, 207 wxEVT_NC_LEAVE_WINDOW, 208 wxEVT_NC_LEFT_DCLICK, 209 wxEVT_NC_MIDDLE_DCLICK, 210 wxEVT_NC_RIGHT_DCLICK, 211
·字符输入事件
wxEVT_CHAR, 212 wxEVT_CHAR_HOOK, 213 wxEVT_NAVIGATION_KEY, 214 wxEVT_KEY_DOWN, 215 wxEVT_KEY_UP, 216 #if wxUSE_HOTKEY wxEVT_HOTKEY, 217 #endif
·设置焦点（Cursor）事件
wxEVT_SET_CURSOR, 230
· 来自wxScrollBar控件和wxSlider控件的滚动事件
wxEVT_SCROLL_TOP, 300 wxEVT_SCROLL_BOTTOM, 301 wxEVT_SCROLL_LINEUP, 302 wxEVT_SCROLL_LINEDOWN, 303 wxEVT_SCROLL_PAGEUP, 304 wxEVT_SCROLL_PAGEDOWN, 305 wxEVT_SCROLL_THUMBTRACK, 306 wxEVT_SCROLL_THUMBRELEASE, 307 wxEVT_SCROLL_CHANGED, 308
·来自wxWindow的滚动事件
wxEVT_SCROLLWIN_TOP, 320 wxEVT_SCROLLWIN_BOTTOM, 321 wxEVT_SCROLLWIN_LINEUP, 322 wxEVT_SCROLLWIN_LINEDOWN, 323 wxEVT_SCROLLWIN_PAGEUP, 324 wxEVT_SCROLLWIN_PAGEDOWN, 325 wxEVT_SCROLLWIN_THUMBTRACK, 326 wxEVT_SCROLLWIN_THUMBRELEASE, 327
·系统事件
wxEVT_SIZE, 400 wxEVT_MOVE, 401 wxEVT_CLOSE_WINDOW, 402 wxEVT_END_SESSION, 403 wxEVT_QUERY_END_SESSION, 404 wxEVT_ACTIVATE_APP, 405 406..408 被用于关于电源的事件上，这里没有列出。如果想查看这些事件，可去看<wx/power.h >。 wxEVT_ACTIVATE, 409 wxEVT_CREATE, 410 wxEVT_DESTROY, 411 wxEVT_SHOW, 412 wxEVT_ICONIZE, 413 wxEVT_MAXIMIZE, 414 wxEVT_MOUSE_CAPTURE_CHANGED, 415 wxEVT_MOUSE_CAPTURE_LOST, 416 wxEVT_PAINT, 417 wxEVT_ERASE_BACKGROUND, 418 wxEVT_NC_PAINT, 419 wxEVT_PAINT_ICON, 420 wxEVT_MENU_OPEN, 421 wxEVT_MENU_CLOSE, 422 wxEVT_MENU_HIGHLIGHT, 423 wxEVT_CONTEXT_MENU, 424 wxEVT_SYS_COLOUR_CHANGED, 425 wxEVT_DISPLAY_CHANGED, 426 wxEVT_SETTING_CHANGED, 427 wxEVT_QUERY_NEW_PALETTE, 428 wxEVT_PALETTE_CHANGED, 429 wxEVT_JOY_BUTTON_DOWN, 430 wxEVT_JOY_BUTTON_UP, 431 wxEVT_JOY_MOVE, 432 wxEVT_JOY_ZMOVE, 433 wxEVT_DROP_FILES, 434 wxEVT_DRAW_ITEM, 435 wxEVT_MEASURE_ITEM, 436 wxEVT_COMPARE_ITEM, 437 wxEVT_INIT_DIALOG, 438 wxEVT_IDLE, 439 wxEVT_UPDATE_UI, 440 wxEVT_SIZING, 441 wxEVT_MOVING, 442 wxEVT_HIBERNATE, 443
·剪贴板事件
wxEVT_COMMAND_TEXT_COPY, 444 wxEVT_COMMAND_TEXT_CUT, 445 wxEVT_COMMAND_TEXT_PASTE, 446
·通用命令事件（注意，一个Click事件是比button down/up优先级更高的。
wxEVT_COMMAND_LEFT_CLICK, 500 wxEVT_COMMAND_LEFT_DCLICK, 501 wxEVT_COMMAND_RIGHT_CLICK, 502 wxEVT_COMMAND_RIGHT_DCLICK, 503 wxEVT_COMMAND_SET_FOCUS, 504 wxEVT_COMMAND_KILL_FOCUS, 505 wxEVT_COMMAND_ENTER, 506
·帮助事件
wxEVT_HELP, 1050 wxEVT_DETAILED_HELP, 1051
以下两个事件是等价的
wxEVT_COMMAND_TOOL_CLICKED wxEVT_COMMAND_MENU_SELECTED
事件手柄列表
wxCommandEventHandler
wxScrollEventHandler
wxScrollWinEventHandler
wxSizeEventHandler
wxMoveEventHandler
wxPaintEventHandler
wxNcPaintEventHandler
wxEraseEventHandler
wxMouseEventHandler
wxCharEventHandler
wxKeyEventHandler wxCharEventHandler
wxFocusEventHandler
wxChildFocusEventHandler
wxActivateEventHandler
wxMenuEventHandler
wxJoystickEventHandler
wxDropFilesEventHandler
wxInitDialogEventHandler
wxSysColourChangedEventHandler
wxDisplayChangedEventHandler
wxUpdateUIEventHandler
wxIdleEventHandler
wxCloseEventHandler
wxShowEventHandler
wxIconizeEventHandler
wxMaximizeEventHandler
wxNavigationKeyEventHandler
wxPaletteChangedEventHandler
wxQueryNewPaletteEventHandler
wxWindowCreateEventHandler
wxWindowDestroyEventHandler
wxSetCursorEventHandler
wxNotifyEventHandler
wxHelpEventHandler
wxContextMenuEventHandler
wxMouseCaptureChangedEventHandler
wxMouseCaptureLostEventHandler
wxClipboardTextEventHandler
wxWidgets定义的标识符列表（摘自《WxWidgets跨平台GUI开发》）
窗口标识符是在事件系统中用来唯一确定窗口的整数。事实上，在整个应用程序的范围内，窗口标识符不必一定是唯一的，而只要在某个固定的上下文(比如说，在 一个frame窗口和它的所有子窗口)内是唯一的就可以了。举例来说：你可以在无数个对话框中使用wxID_OK这个标识符，只要在某个对话框内不要重复 使用就可以了。
wxWidgets自动创建的标识符是总是一个负数，所以永远不会和用户定义的窗口标识符重复，用户定义的窗口标识符只能是正整数。
| 标识符名称 | 描述 | |
| wxID_ANY | 让wxWidgets自动产生一个标识符 | |
| wxID_LOWEST | 最小的系统标识符值 (4999) | |
| wxID_HIGHEST | 最大的系统标识符值 (5999) | |
| wxID_OPEN | 打开文件 | |
| wxID_CLOSE | 关闭窗口 | |
| wxID_NEW | 新建窗口文件或者文档 | |
| wxID_SAVE | 保存文件 | |
| wxID_SAVEAS | 文件另存为(应该弹出文件位置对话框) | |
| wxID_REVERT | 恢复文件在磁盘上的状态 | |
| wxID_EXIT | 退出应用程序 | |
| wxID_UNDO | 撤消最近一次操作 | |
| wxID_REDO | 重复最近一次操作 | |
| wxID_HELP | 帮助 (例如对话框上的帮助按钮可以用这个标识符) | |
| wxID_PRINT | 打印 | |
| wxID_PRINT_SETUP | 打印设置 | |
| wxID_PREVIEW | 打印预览 | |
| wxID_ABOUT | 显示一个用来描述整个程序的对话框 | |
| wxID_HELP_CONTENTS | 显示上下文帮助 | |
| wxID_HELP_COMMANDS | 显示应用程序命令 | |
| wxID_HELP_PROCEDURES | 显示应用程序过程 | |
| wxID_HELP_CONTEXT | 未使用 | |
| wxID_CUT | 剪切 | |
| wxID_COPY | 复制到剪贴板 | |
| wxID_PASTE | 粘贴 | |
| wxID_CLEAR | 清除 | |
| wxID_FIND | 查找 | |
| wxID_DUPLICATE | 复制 | |
| wxID_SELECTALL | 全选 | |
| wxID_DELETE | 删除 | |
| wxID_REPLACE | 覆盖 | |
| wxID_REPLACE_ALL | 全部覆盖 | |
| wxID_PROPERTIES | 查看属性 | |
| wxID_VIEW_DETAILS | 列表框中的按照详细信息方式显示 | |
| wxID_VIEW_LARGEICONS | 列表框按照大图标的方式显示 | |
| wxID_VIEW_SMALLICONS | 列表框中按照小图标的方式显示 | |
| wxID_VIEW_LIST | 列表框中按照列表的的方式显示 | |
| wxID_VIEW_SORTDATE | 按照日期排序 | |
| wxID_VIEW_SORTNAME | 按照名称排序 | |
| wxID_VIEW_SORTSIZE | 按照大小排序 | |
| wxID_VIEW_SORTTYPE | 按照类型排序 | |
| wxID_FILE1 to wxID_FILE9 | 显示最近使用的文件 | |
| wxID_OK | 确定 | |
| wxID_CANCEL | 取消 | |
| wxID_APPLY | 应用变更 | |
| wxID_YES | YES | |
| wxID_NO | No | |
| wxID_STATIC | 静态文本或者静态图片可以用这个标识符 | |
| wxID_FORWARD | 向前 | |
| wxID_BACKWARD | 向后 | |
| wxID_DEFAULT | 恢复默认设置 | |
| wxID_MORE | 显示更多选项 | |
| wxID_SETUP | 显示一个设置对话框 | |
| wxID_RESET | 重置所有选项 | |
| wxID_CONTEXT_HELP | 显示上下文帮助 | |
| wxID_YESTOALL | 全部选是 | |
| wxID_NOTOALL | 全部选否 | |
| wxID_ABORT | 中止当前操作 | |
| wxID_RETRY | 重试 | |
| wxID_IGNORE | 忽略错误 | |
| wxID_UP | 向上 | |
| wxID_DOWN | 向下 | |
| wxID_HOME | 首页 | |
| wxID_REFRESH | 刷新 | |
| wxID_STOP | 停止正在进行的操作 | |
| wxID_INDEX | 显示一个索引 | |
| wxID_BOLD | 加粗显示 | |
| wxID_ITALIC | 斜体显示 | |
| wxID_JUSTIFY_CENTER | 居中 | |
| wxID_JUSTIFY_FILL | 格式 | |
| wxID_JUSTIFY_RIGHT | 右对齐 | |
| wxID_JUSTIFY_LEFT | 左对齐 | |
| wxID_UNDERLINE | 下划线 | |
| wxID_INDENT | 缩进 | |
| wxID_UNINDENT | 反缩进 | |
| wxID_ZOOM_100 | 放大到100% | |
| wxID_ZOOM_FIT | 缩放到整页 | |
| wxID_ZOOM_IN | 放大 | |
| wxID_ZOOM_OUT | 缩小 | |
| wxID_UNDELETE | 反删除 | |
| wxID_REVERT_TO_SAVED | 恢复到上次保存的状态 |
为了避免你自己定义的标识符和这些预定义的标识符重复，你可以使用大于wxID_HIGHEST的标识符或者小于wxID_LOWEST的标识符。