1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: Event classes
4 // Author: Julian Smart
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
16 #pragma interface "event.h"
20 #include "wx/object.h"
23 #include "wx/gdicmn.h"
24 #include "wx/cursor.h"
27 #include "wx/thread.h"
29 // ----------------------------------------------------------------------------
30 // forward declarations
31 // ----------------------------------------------------------------------------
33 class WXDLLEXPORT wxList
;
36 class WXDLLEXPORT wxClientData
;
37 class WXDLLEXPORT wxDC
;
38 class WXDLLEXPORT wxMenu
;
39 class WXDLLEXPORT wxWindow
;
42 // ----------------------------------------------------------------------------
44 // ----------------------------------------------------------------------------
46 #if defined(__BORLANDC__) && defined(__WIN16__)
47 // For 16-bit BC++, these 2 would be identical otherwise (truncated)
48 #define wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGED wxEVT_COMMAND_NB_PAGE_CHANGED
49 #define wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGING wxEVT_COMMAND_NB_PAGE_CHANGING
52 typedef int wxEventType
;
54 // the standard event types
60 wxEVT_COMMAND_BUTTON_CLICKED
= wxEVT_FIRST
+ 1,
61 wxEVT_COMMAND_CHECKBOX_CLICKED
= wxEVT_FIRST
+ 2,
62 wxEVT_COMMAND_CHOICE_SELECTED
= wxEVT_FIRST
+ 3,
63 wxEVT_COMMAND_LISTBOX_SELECTED
= wxEVT_FIRST
+ 4,
64 wxEVT_COMMAND_LISTBOX_DOUBLECLICKED
= wxEVT_FIRST
+ 5,
65 wxEVT_COMMAND_CHECKLISTBOX_TOGGLED
= wxEVT_FIRST
+ 6,
66 wxEVT_COMMAND_TEXT_UPDATED
= wxEVT_FIRST
+ 7,
67 wxEVT_COMMAND_TEXT_ENTER
= wxEVT_FIRST
+ 8,
68 wxEVT_COMMAND_MENU_SELECTED
= wxEVT_FIRST
+ 9,
69 wxEVT_COMMAND_TOOL_CLICKED
= wxEVT_COMMAND_MENU_SELECTED
,
70 wxEVT_COMMAND_SLIDER_UPDATED
= wxEVT_FIRST
+ 10,
71 wxEVT_COMMAND_RADIOBOX_SELECTED
= wxEVT_FIRST
+ 11,
72 wxEVT_COMMAND_RADIOBUTTON_SELECTED
= wxEVT_FIRST
+ 12,
73 //wxEVT_COMMAND_SCROLLBAR_UPDATED is now obsolete since we use wxEVT_SCROLL... events
74 wxEVT_COMMAND_SCROLLBAR_UPDATED
= wxEVT_FIRST
+ 13,
75 wxEVT_COMMAND_VLBOX_SELECTED
= wxEVT_FIRST
+ 14,
76 wxEVT_COMMAND_COMBOBOX_SELECTED
= wxEVT_FIRST
+ 15,
77 wxEVT_COMMAND_TOOL_RCLICKED
= wxEVT_FIRST
+ 16,
78 wxEVT_COMMAND_TOOL_ENTER
= wxEVT_FIRST
+ 17,
79 wxEVT_COMMAND_SPINCTRL_UPDATED
= wxEVT_FIRST
+ 18,
81 /* Sockets and timers send events, too */
82 wxEVT_SOCKET
= wxEVT_FIRST
+ 50,
83 wxEVT_TIMER
= wxEVT_FIRST
+ 80,
85 /* Mouse event types */
86 wxEVT_LEFT_DOWN
= wxEVT_FIRST
+ 100,
87 wxEVT_LEFT_UP
= wxEVT_FIRST
+ 101,
88 wxEVT_MIDDLE_DOWN
= wxEVT_FIRST
+ 102,
89 wxEVT_MIDDLE_UP
= wxEVT_FIRST
+ 103,
90 wxEVT_RIGHT_DOWN
= wxEVT_FIRST
+ 104,
91 wxEVT_RIGHT_UP
= wxEVT_FIRST
+ 105,
92 wxEVT_MOTION
= wxEVT_FIRST
+ 106,
93 wxEVT_ENTER_WINDOW
= wxEVT_FIRST
+ 107,
94 wxEVT_LEAVE_WINDOW
= wxEVT_FIRST
+ 108,
95 wxEVT_LEFT_DCLICK
= wxEVT_FIRST
+ 109,
96 wxEVT_MIDDLE_DCLICK
= wxEVT_FIRST
+ 110,
97 wxEVT_RIGHT_DCLICK
= wxEVT_FIRST
+ 111,
98 wxEVT_SET_FOCUS
= wxEVT_FIRST
+ 112,
99 wxEVT_KILL_FOCUS
= wxEVT_FIRST
+ 113,
101 /* Non-client mouse events */
102 wxEVT_NC_LEFT_DOWN
= wxEVT_FIRST
+ 200,
103 wxEVT_NC_LEFT_UP
= wxEVT_FIRST
+ 201,
104 wxEVT_NC_MIDDLE_DOWN
= wxEVT_FIRST
+ 202,
105 wxEVT_NC_MIDDLE_UP
= wxEVT_FIRST
+ 203,
106 wxEVT_NC_RIGHT_DOWN
= wxEVT_FIRST
+ 204,
107 wxEVT_NC_RIGHT_UP
= wxEVT_FIRST
+ 205,
108 wxEVT_NC_MOTION
= wxEVT_FIRST
+ 206,
109 wxEVT_NC_ENTER_WINDOW
= wxEVT_FIRST
+ 207,
110 wxEVT_NC_LEAVE_WINDOW
= wxEVT_FIRST
+ 208,
111 wxEVT_NC_LEFT_DCLICK
= wxEVT_FIRST
+ 209,
112 wxEVT_NC_MIDDLE_DCLICK
= wxEVT_FIRST
+ 210,
113 wxEVT_NC_RIGHT_DCLICK
= wxEVT_FIRST
+ 211,
115 /* Character input event type */
116 wxEVT_CHAR
= wxEVT_FIRST
+ 212,
117 wxEVT_CHAR_HOOK
= wxEVT_FIRST
+ 213,
118 wxEVT_NAVIGATION_KEY
= wxEVT_FIRST
+ 214,
119 wxEVT_KEY_DOWN
= wxEVT_FIRST
+ 215,
120 wxEVT_KEY_UP
= wxEVT_FIRST
+ 216,
122 /* Set cursor event */
123 wxEVT_SET_CURSOR
= wxEVT_FIRST
+ 230,
126 * wxScrollbar and wxSlider event identifiers
128 wxEVT_SCROLL_TOP
= wxEVT_FIRST
+ 300,
129 wxEVT_SCROLL_BOTTOM
= wxEVT_FIRST
+ 301,
130 wxEVT_SCROLL_LINEUP
= wxEVT_FIRST
+ 302,
131 wxEVT_SCROLL_LINEDOWN
= wxEVT_FIRST
+ 303,
132 wxEVT_SCROLL_PAGEUP
= wxEVT_FIRST
+ 304,
133 wxEVT_SCROLL_PAGEDOWN
= wxEVT_FIRST
+ 305,
134 wxEVT_SCROLL_THUMBTRACK
= wxEVT_FIRST
+ 306,
135 wxEVT_SCROLL_THUMBRELEASE
= wxEVT_FIRST
+ 307,
138 * Scroll events from wxWindow
140 wxEVT_SCROLLWIN_TOP
= wxEVT_FIRST
+ 320,
141 wxEVT_SCROLLWIN_BOTTOM
= wxEVT_FIRST
+ 321,
142 wxEVT_SCROLLWIN_LINEUP
= wxEVT_FIRST
+ 322,
143 wxEVT_SCROLLWIN_LINEDOWN
= wxEVT_FIRST
+ 323,
144 wxEVT_SCROLLWIN_PAGEUP
= wxEVT_FIRST
+ 324,
145 wxEVT_SCROLLWIN_PAGEDOWN
= wxEVT_FIRST
+ 325,
146 wxEVT_SCROLLWIN_THUMBTRACK
= wxEVT_FIRST
+ 326,
147 wxEVT_SCROLLWIN_THUMBRELEASE
= wxEVT_FIRST
+ 327,
152 wxEVT_SIZE
= wxEVT_FIRST
+ 400,
153 wxEVT_MOVE
= wxEVT_FIRST
+ 401,
154 wxEVT_CLOSE_WINDOW
= wxEVT_FIRST
+ 402,
155 wxEVT_END_SESSION
= wxEVT_FIRST
+ 403,
156 wxEVT_QUERY_END_SESSION
= wxEVT_FIRST
+ 404,
157 wxEVT_ACTIVATE_APP
= wxEVT_FIRST
+ 405,
158 wxEVT_POWER
= wxEVT_FIRST
+ 406,
159 wxEVT_ACTIVATE
= wxEVT_FIRST
+ 409,
160 wxEVT_CREATE
= wxEVT_FIRST
+ 410,
161 wxEVT_DESTROY
= wxEVT_FIRST
+ 411,
162 wxEVT_SHOW
= wxEVT_FIRST
+ 412,
163 wxEVT_ICONIZE
= wxEVT_FIRST
+ 413,
164 wxEVT_MAXIMIZE
= wxEVT_FIRST
+ 414,
165 wxEVT_MOUSE_CAPTURE_CHANGED
= wxEVT_FIRST
+ 415,
166 wxEVT_PAINT
= wxEVT_FIRST
+ 416,
167 wxEVT_ERASE_BACKGROUND
= wxEVT_FIRST
+ 417,
168 wxEVT_NC_PAINT
= wxEVT_FIRST
+ 418,
169 wxEVT_PAINT_ICON
= wxEVT_FIRST
+ 419,
170 wxEVT_MENU_CHAR
= wxEVT_FIRST
+ 420,
171 wxEVT_MENU_INIT
= wxEVT_FIRST
+ 421,
172 wxEVT_MENU_HIGHLIGHT
= wxEVT_FIRST
+ 422,
173 wxEVT_POPUP_MENU_INIT
= wxEVT_FIRST
+ 423,
174 wxEVT_CONTEXT_MENU
= wxEVT_FIRST
+ 424,
175 wxEVT_SYS_COLOUR_CHANGED
= wxEVT_FIRST
+ 425,
176 wxEVT_SETTING_CHANGED
= wxEVT_FIRST
+ 426,
177 wxEVT_QUERY_NEW_PALETTE
= wxEVT_FIRST
+ 427,
178 wxEVT_PALETTE_CHANGED
= wxEVT_FIRST
+ 428,
179 wxEVT_JOY_BUTTON_DOWN
= wxEVT_FIRST
+ 429,
180 wxEVT_JOY_BUTTON_UP
= wxEVT_FIRST
+ 430,
181 wxEVT_JOY_MOVE
= wxEVT_FIRST
+ 431,
182 wxEVT_JOY_ZMOVE
= wxEVT_FIRST
+ 432,
183 wxEVT_DROP_FILES
= wxEVT_FIRST
+ 433,
184 wxEVT_DRAW_ITEM
= wxEVT_FIRST
+ 434,
185 wxEVT_MEASURE_ITEM
= wxEVT_FIRST
+ 435,
186 wxEVT_COMPARE_ITEM
= wxEVT_FIRST
+ 436,
187 wxEVT_INIT_DIALOG
= wxEVT_FIRST
+ 437,
188 wxEVT_IDLE
= wxEVT_FIRST
+ 438,
189 wxEVT_UPDATE_UI
= wxEVT_FIRST
+ 439,
192 wxEVT_END_PROCESS
= wxEVT_FIRST
+ 440,
195 wxEVT_DIALUP_CONNECTED
= wxEVT_FIRST
+ 450,
196 wxEVT_DIALUP_DISCONNECTED
= wxEVT_FIRST
+ 451,
198 /* Generic command events */
199 /* Note: a click is a higher-level event than button down/up */
200 wxEVT_COMMAND_LEFT_CLICK
= wxEVT_FIRST
+ 500,
201 wxEVT_COMMAND_LEFT_DCLICK
= wxEVT_FIRST
+ 501,
202 wxEVT_COMMAND_RIGHT_CLICK
= wxEVT_FIRST
+ 502,
203 wxEVT_COMMAND_RIGHT_DCLICK
= wxEVT_FIRST
+ 503,
204 wxEVT_COMMAND_SET_FOCUS
= wxEVT_FIRST
+ 504,
205 wxEVT_COMMAND_KILL_FOCUS
= wxEVT_FIRST
+ 505,
206 wxEVT_COMMAND_ENTER
= wxEVT_FIRST
+ 506,
208 /* Tree control event types */
209 wxEVT_COMMAND_TREE_BEGIN_DRAG
= wxEVT_FIRST
+ 600,
210 wxEVT_COMMAND_TREE_BEGIN_RDRAG
= wxEVT_FIRST
+ 601,
211 wxEVT_COMMAND_TREE_BEGIN_LABEL_EDIT
= wxEVT_FIRST
+ 602,
212 wxEVT_COMMAND_TREE_END_LABEL_EDIT
= wxEVT_FIRST
+ 603,
213 wxEVT_COMMAND_TREE_DELETE_ITEM
= wxEVT_FIRST
+ 604,
214 wxEVT_COMMAND_TREE_GET_INFO
= wxEVT_FIRST
+ 605,
215 wxEVT_COMMAND_TREE_SET_INFO
= wxEVT_FIRST
+ 606,
216 wxEVT_COMMAND_TREE_ITEM_EXPANDED
= wxEVT_FIRST
+ 607,
217 wxEVT_COMMAND_TREE_ITEM_EXPANDING
= wxEVT_FIRST
+ 608,
218 wxEVT_COMMAND_TREE_ITEM_COLLAPSED
= wxEVT_FIRST
+ 609,
219 wxEVT_COMMAND_TREE_ITEM_COLLAPSING
= wxEVT_FIRST
+ 610,
220 wxEVT_COMMAND_TREE_SEL_CHANGED
= wxEVT_FIRST
+ 611,
221 wxEVT_COMMAND_TREE_SEL_CHANGING
= wxEVT_FIRST
+ 612,
222 wxEVT_COMMAND_TREE_KEY_DOWN
= wxEVT_FIRST
+ 613,
223 wxEVT_COMMAND_TREE_ITEM_ACTIVATED
= wxEVT_FIRST
+ 614,
224 wxEVT_COMMAND_TREE_ITEM_RIGHT_CLICK
= wxEVT_FIRST
+ 615,
225 wxEVT_COMMAND_TREE_ITEM_MIDDLE_CLICK
= wxEVT_FIRST
+ 616,
226 wxEVT_COMMAND_TREE_END_DRAG
= wxEVT_FIRST
+ 617,
228 /* List control event types */
229 wxEVT_COMMAND_LIST_BEGIN_DRAG
= wxEVT_FIRST
+ 700,
230 wxEVT_COMMAND_LIST_BEGIN_RDRAG
= wxEVT_FIRST
+ 701,
231 wxEVT_COMMAND_LIST_BEGIN_LABEL_EDIT
= wxEVT_FIRST
+ 702,
232 wxEVT_COMMAND_LIST_END_LABEL_EDIT
= wxEVT_FIRST
+ 703,
233 wxEVT_COMMAND_LIST_DELETE_ITEM
= wxEVT_FIRST
+ 704,
234 wxEVT_COMMAND_LIST_DELETE_ALL_ITEMS
= wxEVT_FIRST
+ 705,
235 wxEVT_COMMAND_LIST_GET_INFO
= wxEVT_FIRST
+ 706,
236 wxEVT_COMMAND_LIST_SET_INFO
= wxEVT_FIRST
+ 707,
237 wxEVT_COMMAND_LIST_ITEM_SELECTED
= wxEVT_FIRST
+ 708,
238 wxEVT_COMMAND_LIST_ITEM_DESELECTED
= wxEVT_FIRST
+ 709,
239 wxEVT_COMMAND_LIST_KEY_DOWN
= wxEVT_FIRST
+ 710,
240 wxEVT_COMMAND_LIST_INSERT_ITEM
= wxEVT_FIRST
+ 711,
241 wxEVT_COMMAND_LIST_COL_CLICK
= wxEVT_FIRST
+ 712,
242 wxEVT_COMMAND_LIST_ITEM_RIGHT_CLICK
= wxEVT_FIRST
+ 713,
243 wxEVT_COMMAND_LIST_ITEM_MIDDLE_CLICK
= wxEVT_FIRST
+ 714,
244 wxEVT_COMMAND_LIST_ITEM_ACTIVATED
= wxEVT_FIRST
+ 715,
246 /* Tab and notebook control event types */
247 wxEVT_COMMAND_TAB_SEL_CHANGED
= wxEVT_FIRST
+ 800,
248 wxEVT_COMMAND_TAB_SEL_CHANGING
= wxEVT_FIRST
+ 801,
249 wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGED
= wxEVT_FIRST
+ 802,
250 wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGING
= wxEVT_FIRST
+ 803,
252 /* Splitter events */
253 wxEVT_COMMAND_SPLITTER_SASH_POS_CHANGED
= wxEVT_FIRST
+ 850,
254 wxEVT_COMMAND_SPLITTER_SASH_POS_CHANGING
= wxEVT_FIRST
+ 851,
255 wxEVT_COMMAND_SPLITTER_DOUBLECLICKED
= wxEVT_FIRST
+ 852,
256 wxEVT_COMMAND_SPLITTER_UNSPLIT
= wxEVT_FIRST
+ 853,
259 wxEVT_WIZARD_PAGE_CHANGED
= wxEVT_FIRST
+ 900,
260 wxEVT_WIZARD_PAGE_CHANGING
= wxEVT_FIRST
+ 901,
261 wxEVT_WIZARD_CANCEL
= wxEVT_FIRST
+ 902,
263 /* Calendar events */
264 wxEVT_CALENDAR_SEL_CHANGED
= wxEVT_FIRST
+ 950,
265 wxEVT_CALENDAR_DAY_CHANGED
= wxEVT_FIRST
+ 951,
266 wxEVT_CALENDAR_MONTH_CHANGED
= wxEVT_FIRST
+ 952,
267 wxEVT_CALENDAR_YEAR_CHANGED
= wxEVT_FIRST
+ 953,
268 wxEVT_CALENDAR_DOUBLECLICKED
= wxEVT_FIRST
+ 954,
269 wxEVT_CALENDAR_WEEKDAY_CLICKED
= wxEVT_FIRST
+ 955,
272 wxEVT_PLOT_SEL_CHANGING
= wxEVT_FIRST
+ 1000,
273 wxEVT_PLOT_SEL_CHANGED
= wxEVT_FIRST
+ 1001,
274 wxEVT_PLOT_CLICKED
= wxEVT_FIRST
+ 1002,
275 wxEVT_PLOT_DOUBLECLICKED
= wxEVT_FIRST
+ 1003,
276 wxEVT_PLOT_ZOOM_IN
= wxEVT_FIRST
+ 1004,
277 wxEVT_PLOT_ZOOM_OUT
= wxEVT_FIRST
+ 1005,
278 wxEVT_PLOT_VALUE_SEL_CREATING
= wxEVT_FIRST
+ 1010,
279 wxEVT_PLOT_VALUE_SEL_CREATED
= wxEVT_FIRST
+ 1011,
280 wxEVT_PLOT_VALUE_SEL_CHANGING
= wxEVT_FIRST
+ 1012,
281 wxEVT_PLOT_VALUE_SEL_CHANGED
= wxEVT_FIRST
+ 1013,
282 wxEVT_PLOT_AREA_SEL_CREATING
= wxEVT_FIRST
+ 1014,
283 wxEVT_PLOT_AREA_SEL_CREATED
= wxEVT_FIRST
+ 1015,
284 wxEVT_PLOT_AREA_SEL_CHANGING
= wxEVT_FIRST
+ 1016,
285 wxEVT_PLOT_AREA_SEL_CHANGED
= wxEVT_FIRST
+ 1017,
286 wxEVT_PLOT_BEGIN_X_LABEL_EDIT
= wxEVT_FIRST
+ 1020,
287 wxEVT_PLOT_END_X_LABEL_EDIT
= wxEVT_FIRST
+ 1021,
288 wxEVT_PLOT_BEGIN_Y_LABEL_EDIT
= wxEVT_FIRST
+ 1022,
289 wxEVT_PLOT_END_Y_LABEL_EDIT
= wxEVT_FIRST
+ 1023,
290 wxEVT_PLOT_BEGIN_TITLE_EDIT
= wxEVT_FIRST
+ 1024,
291 wxEVT_PLOT_END_TITLE_EDIT
= wxEVT_FIRST
+ 1025,
292 wxEVT_PLOT_AREA_CREATE
= wxEVT_FIRST
+ 1026,
294 wxEVT_USER_FIRST
= wxEVT_FIRST
+ 2000
299 #if WXWIN_COMPATIBILITY
301 #define wxEVENT_TYPE_BUTTON_COMMAND wxEVT_COMMAND_BUTTON_CLICKED
302 #define wxEVENT_TYPE_CHECKBOX_COMMAND wxEVT_COMMAND_CHECKBOX_CLICKED
303 #define wxEVENT_TYPE_CHOICE_COMMAND wxEVT_COMMAND_CHOICE_SELECTED
304 #define wxEVENT_TYPE_LISTBOX_COMMAND wxEVT_COMMAND_LISTBOX_SELECTED
305 #define wxEVENT_TYPE_LISTBOX_DCLICK_COMMAND wxEVT_COMMAND_LISTBOX_DOUBLECLICKED
306 #define wxEVENT_TYPE_TEXT_COMMAND wxEVT_COMMAND_TEXT_UPDATED
307 #define wxEVENT_TYPE_MULTITEXT_COMMAND wxEVT_COMMAND_TEXT_UPDATED
308 #define wxEVENT_TYPE_MENU_COMMAND wxEVT_COMMAND_MENU_SELECTED
309 #define wxEVENT_TYPE_SLIDER_COMMAND wxEVT_COMMAND_SLIDER_UPDATED
310 #define wxEVENT_TYPE_RADIOBOX_COMMAND wxEVT_COMMAND_RADIOBOX_SELECTED
311 #define wxEVENT_TYPE_RADIOBUTTON_COMMAND wxEVT_COMMAND_RADIOBUTTON_SELECTED
312 #define wxEVENT_TYPE_TEXT_ENTER_COMMAND wxEVT_COMMAND_TEXT_ENTER
313 #define wxEVENT_TYPE_SET_FOCUS wxEVT_SET_FOCUS
314 #define wxEVENT_TYPE_KILL_FOCUS wxEVT_KILL_FOCUS
315 #define wxEVENT_TYPE_SCROLLBAR_COMMAND wxEVT_COMMAND_SCROLLBAR_UPDATED
316 #define wxEVENT_TYPE_VIRT_LISTBOX_COMMAND wxEVT_COMMAND_VLBOX_SELECTED
317 #define wxEVENT_TYPE_COMBOBOX_COMMAND wxEVT_COMMAND_COMBOBOX_SELECTED
319 #define wxEVENT_TYPE_LEFT_DOWN wxEVT_LEFT_DOWN
320 #define wxEVENT_TYPE_LEFT_UP wxEVT_LEFT_UP
321 #define wxEVENT_TYPE_MIDDLE_DOWN wxEVT_MIDDLE_DOWN
322 #define wxEVENT_TYPE_MIDDLE_UP wxEVT_MIDDLE_UP
323 #define wxEVENT_TYPE_RIGHT_DOWN wxEVT_RIGHT_DOWN
324 #define wxEVENT_TYPE_RIGHT_UP wxEVT_RIGHT_UP
325 #define wxEVENT_TYPE_MOTION wxEVT_MOTION
326 #define wxEVENT_TYPE_ENTER_WINDOW wxEVT_ENTER_WINDOW
327 #define wxEVENT_TYPE_LEAVE_WINDOW wxEVT_LEAVE_WINDOW
328 #define wxEVENT_TYPE_LEFT_DCLICK wxEVT_LEFT_DCLICK
329 #define wxEVENT_TYPE_MIDDLE_DCLICK wxEVT_MIDDLE_DCLICK
330 #define wxEVENT_TYPE_RIGHT_DCLICK wxEVT_RIGHT_DCLICK
331 #define wxEVENT_TYPE_CHAR wxEVT_CHAR
332 #define wxEVENT_TYPE_SCROLL_TOP wxEVT_SCROLL_TOP
333 #define wxEVENT_TYPE_SCROLL_BOTTOM wxEVT_SCROLL_BOTTOM
334 #define wxEVENT_TYPE_SCROLL_LINEUP wxEVT_SCROLL_LINEUP
335 #define wxEVENT_TYPE_SCROLL_LINEDOWN wxEVT_SCROLL_LINEDOWN
336 #define wxEVENT_TYPE_SCROLL_PAGEUP wxEVT_SCROLL_PAGEUP
337 #define wxEVENT_TYPE_SCROLL_PAGEDOWN wxEVT_SCROLL_PAGEDOWN
338 #define wxEVENT_TYPE_SCROLL_THUMBTRACK wxEVT_SCROLL_THUMBTRACK
340 #endif // WXWIN_COMPATIBILITY
343 * wxWindows events, covering all interesting things that might happen
344 * (button clicking, resizing, setting text in widgets, etc.).
346 * For each completely new event type, derive a new event class.
347 * An event CLASS represents a C++ class defining a range of similar event TYPES;
348 * examples are canvas events, panel item command events.
349 * An event TYPE is a unique identifier for a particular system event,
350 * such as a button press or a listbox deselection.
354 class WXDLLEXPORT wxEvent
: public wxObject
356 DECLARE_ABSTRACT_CLASS(wxEvent
)
362 void SetEventType(wxEventType typ
) { m_eventType
= typ
; }
363 wxEventType
GetEventType() const { return m_eventType
; }
364 wxObject
*GetEventObject() const { return m_eventObject
; }
365 void SetEventObject(wxObject
*obj
) { m_eventObject
= obj
; }
366 long GetTimestamp() const { return m_timeStamp
; }
367 void SetTimestamp(long ts
= 0) { m_timeStamp
= ts
; }
368 int GetId() const { return m_id
; }
369 void SetId(int Id
) { m_id
= Id
; }
371 // Can instruct event processor that we wish to ignore this event
372 // (treat as if the event table entry had not been found): this must be done
373 // to allow the event processing by the base classes (calling event.Skip()
374 // is the analog of calling the base class verstion of a virtual function)
375 void Skip(bool skip
= TRUE
) { m_skipped
= skip
; }
376 bool GetSkipped() const { return m_skipped
; };
378 // implementation only: this test is explicitlty anti OO and this functions
379 // exists only for optimization purposes
380 bool IsCommandEvent() const { return m_isCommandEvent
; }
382 void CopyObject(wxObject
& object_dest
) const;
385 wxObject
* m_eventObject
;
386 wxEventType m_eventType
;
389 wxObject
* m_callbackUserData
;
392 // optimization: instead of using costly IsKindOf() we keep a flag telling
393 // whether we're a command event (by far the most common case)
394 bool m_isCommandEvent
;
399 // Item or menu event class
401 wxEVT_COMMAND_BUTTON_CLICKED
402 wxEVT_COMMAND_CHECKBOX_CLICKED
403 wxEVT_COMMAND_CHOICE_SELECTED
404 wxEVT_COMMAND_LISTBOX_SELECTED
405 wxEVT_COMMAND_LISTBOX_DOUBLECLICKED
406 wxEVT_COMMAND_TEXT_UPDATED
407 wxEVT_COMMAND_TEXT_ENTER
408 wxEVT_COMMAND_MENU_SELECTED
409 wxEVT_COMMAND_SLIDER_UPDATED
410 wxEVT_COMMAND_RADIOBOX_SELECTED
411 wxEVT_COMMAND_RADIOBUTTON_SELECTED
412 wxEVT_COMMAND_SCROLLBAR_UPDATED
413 wxEVT_COMMAND_VLBOX_SELECTED
414 wxEVT_COMMAND_COMBOBOX_SELECTED
417 class WXDLLEXPORT wxCommandEvent
: public wxEvent
419 DECLARE_DYNAMIC_CLASS(wxCommandEvent
)
422 wxCommandEvent(wxEventType commandType
= wxEVT_NULL
, int id
= 0);
426 * Accessors dependent on context
430 // Set/Get client data from controls
431 void SetClientData(void* clientData
) { m_clientData
= clientData
; }
432 void *GetClientData() const { return m_clientData
; }
434 // Set/Get client object from controls
435 void SetClientObject(wxClientData
* clientObject
) { m_clientObject
= clientObject
; }
436 void *GetClientObject() const { return m_clientObject
; }
438 // Get listbox selection if single-choice
439 int GetSelection() const { return m_commandInt
; }
441 // Set/Get listbox/choice selection string
442 void SetString(const wxString
& s
) { m_commandString
= s
; }
443 wxString
GetString() const { return m_commandString
; }
445 // Get checkbox value
446 bool Checked() const { return (m_commandInt
!= 0); }
448 // TRUE if the listbox event was a selection.
449 bool IsSelection() const { return (m_extraLong
!= 0); }
451 void SetExtraLong(long extraLong
) { m_extraLong
= extraLong
; }
452 long GetExtraLong() const { return m_extraLong
; }
454 void SetInt(int i
) { m_commandInt
= i
; }
455 long GetInt() const { return m_commandInt
; }
457 void CopyObject(wxObject
& obj
) const;
460 wxString m_commandString
; // String event argument
462 long m_extraLong
; // Additional information (e.g. select/deselect)
463 void* m_clientData
; // Arbitrary client data
464 wxClientData
* m_clientObject
; // Arbitrary client object
467 // this class adds a possibility to react (from the user) code to a control
468 // notification: allow or veto the operation being reported.
469 class WXDLLEXPORT wxNotifyEvent
: public wxCommandEvent
472 wxNotifyEvent(wxEventType commandType
= wxEVT_NULL
, int id
= 0)
473 : wxCommandEvent(commandType
, id
) { m_bAllow
= TRUE
; }
475 // veto the operation (usually it's allowed by default)
476 void Veto() { m_bAllow
= FALSE
; }
478 // allow the operation if it was disabled by default
479 void Allow() { m_bAllow
= TRUE
; }
481 // for implementation code only: is the operation allowed?
482 bool IsAllowed() const { return m_bAllow
; }
484 // probably useless: CopyObject() is used for deferred event
485 // handling but wxNotifyEvent must be processed immediately
486 void CopyObject(wxObject
& obj
) const;
491 DECLARE_DYNAMIC_CLASS(wxNotifyEvent
)
494 // Scroll event class, derived form wxCommandEvent. wxScrollEvents are
495 // sent by wxSlider and wxScrollbar.
500 wxEVT_SCROLL_LINEDOWN
502 wxEVT_SCROLL_PAGEDOWN
503 wxEVT_SCROLL_THUMBTRACK
504 wxEVT_SCROLL_THUMBRELEASE
507 class WXDLLEXPORT wxScrollEvent
: public wxCommandEvent
509 DECLARE_DYNAMIC_CLASS(wxScrollEvent
)
512 wxScrollEvent(wxEventType commandType
= wxEVT_NULL
,
513 int id
= 0, int pos
= 0, int orient
= 0);
521 int GetOrientation() const { return (int) m_extraLong
; }
522 int GetPosition() const { return m_commandInt
; }
523 void SetOrientation(int orient
) { m_extraLong
= (long) orient
; }
524 void SetPosition(int pos
) { m_commandInt
= pos
; }
527 // ScrollWin event class, derived fom wxEvent. wxScrollWinEvents
528 // are sent by wxWindow.
531 wxEVT_SCROLLWIN_BOTTOM
532 wxEVT_SCROLLWIN_LINEUP
533 wxEVT_SCROLLWIN_LINEDOWN
534 wxEVT_SCROLLWIN_PAGEUP
535 wxEVT_SCROLLWIN_PAGEDOWN
536 wxEVT_SCROLLWIN_THUMBTRACK
537 wxEVT_SCROLLWIN_THUMBRELEASE
540 class WXDLLEXPORT wxScrollWinEvent
: public wxEvent
542 DECLARE_DYNAMIC_CLASS(wxScrollWinEvent
)
545 wxScrollWinEvent(wxEventType commandType
= wxEVT_NULL
,
546 int pos
= 0, int orient
= 0);
547 ~wxScrollWinEvent() {}
553 int GetOrientation() const { return (int) m_extraLong
; }
554 int GetPosition() const { return m_commandInt
; }
555 void SetOrientation(int orient
) { m_extraLong
= (long) orient
; }
556 void SetPosition(int pos
) { m_commandInt
= pos
; }
558 void CopyObject(wxObject
& object_dest
) const;
560 int m_commandInt
; // Additional information
581 wxEVT_NC_MIDDLE_DOWN,
586 wxEVT_NC_ENTER_WINDOW,
587 wxEVT_NC_LEAVE_WINDOW,
588 wxEVT_NC_LEFT_DCLICK,
589 wxEVT_NC_MIDDLE_DCLICK,
590 wxEVT_NC_RIGHT_DCLICK,
593 class WXDLLEXPORT wxMouseEvent
: public wxEvent
595 DECLARE_DYNAMIC_CLASS(wxMouseEvent
)
598 wxMouseEvent(wxEventType mouseType
= wxEVT_NULL
);
600 // Was it a button event? (*doesn't* mean: is any button *down*?)
601 bool IsButton() const { return Button(-1); }
603 // Was it a down event from button 1, 2 or 3 or any?
604 bool ButtonDown(int but
= -1) const;
606 // Was it a dclick event from button 1, 2 or 3 or any?
607 bool ButtonDClick(int but
= -1) const;
609 // Was it a up event from button 1, 2 or 3 or any?
610 bool ButtonUp(int but
= -1) const;
612 // Was the given button 1,2,3 or any changing state?
613 bool Button(int but
) const;
615 // Was the given button 1,2,3 or any in Down state?
616 bool ButtonIsDown(int but
) const;
618 // Find state of shift/control keys
619 bool ControlDown() const { return m_controlDown
; }
620 bool MetaDown() const { return m_metaDown
; }
621 bool AltDown() const { return m_altDown
; }
622 bool ShiftDown() const { return m_shiftDown
; }
624 // Find which event was just generated
625 bool LeftDown() const { return (m_eventType
== wxEVT_LEFT_DOWN
); }
626 bool MiddleDown() const { return (m_eventType
== wxEVT_MIDDLE_DOWN
); }
627 bool RightDown() const { return (m_eventType
== wxEVT_RIGHT_DOWN
); }
629 bool LeftUp() const { return (m_eventType
== wxEVT_LEFT_UP
); }
630 bool MiddleUp() const { return (m_eventType
== wxEVT_MIDDLE_UP
); }
631 bool RightUp() const { return (m_eventType
== wxEVT_RIGHT_UP
); }
633 bool LeftDClick() const { return (m_eventType
== wxEVT_LEFT_DCLICK
); }
634 bool MiddleDClick() const { return (m_eventType
== wxEVT_MIDDLE_DCLICK
); }
635 bool RightDClick() const { return (m_eventType
== wxEVT_RIGHT_DCLICK
); }
637 // Find the current state of the mouse buttons (regardless
638 // of current event type)
639 bool LeftIsDown() const { return m_leftDown
; }
640 bool MiddleIsDown() const { return m_middleDown
; }
641 bool RightIsDown() const { return m_rightDown
; }
643 // True if a button is down and the mouse is moving
644 bool Dragging() const
646 return ((m_eventType
== wxEVT_MOTION
) &&
647 (LeftIsDown() || MiddleIsDown() || RightIsDown()));
650 // True if the mouse is moving, and no button is down
651 bool Moving() const { return (m_eventType
== wxEVT_MOTION
); }
653 // True if the mouse is just entering the window
654 bool Entering() const { return (m_eventType
== wxEVT_ENTER_WINDOW
); }
656 // True if the mouse is just leaving the window
657 bool Leaving() const { return (m_eventType
== wxEVT_LEAVE_WINDOW
); }
659 // Find the position of the event
660 void GetPosition(wxCoord
*xpos
, wxCoord
*ypos
) const
669 void GetPosition(long *xpos
, long *ypos
) const
678 // Find the position of the event
679 wxPoint
GetPosition() const { return wxPoint(m_x
, m_y
); }
681 // Find the logical position of the event given the DC
682 wxPoint
GetLogicalPosition(const wxDC
& dc
) const ;
685 #if WXWIN_COMPATIBILITY
686 void Position(long *xpos
, long *ypos
) const
694 void Position(float *xpos
, float *ypos
) const
696 *xpos
= (float) m_x
; *ypos
= (float) m_y
;
698 #endif // WXWIN_COMPATIBILITY
701 wxCoord
GetX() const { return m_x
; }
704 wxCoord
GetY() const { return m_y
; }
706 void CopyObject(wxObject
& obj
) const;
727 class WXDLLEXPORT wxSetCursorEvent
: public wxEvent
730 wxSetCursorEvent(wxCoord x
, wxCoord y
)
732 m_eventType
= wxEVT_SET_CURSOR
;
738 wxCoord
GetX() const { return m_x
; }
739 wxCoord
GetY() const { return m_y
; }
741 void SetCursor(const wxCursor
& cursor
) { m_cursor
= cursor
; }
742 const wxCursor
& GetCursor() const { return m_cursor
; }
743 bool HasCursor() const { return m_cursor
.Ok(); }
750 // Keyboard input event class
759 class WXDLLEXPORT wxKeyEvent
: public wxEvent
761 DECLARE_DYNAMIC_CLASS(wxKeyEvent
)
764 wxKeyEvent(wxEventType keyType
= wxEVT_NULL
);
766 // Find state of shift/control keys
767 bool ControlDown() const { return m_controlDown
; }
768 bool MetaDown() const { return m_metaDown
; }
769 bool AltDown() const { return m_altDown
; }
770 bool ShiftDown() const { return m_shiftDown
; }
772 bool HasModifiers() const { return ControlDown() || AltDown() || MetaDown(); }
774 // get the key code: an ASCII7 char or an element of wxKeyCode enum
775 int GetKeyCode() const { return (int)m_keyCode
; }
777 // Find the position of the event
778 void GetPosition(wxCoord
*xpos
, wxCoord
*ypos
) const
780 if (xpos
) *xpos
= m_x
;
781 if (ypos
) *ypos
= m_y
;
785 void GetPosition(long *xpos
, long *ypos
) const
787 if (xpos
) *xpos
= (long)m_x
;
788 if (ypos
) *ypos
= (long)m_y
;
792 wxPoint
GetPosition() const
793 { return wxPoint(m_x
, m_y
); }
796 wxCoord
GetX() const { return m_x
; }
799 wxCoord
GetY() const { return m_y
; }
801 void CopyObject(wxObject
& obj
) const;
804 long KeyCode() const { return m_keyCode
; }
823 class WXDLLEXPORT wxSizeEvent
: public wxEvent
825 DECLARE_DYNAMIC_CLASS(wxSizeEvent
)
830 wxSizeEvent() { m_eventType
= wxEVT_SIZE
; }
831 wxSizeEvent(const wxSize
& sz
, int id
= 0)
833 { m_eventType
= wxEVT_SIZE
; m_id
= id
; }
835 wxSize
GetSize() const { return m_size
; }
837 void CopyObject(wxObject
& obj
) const;
846 class WXDLLEXPORT wxMoveEvent
: public wxEvent
848 DECLARE_DYNAMIC_CLASS(wxMoveEvent
)
853 wxMoveEvent() { m_eventType
= wxEVT_MOVE
; }
854 wxMoveEvent(const wxPoint
& pos
, int id
= 0)
856 { m_eventType
= wxEVT_MOVE
; m_id
= id
; }
858 wxPoint
GetPosition() const { return m_pos
; }
860 void CopyObject(wxObject
& obj
) const;
870 #if defined(__WXDEBUG__) && defined(__WXMSW__)
871 // see comments in src/msw/dcclient.cpp where g_isPainting is defined
872 extern int g_isPainting
;
875 class WXDLLEXPORT wxPaintEvent
: public wxEvent
877 DECLARE_DYNAMIC_CLASS(wxPaintEvent
)
880 wxPaintEvent(int Id
= 0)
882 m_eventType
= wxEVT_PAINT
;
885 #if defined(__WXDEBUG__) && defined(__WXMSW__)
886 // set the internal flag for the duration of processing of WM_PAINT
891 #if defined(__WXDEBUG__) && defined(__WXMSW__)
899 // Erase background event class
901 wxEVT_ERASE_BACKGROUND
904 class WXDLLEXPORT wxEraseEvent
: public wxEvent
906 DECLARE_DYNAMIC_CLASS(wxEraseEvent
)
911 wxEraseEvent(int Id
= 0, wxDC
*dc
= (wxDC
*) NULL
)
912 { m_eventType
= wxEVT_ERASE_BACKGROUND
; m_id
= Id
; m_dc
= dc
; }
913 wxDC
*GetDC() const { return m_dc
; }
915 void CopyObject(wxObject
& obj
) const;
924 class WXDLLEXPORT wxFocusEvent
: public wxEvent
926 DECLARE_DYNAMIC_CLASS(wxFocusEvent
)
929 wxFocusEvent(wxEventType type
= wxEVT_NULL
, int Id
= 0)
930 { m_eventType
= type
; m_id
= Id
; }
933 // Activate event class
939 class WXDLLEXPORT wxActivateEvent
: public wxEvent
941 DECLARE_DYNAMIC_CLASS(wxActivateEvent
)
944 wxActivateEvent(wxEventType type
= wxEVT_NULL
, bool active
= TRUE
, int Id
= 0)
945 { m_eventType
= type
; m_active
= active
; m_id
= Id
; }
946 bool GetActive() const { return m_active
; }
948 void CopyObject(wxObject
& obj
) const;
954 // InitDialog event class
959 class WXDLLEXPORT wxInitDialogEvent
: public wxEvent
961 DECLARE_DYNAMIC_CLASS(wxInitDialogEvent
)
964 wxInitDialogEvent(int Id
= 0)
965 { m_eventType
= wxEVT_INIT_DIALOG
; m_id
= Id
; }
968 // Miscellaneous menu event class
972 wxEVT_MENU_HIGHLIGHT,
973 wxEVT_POPUP_MENU_INIT,
977 class WXDLLEXPORT wxMenuEvent
: public wxEvent
979 DECLARE_DYNAMIC_CLASS(wxMenuEvent
)
982 wxMenuEvent(wxEventType type
= wxEVT_NULL
, int id
= 0)
983 { m_eventType
= type
; m_menuId
= id
; }
985 int GetMenuId() const { return m_menuId
; }
987 void CopyObject(wxObject
& obj
) const;
992 // Window close or session close event class
996 wxEVT_QUERY_END_SESSION
999 class WXDLLEXPORT wxCloseEvent
: public wxEvent
1001 DECLARE_DYNAMIC_CLASS(wxCloseEvent
)
1004 wxCloseEvent(wxEventType type
= wxEVT_NULL
, int id
= 0)
1007 m_loggingOff
= TRUE
;
1008 m_veto
= FALSE
; // should be FALSE by default
1010 #if WXWIN_COMPATIBILITY
1012 #endif // WXWIN_COMPATIBILITY
1016 void SetLoggingOff(bool logOff
) { m_loggingOff
= logOff
; }
1017 bool GetLoggingOff() const { return m_loggingOff
; }
1019 void Veto(bool veto
= TRUE
)
1021 // GetVeto() will return FALSE anyhow...
1022 wxCHECK_RET( m_canVeto
,
1023 wxT("call to Veto() ignored (can't veto this event)") );
1027 void SetCanVeto(bool canVeto
) { m_canVeto
= canVeto
; }
1028 // No more asserts here please, the one you put here was wrong.
1029 bool CanVeto() const { return m_canVeto
; }
1030 bool GetVeto() const { return m_canVeto
&& m_veto
; }
1032 #if WXWIN_COMPATIBILITY
1033 // This is probably obsolete now, since we use CanVeto instead, in
1034 // both OnCloseWindow and OnQueryEndSession.
1035 // m_force == ! m_canVeto i.e., can't veto means we must force it to close.
1036 void SetForce(bool force
) { m_force
= force
; }
1037 bool GetForce() const { return m_force
; }
1040 void CopyObject(wxObject
& obj
) const;
1044 bool m_veto
, m_canVeto
;
1046 #if WXWIN_COMPATIBILITY
1055 class WXDLLEXPORT wxShowEvent
: public wxEvent
1057 DECLARE_DYNAMIC_CLASS(wxShowEvent
)
1061 wxShowEvent(int id
= 0, bool show
= FALSE
)
1062 { m_eventType
= wxEVT_SHOW
; m_id
= id
; m_show
= show
; }
1064 void SetShow(bool show
) { m_show
= show
; }
1065 bool GetShow() const { return m_show
; }
1067 void CopyObject(wxObject
& obj
) const;
1077 class WXDLLEXPORT wxIconizeEvent
: public wxEvent
1079 DECLARE_DYNAMIC_CLASS(wxIconizeEvent
)
1082 wxIconizeEvent(int id
= 0)
1083 { m_eventType
= wxEVT_ICONIZE
; m_id
= id
; }
1090 class WXDLLEXPORT wxMaximizeEvent
: public wxEvent
1092 DECLARE_DYNAMIC_CLASS(wxMaximizeEvent
)
1095 wxMaximizeEvent(int id
= 0)
1096 { m_eventType
= wxEVT_MAXIMIZE
; m_id
= id
; }
1099 // Joystick event class
1101 wxEVT_JOY_BUTTON_DOWN,
1102 wxEVT_JOY_BUTTON_UP,
1107 // Which joystick? Same as Windows ids so no conversion necessary.
1108 #define wxJOYSTICK1 0
1109 #define wxJOYSTICK2 1
1111 // Which button is down?
1112 #define wxJOY_BUTTON1 1
1113 #define wxJOY_BUTTON2 2
1114 #define wxJOY_BUTTON3 4
1115 #define wxJOY_BUTTON4 8
1116 #define wxJOY_BUTTON_ANY -1
1118 class WXDLLEXPORT wxJoystickEvent
: public wxEvent
1120 DECLARE_DYNAMIC_CLASS(wxJoystickEvent
)
1125 int m_buttonChange
; // Which button changed?
1126 int m_buttonState
; // Which buttons are down?
1127 int m_joyStick
; // Which joystick?
1129 wxJoystickEvent(wxEventType type
= wxEVT_NULL
,
1131 int joystick
= wxJOYSTICK1
,
1135 m_buttonState
= state
;
1136 m_pos
= wxPoint(0,0);
1138 m_joyStick
= joystick
;
1139 m_buttonChange
= change
;
1142 wxPoint
GetPosition() const { return m_pos
; }
1143 int GetZPosition() const { return m_zPosition
; }
1144 int GetButtonState() const { return m_buttonState
; }
1145 int GetButtonChange() const { return m_buttonChange
; }
1146 int GetJoystick() const { return m_joyStick
; }
1148 void SetJoystick(int stick
) { m_joyStick
= stick
; }
1149 void SetButtonState(int state
) { m_buttonState
= state
; }
1150 void SetButtonChange(int change
) { m_buttonChange
= change
; }
1151 void SetPosition(const wxPoint
& pos
) { m_pos
= pos
; }
1152 void SetZPosition(int zPos
) { m_zPosition
= zPos
; }
1154 // Was it a button event? (*doesn't* mean: is any button *down*?)
1155 bool IsButton() const { return ((GetEventType() == wxEVT_JOY_BUTTON_DOWN
) ||
1156 (GetEventType() == wxEVT_JOY_BUTTON_UP
)); }
1158 // Was it a move event?
1159 bool IsMove() const { return (GetEventType() == wxEVT_JOY_MOVE
) ; }
1161 // Was it a zmove event?
1162 bool IsZMove() const { return (GetEventType() == wxEVT_JOY_ZMOVE
) ; }
1164 // Was it a down event from button 1, 2, 3, 4 or any?
1165 bool ButtonDown(int but
= wxJOY_BUTTON_ANY
) const
1166 { return ((GetEventType() == wxEVT_JOY_BUTTON_DOWN
) &&
1167 ((but
== wxJOY_BUTTON_ANY
) || (but
== m_buttonChange
))); }
1169 // Was it a up event from button 1, 2, 3 or any?
1170 bool ButtonUp(int but
= wxJOY_BUTTON_ANY
) const
1171 { return ((GetEventType() == wxEVT_JOY_BUTTON_UP
) &&
1172 ((but
== wxJOY_BUTTON_ANY
) || (but
== m_buttonChange
))); }
1174 // Was the given button 1,2,3,4 or any in Down state?
1175 bool ButtonIsDown(int but
= wxJOY_BUTTON_ANY
) const
1176 { return (((but
== wxJOY_BUTTON_ANY
) && (m_buttonState
!= 0)) ||
1177 ((m_buttonState
& but
) == but
)); }
1179 void CopyObject(wxObject
& obj
) const;
1182 // Drop files event class
1187 class WXDLLEXPORT wxDropFilesEvent
: public wxEvent
1189 DECLARE_DYNAMIC_CLASS(wxDropFilesEvent
)
1194 wxString
* m_files
; // Memory (de)allocated by code calling ProcessEvent
1196 wxDropFilesEvent(wxEventType type
= wxEVT_NULL
,
1198 wxString
*files
= (wxString
*) NULL
)
1199 { m_eventType
= type
; m_noFiles
= noFiles
; m_files
= files
; }
1201 wxPoint
GetPosition() const { return m_pos
; }
1202 int GetNumberOfFiles() const { return m_noFiles
; }
1203 wxString
*GetFiles() const { return m_files
; }
1205 void CopyObject(wxObject
& obj
) const;
1213 class WXDLLEXPORT wxUpdateUIEvent
: public wxCommandEvent
1215 DECLARE_DYNAMIC_CLASS(wxUpdateUIEvent
)
1218 wxUpdateUIEvent(wxWindowID commandId
= 0)
1220 m_eventType
= wxEVT_UPDATE_UI
;
1223 m_setChecked
= FALSE
;
1225 m_setEnabled
= FALSE
;
1230 bool GetChecked() const { return m_checked
; }
1231 bool GetEnabled() const { return m_enabled
; }
1232 wxString
GetText() const { return m_text
; }
1233 bool GetSetText() const { return m_setText
; }
1234 bool GetSetChecked() const { return m_setChecked
; }
1235 bool GetSetEnabled() const { return m_setEnabled
; }
1237 void Check(bool check
) { m_checked
= check
; m_setChecked
= TRUE
; }
1238 void Enable(bool enable
) { m_enabled
= enable
; m_setEnabled
= TRUE
; }
1239 void SetText(const wxString
& text
) { m_text
= text
; m_setText
= TRUE
; }
1241 void CopyObject(wxObject
& obj
) const;
1253 wxEVT_SYS_COLOUR_CHANGED
1256 // TODO: shouldn't all events record the window ID?
1257 class WXDLLEXPORT wxSysColourChangedEvent
: public wxEvent
1259 DECLARE_DYNAMIC_CLASS(wxSysColourChangedEvent
)
1262 wxSysColourChangedEvent()
1263 { m_eventType
= wxEVT_SYS_COLOUR_CHANGED
; }
1267 wxEVT_PALETTE_CHANGED
1270 class WXDLLEXPORT wxPaletteChangedEvent
: public wxEvent
1272 DECLARE_DYNAMIC_CLASS(wxPaletteChangedEvent
)
1275 wxPaletteChangedEvent(wxWindowID id
= 0) : wxEvent(id
)
1277 m_eventType
= wxEVT_PALETTE_CHANGED
;
1278 m_changedWindow
= (wxWindow
*) NULL
;
1281 void SetChangedWindow(wxWindow
* win
) { m_changedWindow
= win
; }
1282 wxWindow
* GetChangedWindow() const { return m_changedWindow
; }
1284 void CopyObject(wxObject
& obj
) const;
1287 wxWindow
* m_changedWindow
;
1291 wxEVT_QUERY_NEW_PALETTE
1292 Indicates the window is getting keyboard focus and should re-do its palette.
1295 class WXDLLEXPORT wxQueryNewPaletteEvent
: public wxEvent
1297 DECLARE_DYNAMIC_CLASS(wxQueryNewPaletteEvent
)
1300 wxQueryNewPaletteEvent(wxWindowID id
= 0): wxEvent(id
)
1301 { m_eventType
= wxEVT_QUERY_NEW_PALETTE
; m_paletteRealized
= FALSE
; }
1303 // App sets this if it changes the palette.
1304 void SetPaletteRealized(bool realized
) { m_paletteRealized
= realized
; }
1305 bool GetPaletteRealized() const { return m_paletteRealized
; }
1307 void CopyObject(wxObject
& obj
) const;
1310 bool m_paletteRealized
;
1314 Event generated by dialog navigation keys
1315 wxEVT_NAVIGATION_KEY
1317 // NB: don't derive from command event to avoid being propagated to the parent
1318 class WXDLLEXPORT wxNavigationKeyEvent
: public wxEvent
1321 wxNavigationKeyEvent()
1323 SetEventType(wxEVT_NAVIGATION_KEY
);
1325 m_flags
= IsForward
| Propagate
; // defaults are for TAB
1326 m_focus
= (wxWindow
*)NULL
;
1329 // direction: forward (true) or backward (false)
1330 bool GetDirection() const
1331 { return (m_flags
& IsForward
) != 0; }
1332 void SetDirection(bool bForward
)
1333 { if ( bForward
) m_flags
|= IsForward
; else m_flags
&= ~IsForward
; }
1335 // it may be a window change event (MDI, notebook pages...) or a control
1337 bool IsWindowChange() const
1338 { return (m_flags
& WinChange
) != 0; }
1339 void SetWindowChange(bool bIs
)
1340 { if ( bIs
) m_flags
|= WinChange
; else m_flags
&= ~WinChange
; }
1342 // some navigation events are meant to be propagated upwards (Windows
1343 // convention is to do this for TAB events) while others should always
1344 // cycle inside the panel/radiobox/whatever we're current inside
1345 bool ShouldPropagate() const
1346 { return (m_flags
& Propagate
) != 0; }
1347 void SetPropagate(bool bDoIt
)
1348 { if ( bDoIt
) m_flags
|= Propagate
; else m_flags
&= ~Propagate
; }
1350 // the child which has the focus currently (may be NULL - use
1351 // wxWindow::FindFocus then)
1352 wxWindow
* GetCurrentFocus() const { return m_focus
; }
1353 void SetCurrentFocus(wxWindow
*win
) { m_focus
= win
; }
1366 DECLARE_DYNAMIC_CLASS(wxNavigationKeyEvent
)
1369 // Window creation/destruction events: the first is sent as soon as window is
1370 // created (i.e. the underlying GUI object exists), but when the C++ object is
1371 // fully initialized (so virtual functions may be called). The second,
1372 // wxEVT_DESTROY, is sent right before the window is destroyed - again, it's
1373 // still safe to call virtual functions at this moment
1379 class WXDLLEXPORT wxWindowCreateEvent
: public wxCommandEvent
1381 DECLARE_DYNAMIC_CLASS(wxWindowCreateEvent
)
1384 wxWindowCreateEvent(wxWindow
*win
= NULL
);
1386 wxWindow
*GetWindow() const { return (wxWindow
*)GetEventObject(); }
1389 class WXDLLEXPORT wxWindowDestroyEvent
: public wxCommandEvent
1391 DECLARE_DYNAMIC_CLASS(wxWindowDestroyEvent
)
1394 wxWindowDestroyEvent(wxWindow
*win
= NULL
);
1396 wxWindow
*GetWindow() const { return (wxWindow
*)GetEventObject(); }
1406 class WXDLLEXPORT wxIdleEvent
: public wxEvent
1408 DECLARE_DYNAMIC_CLASS(wxIdleEvent
)
1412 { m_eventType
= wxEVT_IDLE
; m_requestMore
= FALSE
; }
1414 void RequestMore(bool needMore
= TRUE
) { m_requestMore
= needMore
; }
1415 bool MoreRequested() const { return m_requestMore
; }
1417 void CopyObject(wxObject
& obj
) const;
1425 wxEVT_MOUSE_CAPTURE_CHANGED,
1426 wxEVT_SETTING_CHANGED, // WM_WININICHANGE (NT) / WM_SETTINGCHANGE (Win95)
1427 // wxEVT_FONT_CHANGED, // WM_FONTCHANGE: roll into wxEVT_SETTING_CHANGED, but remember to propagate
1428 // wxEVT_FONT_CHANGED to all other windows (maybe).
1429 wxEVT_DRAW_ITEM, // Leave these three as virtual functions in wxControl?? Platform-specific.
1434 // ============================================================================
1435 // event handler and related classes
1436 // ============================================================================
1438 typedef void (wxObject::*wxObjectEventFunction
)(wxEvent
&);
1440 struct WXDLLEXPORT wxEventTableEntry
1442 // For some reason, this can't be wxEventType, or VC++ complains.
1443 int m_eventType
; // main event type
1444 int m_id
; // control/menu/toolbar id
1445 int m_lastId
; // used for ranges of ids
1446 wxObjectEventFunction m_fn
; // function to call: not wxEventFunction,
1447 // because of dependency problems
1449 wxObject
* m_callbackUserData
;
1452 struct WXDLLEXPORT wxEventTable
1454 const wxEventTable
*baseTable
; // Points to base event table (next in chain)
1455 const wxEventTableEntry
*entries
; // Points to bottom of entry array
1458 class WXDLLEXPORT wxEvtHandler
: public wxObject
1460 DECLARE_DYNAMIC_CLASS(wxEvtHandler
)
1466 wxEvtHandler
*GetNextHandler() const { return m_nextHandler
; }
1467 wxEvtHandler
*GetPreviousHandler() const { return m_previousHandler
; }
1468 void SetNextHandler(wxEvtHandler
*handler
) { m_nextHandler
= handler
; }
1469 void SetPreviousHandler(wxEvtHandler
*handler
) { m_previousHandler
= handler
; }
1471 void SetEvtHandlerEnabled(bool enabled
) { m_enabled
= enabled
; }
1472 bool GetEvtHandlerEnabled() const { return m_enabled
; }
1474 // process an event right now
1475 virtual bool ProcessEvent(wxEvent
& event
);
1477 // add an event to be processed later
1478 void AddPendingEvent(wxEvent
& event
);
1480 // process all pending events
1481 void ProcessPendingEvents();
1485 bool ProcessThreadEvent(wxEvent
& event
);
1488 // Dynamic association of a member function handler with the event handler,
1489 // id and event type
1490 void Connect( int id
, int lastId
, wxEventType eventType
,
1491 wxObjectEventFunction func
,
1492 wxObject
*userData
= (wxObject
*) NULL
);
1494 // Convenience function: take just one id
1495 void Connect( int id
, wxEventType eventType
,
1496 wxObjectEventFunction func
,
1497 wxObject
*userData
= (wxObject
*) NULL
)
1498 { Connect(id
, -1, eventType
, func
, userData
); }
1500 bool Disconnect( int id
, int lastId
= -1, wxEventType eventType
= wxEVT_NULL
,
1501 wxObjectEventFunction func
= NULL
,
1502 wxObject
*userData
= (wxObject
*) NULL
);
1504 // Convenience function: take just one id
1505 bool Disconnect( int id
, wxEventType eventType
= wxEVT_NULL
,
1506 wxObjectEventFunction func
= NULL
,
1507 wxObject
*userData
= (wxObject
*) NULL
)
1508 { return Disconnect(id
, -1, eventType
, func
, userData
); }
1510 // implementation from now on
1511 virtual bool SearchEventTable(wxEventTable
& table
, wxEvent
& event
);
1512 bool SearchDynamicEventTable( wxEvent
& event
);
1515 void ClearEventLocker()
1517 # if !defined(__VISAGECPP__)
1518 delete m_eventsLocker
;
1519 m_eventsLocker
= NULL
;
1526 #if WXWIN_COMPATIBILITY_2
1527 virtual void OnCommand(wxWindow
& WXUNUSED(win
),
1528 wxCommandEvent
& WXUNUSED(event
))
1530 wxFAIL_MSG(wxT("shouldn't be called any more"));
1533 // Called if child control has no callback function
1534 virtual long Default()
1535 { return GetNextHandler() ? GetNextHandler()->Default() : 0; };
1536 #endif // WXWIN_COMPATIBILITY_2
1538 #if WXWIN_COMPATIBILITY
1539 virtual bool OnClose();
1543 static const wxEventTableEntry sm_eventTableEntries
[];
1546 static const wxEventTable sm_eventTable
;
1548 virtual const wxEventTable
*GetEventTable() const;
1551 wxEvtHandler
* m_nextHandler
;
1552 wxEvtHandler
* m_previousHandler
;
1553 wxList
* m_dynamicEvents
;
1554 wxList
* m_pendingEvents
;
1556 #if defined (__VISAGECPP__)
1557 wxCriticalSection m_eventsLocker
;
1559 wxCriticalSection
* m_eventsLocker
;
1563 // optimization: instead of using costly IsKindOf() to decide whether we're
1564 // a window (which is true in 99% of cases), use this flag
1567 // Is event handler enabled?
1571 typedef void (wxEvtHandler::*wxEventFunction
)(wxEvent
&);
1573 typedef void (wxEvtHandler::*wxCommandEventFunction
)(wxCommandEvent
&);
1574 typedef void (wxEvtHandler::*wxScrollEventFunction
)(wxScrollEvent
&);
1575 typedef void (wxEvtHandler::*wxScrollWinEventFunction
)(wxScrollWinEvent
&);
1576 typedef void (wxEvtHandler::*wxSizeEventFunction
)(wxSizeEvent
&);
1577 typedef void (wxEvtHandler::*wxMoveEventFunction
)(wxMoveEvent
&);
1578 typedef void (wxEvtHandler::*wxPaintEventFunction
)(wxPaintEvent
&);
1579 typedef void (wxEvtHandler::*wxEraseEventFunction
)(wxEraseEvent
&);
1580 typedef void (wxEvtHandler::*wxMouseEventFunction
)(wxMouseEvent
&);
1581 typedef void (wxEvtHandler::*wxCharEventFunction
)(wxKeyEvent
&);
1582 typedef void (wxEvtHandler::*wxFocusEventFunction
)(wxFocusEvent
&);
1583 typedef void (wxEvtHandler::*wxActivateEventFunction
)(wxActivateEvent
&);
1584 typedef void (wxEvtHandler::*wxMenuEventFunction
)(wxMenuEvent
&);
1585 typedef void (wxEvtHandler::*wxJoystickEventFunction
)(wxJoystickEvent
&);
1586 typedef void (wxEvtHandler::*wxDropFilesEventFunction
)(wxDropFilesEvent
&);
1587 typedef void (wxEvtHandler::*wxInitDialogEventFunction
)(wxInitDialogEvent
&);
1588 typedef void (wxEvtHandler::*wxSysColourChangedFunction
)(wxSysColourChangedEvent
&);
1589 typedef void (wxEvtHandler::*wxUpdateUIEventFunction
)(wxUpdateUIEvent
&);
1590 typedef void (wxEvtHandler::*wxIdleEventFunction
)(wxIdleEvent
&);
1591 typedef void (wxEvtHandler::*wxCloseEventFunction
)(wxCloseEvent
&);
1592 typedef void (wxEvtHandler::*wxShowEventFunction
)(wxShowEvent
&);
1593 typedef void (wxEvtHandler::*wxIconizeEventFunction
)(wxShowEvent
&);
1594 typedef void (wxEvtHandler::*wxMaximizeEventFunction
)(wxShowEvent
&);
1595 typedef void (wxEvtHandler::*wxNavigationKeyEventFunction
)(wxNavigationKeyEvent
&);
1596 typedef void (wxEvtHandler::*wxPaletteChangedEventFunction
)(wxPaletteChangedEvent
&);
1597 typedef void (wxEvtHandler::*wxQueryNewPaletteEventFunction
)(wxQueryNewPaletteEvent
&);
1598 typedef void (wxEvtHandler::*wxWindowCreateEventFunction
)(wxWindowCreateEvent
&);
1599 typedef void (wxEvtHandler::*wxWindowDestroyEventFunction
)(wxWindowDestroyEvent
&);
1600 typedef void (wxEvtHandler::*wxSetCursorEventFunction
)(wxSetCursorEvent
&);
1601 typedef void (wxEvtHandler::*wxNotifyEventFunction
)(wxNotifyEvent
&);
1604 // N.B. In GNU-WIN32, you *have* to take the address of a member function
1605 // (use &) or the compiler crashes...
1607 #define DECLARE_EVENT_TABLE() \
1609 static const wxEventTableEntry sm_eventTableEntries[];\
1611 static const wxEventTable sm_eventTable;\
1612 virtual const wxEventTable* GetEventTable() const;
1614 #define BEGIN_EVENT_TABLE(theClass, baseClass) \
1615 const wxEventTable *theClass::GetEventTable() const { return &theClass::sm_eventTable; }\
1616 const wxEventTable theClass::sm_eventTable =\
1617 { &baseClass::sm_eventTable, &theClass::sm_eventTableEntries[0] };\
1618 const wxEventTableEntry theClass::sm_eventTableEntries[] = { \
1620 #define END_EVENT_TABLE() \
1621 { 0, 0, 0, 0, 0 } };
1624 * Event table macros
1628 #define EVT_CUSTOM(event, id, func) { event, id, -1, (wxObjectEventFunction) (wxEventFunction) & func, (wxObject *) NULL },
1629 #define EVT_CUSTOM_RANGE(event, id1, id2, func) { event, id1, id2, (wxObjectEventFunction) (wxEventFunction) & func, (wxObject *) NULL },
1632 #define EVT_SIZE(func) { wxEVT_SIZE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxSizeEventFunction) & func, (wxObject *) NULL },
1633 #define EVT_MOVE(func) { wxEVT_MOVE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMoveEventFunction) & func, (wxObject *) NULL },
1634 #define EVT_CLOSE(func) { wxEVT_CLOSE_WINDOW, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCloseEventFunction) & func, (wxObject *) NULL },
1635 #define EVT_END_SESSION(func) { wxEVT_END_SESSION, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCloseEventFunction) & func, (wxObject *) NULL },
1636 #define EVT_QUERY_END_SESSION(func) { wxEVT_QUERY_END_SESSION, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCloseEventFunction) & func, (wxObject *) NULL },
1637 #define EVT_PAINT(func) { wxEVT_PAINT, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxPaintEventFunction) & func, (wxObject *) NULL },
1638 #define EVT_ERASE_BACKGROUND(func) { wxEVT_ERASE_BACKGROUND, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxEraseEventFunction) & func, (wxObject *) NULL },
1639 #define EVT_CHAR(func) { wxEVT_CHAR, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCharEventFunction) & func, (wxObject *) NULL },
1640 #define EVT_KEY_DOWN(func) { wxEVT_KEY_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCharEventFunction) & func, (wxObject *) NULL },
1641 #define EVT_KEY_UP(func) { wxEVT_KEY_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCharEventFunction) & func, (wxObject *) NULL },
1642 #define EVT_CHAR_HOOK(func) { wxEVT_CHAR_HOOK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCharEventFunction) & func, NULL },
1643 #define EVT_MENU_HIGHLIGHT(id, func) { wxEVT_MENU_HIGHLIGHT, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxMenuEventFunction) & func, (wxObject *) NULL },
1644 #define EVT_MENU_HIGHLIGHT_ALL(func) { wxEVT_MENU_HIGHLIGHT, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMenuEventFunction) & func, (wxObject *) NULL },
1645 #define EVT_SET_FOCUS(func) { wxEVT_SET_FOCUS, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxFocusEventFunction) & func, (wxObject *) NULL },
1646 #define EVT_KILL_FOCUS(func) { wxEVT_KILL_FOCUS, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxFocusEventFunction) & func, (wxObject *) NULL },
1647 #define EVT_ACTIVATE(func) { wxEVT_ACTIVATE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxActivateEventFunction) & func, (wxObject *) NULL },
1648 #define EVT_ACTIVATE_APP(func) { wxEVT_ACTIVATE_APP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxActivateEventFunction) & func, (wxObject *) NULL },
1649 #define EVT_END_SESSION(func) { wxEVT_END_SESSION, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCloseEventFunction) & func, (wxObject *) NULL },
1650 #define EVT_QUERY_END_SESSION(func) { wxEVT_QUERY_END_SESSION, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCloseEventFunction) & func, (wxObject *) NULL },
1651 #define EVT_DROP_FILES(func) { wxEVT_DROP_FILES, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxDropFilesEventFunction) & func, (wxObject *) NULL },
1652 #define EVT_INIT_DIALOG(func) { wxEVT_INIT_DIALOG, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxInitDialogEventFunction) & func, (wxObject *) NULL },
1653 #define EVT_SYS_COLOUR_CHANGED(func) { wxEVT_SYS_COLOUR_CHANGED, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxSysColourChangedFunction) & func, (wxObject *) NULL },
1654 #define EVT_SHOW(func) { wxEVT_SHOW, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxShowEventFunction) & func, (wxObject *) NULL },
1655 #define EVT_MAXIMIZE(func) { wxEVT_MAXIMIZE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMaximizeEventFunction) & func, (wxObject *) NULL },
1656 #define EVT_ICONIZE(func) { wxEVT_ICONIZE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxIconizeEventFunction) & func, (wxObject *) NULL },
1657 #define EVT_NAVIGATION_KEY(func) { wxEVT_NAVIGATION_KEY, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) (wxNavigationKeyEventFunction) & func, (wxObject *) NULL },
1658 #define EVT_PALETTE_CHANGED(func) { wxEVT_PALETTE_CHANGED, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxPaletteChangedEventFunction) & func, (wxObject *) NULL },
1659 #define EVT_QUERY_NEW_PALETTE(func) { wxEVT_QUERY_NEW_PALETTE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxQueryNewPaletteEventFunction) & func, (wxObject *) NULL },
1660 #define EVT_WINDOW_CREATE(func) { wxEVT_CREATE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxWindowCreateEventFunction) & func, (wxObject *) NULL },
1661 #define EVT_WINDOW_DESTROY(func) { wxEVT_DESTROY, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxWindowDestroyEventFunction) & func, (wxObject *) NULL },
1662 #define EVT_SET_CURSOR(func) { wxEVT_SET_CURSOR, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxSetCursorEventFunction) & func, (wxObject *) NULL },
1665 #define EVT_LEFT_DOWN(func) { wxEVT_LEFT_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1666 #define EVT_LEFT_UP(func) { wxEVT_LEFT_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1667 #define EVT_MIDDLE_DOWN(func) { wxEVT_MIDDLE_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1668 #define EVT_MIDDLE_UP(func) { wxEVT_MIDDLE_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1669 #define EVT_RIGHT_DOWN(func) { wxEVT_RIGHT_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1670 #define EVT_RIGHT_UP(func) { wxEVT_RIGHT_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1671 #define EVT_MOTION(func) { wxEVT_MOTION, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1672 #define EVT_LEFT_DCLICK(func) { wxEVT_LEFT_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1673 #define EVT_MIDDLE_DCLICK(func) { wxEVT_MIDDLE_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1674 #define EVT_RIGHT_DCLICK(func) { wxEVT_RIGHT_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1675 #define EVT_LEAVE_WINDOW(func) { wxEVT_LEAVE_WINDOW, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1676 #define EVT_ENTER_WINDOW(func) { wxEVT_ENTER_WINDOW, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1679 #define EVT_MOUSE_EVENTS(func) \
1680 { wxEVT_LEFT_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1681 { wxEVT_LEFT_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1682 { wxEVT_MIDDLE_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1683 { wxEVT_MIDDLE_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1684 { wxEVT_RIGHT_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1685 { wxEVT_RIGHT_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1686 { wxEVT_MOTION, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1687 { wxEVT_LEFT_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1688 { wxEVT_MIDDLE_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1689 { wxEVT_RIGHT_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1690 { wxEVT_ENTER_WINDOW, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1691 { wxEVT_LEAVE_WINDOW, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1694 #define EVT_COMMAND(id, event, fn) { event, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1695 #define EVT_COMMAND_RANGE(id1, id2, event, fn) { event, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1697 // Scrolling from wxWindow (sent to wxScrolledWindow)
1698 #define EVT_SCROLLWIN(func) \
1699 { wxEVT_SCROLLWIN_TOP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },\
1700 { wxEVT_SCROLLWIN_BOTTOM, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },\
1701 { wxEVT_SCROLLWIN_LINEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },\
1702 { wxEVT_SCROLLWIN_LINEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },\
1703 { wxEVT_SCROLLWIN_PAGEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },\
1704 { wxEVT_SCROLLWIN_PAGEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },\
1705 { wxEVT_SCROLLWIN_THUMBTRACK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },\
1706 { wxEVT_SCROLLWIN_THUMBRELEASE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },
1708 #define EVT_SCROLLWIN_TOP(func) { wxEVT_SCROLLWIN_TOP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },
1709 #define EVT_SCROLLWIN_BOTTOM(func) { wxEVT_SCROLLWIN_BOTTOM, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },
1710 #define EVT_SCROLLWIN_LINEUP(func) { wxEVT_SCROLLWIN_LINEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },
1711 #define EVT_SCROLLWIN_LINEDOWN(func) { wxEVT_SCROLLWIN_LINEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },
1712 #define EVT_SCROLLWIN_PAGEUP(func) { wxEVT_SCROLLWIN_PAGEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },
1713 #define EVT_SCROLLWIN_PAGEDOWN(func) { wxEVT_SCROLLWIN_PAGEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },
1714 #define EVT_SCROLLWIN_THUMBTRACK(func) { wxEVT_SCROLLWIN_THUMBTRACK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },
1715 #define EVT_SCROLLWIN_THUMBRELEASE(func) { wxEVT_SCROLLWIN_THUMBRELEASE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },
1717 // Scrolling from wxSlider and wxScrollBar
1718 #define EVT_SCROLL(func) \
1719 { wxEVT_SCROLL_TOP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1720 { wxEVT_SCROLL_BOTTOM, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1721 { wxEVT_SCROLL_LINEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1722 { wxEVT_SCROLL_LINEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1723 { wxEVT_SCROLL_PAGEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1724 { wxEVT_SCROLL_PAGEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1725 { wxEVT_SCROLL_THUMBTRACK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1726 { wxEVT_SCROLL_THUMBRELEASE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1728 #define EVT_SCROLL_TOP(func) { wxEVT_SCROLL_TOP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1729 #define EVT_SCROLL_BOTTOM(func) { wxEVT_SCROLL_BOTTOM, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1730 #define EVT_SCROLL_LINEUP(func) { wxEVT_SCROLL_LINEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1731 #define EVT_SCROLL_LINEDOWN(func) { wxEVT_SCROLL_LINEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1732 #define EVT_SCROLL_PAGEUP(func) { wxEVT_SCROLL_PAGEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1733 #define EVT_SCROLL_PAGEDOWN(func) { wxEVT_SCROLL_PAGEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1734 #define EVT_SCROLL_THUMBTRACK(func) { wxEVT_SCROLL_THUMBTRACK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1735 #define EVT_SCROLL_THUMBRELEASE(func) { wxEVT_SCROLL_THUMBRELEASE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1737 // Scrolling from wxSlider and wxScrollBar, with an id
1738 #define EVT_COMMAND_SCROLL(id, func) \
1739 { wxEVT_SCROLL_TOP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1740 { wxEVT_SCROLL_BOTTOM, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1741 { wxEVT_SCROLL_LINEUP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1742 { wxEVT_SCROLL_LINEDOWN, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1743 { wxEVT_SCROLL_PAGEUP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1744 { wxEVT_SCROLL_PAGEDOWN, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1745 { wxEVT_SCROLL_THUMBTRACK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1746 { wxEVT_SCROLL_THUMBRELEASE, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1748 #define EVT_COMMAND_SCROLL_TOP(id, func) { wxEVT_SCROLL_TOP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1749 #define EVT_COMMAND_SCROLL_BOTTOM(id, func) { wxEVT_SCROLL_BOTTOM, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1750 #define EVT_COMMAND_SCROLL_LINEUP(id, func) { wxEVT_SCROLL_LINEUP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1751 #define EVT_COMMAND_SCROLL_LINEDOWN(id, func) { wxEVT_SCROLL_LINEDOWN, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1752 #define EVT_COMMAND_SCROLL_PAGEUP(id, func) { wxEVT_SCROLL_PAGEUP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1753 #define EVT_COMMAND_SCROLL_PAGEDOWN(id, func) { wxEVT_SCROLL_PAGEDOWN, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1754 #define EVT_COMMAND_SCROLL_THUMBTRACK(id, func) { wxEVT_SCROLL_THUMBTRACK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1755 #define EVT_COMMAND_SCROLL_THUMBRELEASE(id, func) { wxEVT_SCROLL_THUMBRELEASE, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1757 // Convenience macros for commonly-used commands
1758 #define EVT_BUTTON(id, fn) { wxEVT_COMMAND_BUTTON_CLICKED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1759 #define EVT_CHECKBOX(id, fn) { wxEVT_COMMAND_CHECKBOX_CLICKED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1760 #define EVT_CHOICE(id, fn) { wxEVT_COMMAND_CHOICE_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1761 #define EVT_LISTBOX(id, fn) { wxEVT_COMMAND_LISTBOX_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1762 #define EVT_LISTBOX_DCLICK(id, fn) { wxEVT_COMMAND_LISTBOX_DOUBLECLICKED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1763 #define EVT_TEXT(id, fn) { wxEVT_COMMAND_TEXT_UPDATED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1764 #define EVT_TEXT_ENTER(id, fn) { wxEVT_COMMAND_TEXT_ENTER, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1765 #define EVT_MENU(id, fn) { wxEVT_COMMAND_MENU_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1766 #define EVT_MENU_RANGE(id1, id2, fn) { wxEVT_COMMAND_MENU_SELECTED, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1767 #define EVT_SLIDER(id, fn) { wxEVT_COMMAND_SLIDER_UPDATED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1768 #define EVT_RADIOBOX(id, fn) { wxEVT_COMMAND_RADIOBOX_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1769 #define EVT_RADIOBUTTON(id, fn) { wxEVT_COMMAND_RADIOBUTTON_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1770 // EVT_SCROLLBAR is now obsolete since we use EVT_COMMAND_SCROLL... events
1771 #define EVT_SCROLLBAR(id, fn) { wxEVT_COMMAND_SCROLLBAR_UPDATED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1772 #define EVT_VLBOX(id, fn) { wxEVT_COMMAND_VLBOX_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1773 #define EVT_COMBOBOX(id, fn) { wxEVT_COMMAND_COMBOBOX_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1774 #define EVT_TOOL(id, fn) { wxEVT_COMMAND_TOOL_CLICKED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1775 #define EVT_TOOL_RANGE(id1, id2, fn) { wxEVT_COMMAND_TOOL_CLICKED, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1776 #define EVT_TOOL_RCLICKED(id, fn) { wxEVT_COMMAND_TOOL_RCLICKED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1777 #define EVT_TOOL_RCLICKED_RANGE(id1, id2, fn) { wxEVT_COMMAND_TOOL_RCLICKED, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1778 #define EVT_TOOL_ENTER(id, fn) { wxEVT_COMMAND_TOOL_ENTER, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1779 #define EVT_CHECKLISTBOX(id, fn) { wxEVT_COMMAND_CHECKLISTBOX_TOGGLED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1781 // Generic command events
1782 #define EVT_COMMAND_LEFT_CLICK(id, fn) { wxEVT_COMMAND_LEFT_CLICK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1783 #define EVT_COMMAND_LEFT_DCLICK(id, fn) { wxEVT_COMMAND_LEFT_DCLICK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1784 #define EVT_COMMAND_RIGHT_CLICK(id, fn) { wxEVT_COMMAND_RIGHT_CLICK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1785 #define EVT_COMMAND_RIGHT_DCLICK(id, fn) { wxEVT_COMMAND_RIGHT_DCLICK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1786 #define EVT_COMMAND_SET_FOCUS(id, fn) { wxEVT_COMMAND_SET_FOCUS, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1787 #define EVT_COMMAND_KILL_FOCUS(id, fn) { wxEVT_COMMAND_KILL_FOCUS, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1788 #define EVT_COMMAND_ENTER(id, fn) { wxEVT_COMMAND_ENTER, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1791 #define EVT_JOY_DOWN(func) \
1792 { wxEVT_JOY_BUTTON_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL },
1793 #define EVT_JOY_UP(func) \
1794 { wxEVT_JOY_BUTTON_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL },
1795 #define EVT_JOY_MOVE(func) \
1796 { wxEVT_JOY_MOVE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL },
1797 #define EVT_JOY_ZMOVE(func) \
1798 { wxEVT_JOY_ZMOVE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL },
1800 // All joystick events
1801 #define EVT_JOYSTICK_EVENTS(func) \
1802 { wxEVT_JOY_BUTTON_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL },\
1803 { wxEVT_JOY_BUTTON_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL },\
1804 { wxEVT_JOY_MOVE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL },\
1805 { wxEVT_JOY_ZMOVE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL },\
1808 #define EVT_IDLE(func) \
1809 { wxEVT_IDLE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxIdleEventFunction) & func, (wxObject *) NULL },\
1812 #define EVT_UPDATE_UI(id, func) \
1813 { wxEVT_UPDATE_UI, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxUpdateUIEventFunction) & func, (wxObject *) NULL },\
1815 // ----------------------------------------------------------------------------
1817 // ----------------------------------------------------------------------------
1819 // for pending event processing - notice that there is intentionally no
1821 extern wxList
*wxPendingEvents
;
1823 extern wxCriticalSection
*wxPendingEventsLocker
;
1826 // ----------------------------------------------------------------------------
1828 // ----------------------------------------------------------------------------
1832 // Find a window with the focus, that is also a descendant of the given window.
1833 // This is used to determine the window to initially send commands to.
1834 wxWindow
* wxFindFocusDescendant(wxWindow
* ancestor
);