]> git.saurik.com Git - wxWidgets.git/blob - include/wx/event.h
added wx/defs.h include to correct compilation issues under Mac OS X
[wxWidgets.git] / include / wx / event.h
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: wx/event.h
3 // Purpose: Event classes
4 // Author: Julian Smart
5 // Modified by:
6 // Created: 01/02/97
7 // RCS-ID: $Id$
8 // Copyright: (c) wxWindows team
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
11
12 #ifndef _WX_EVENTH__
13 #define _WX_EVENTH__
14
15 #ifdef __GNUG__
16 #pragma interface "event.h"
17 #endif
18
19 #include "wx/defs.h"
20 #include "wx/object.h"
21
22 #if wxUSE_GUI
23 #include "wx/gdicmn.h"
24 #include "wx/cursor.h"
25 #endif
26
27 #include "wx/thread.h"
28
29 // ----------------------------------------------------------------------------
30 // forward declarations
31 // ----------------------------------------------------------------------------
32
33 class WXDLLEXPORT wxList;
34
35 #if wxUSE_GUI
36 class WXDLLEXPORT wxClientData;
37 class WXDLLEXPORT wxDC;
38 class WXDLLEXPORT wxMenu;
39 class WXDLLEXPORT wxWindow;
40 #endif // wxUSE_GUI
41
42 // ----------------------------------------------------------------------------
43 // Event types
44 // ----------------------------------------------------------------------------
45
46 typedef int wxEventType;
47
48 // in previous versions of wxWindows the event types used to be constants
49 // which created difficulties with custom/user event types definition
50 //
51 // starting from wxWindows 2.4 the event types are now dynamically assigned
52 // using wxNewEventType() which solves this problem, however at price of
53 // several incompatibilities:
54 //
55 // a) event table macros declaration changed, it now uses wxEventTableEntry
56 // ctor instead of initialisation from an agregate - the macro
57 // DECLARE_EVENT_TABLE_ENTRY may be used to write code which can compile
58 // with all versions of wxWindows
59 //
60 // b) event types can't be used as switch() cases as they're not really
61 // constant any more - there is no magic solution here, you just have to
62 // change the switch()es to if()s
63 //
64 // if these are real problems for you, define WXWIN_COMPATIBILITY_EVENT_TYPES
65 // to get 100% old behaviour, however you won't be able to use the libraries
66 // using the new dynamic event type allocation in such case, so avoid it if
67 // possible.
68
69 #if WXWIN_COMPATIBILITY_EVENT_TYPES
70
71 #define DECLARE_EVENT_TABLE_ENTRY(type, id, idLast, fn, obj) \
72 { type, id, idLast, fn, obj }
73
74 #define BEGIN_DECLARE_EVENT_TYPES() enum {
75 #define END_DECLARE_EVENT_TYPES() };
76 #define DECLARE_EVENT_TYPE(name, value) name = wxEVT_FIRST + value,
77 #define DECLARE_LOCAL_EVENT_TYPE(name, value) name = wxEVT_FIRST + value,
78 #define DEFINE_EVENT_TYPE(name)
79
80
81 #else // !WXWIN_COMPATIBILITY_EVENT_TYPES
82
83 #define DECLARE_EVENT_TABLE_ENTRY(type, id, idLast, fn, obj) \
84 wxEventTableEntry(type, id, idLast, fn, obj)
85
86 #define BEGIN_DECLARE_EVENT_TYPES()
87 #define END_DECLARE_EVENT_TYPES()
88 #define DECLARE_EVENT_TYPE(name, value) \
89 extern const wxEventType WXDLLEXPORT name;
90 #define DECLARE_LOCAL_EVENT_TYPE(name, value) extern const wxEventType name;
91 #define DEFINE_EVENT_TYPE(name) const wxEventType name = wxNewEventType();
92
93 // generate a new unique event type
94 extern WXDLLEXPORT wxEventType wxNewEventType();
95
96 #endif // WXWIN_COMPATIBILITY_EVENT_TYPES/!WXWIN_COMPATIBILITY_EVENT_TYPES
97
98 BEGIN_DECLARE_EVENT_TYPES()
99
100 #if WXWIN_COMPATIBILITY_EVENT_TYPES
101 wxEVT_NULL = 0,
102 wxEVT_FIRST = 10000,
103 wxEVT_USER_FIRST = wxEVT_FIRST + 2000,
104 #else // !WXWIN_COMPATIBILITY_EVENT_TYPES
105 // it is important to still have these as constants to avoid
106 // initialization order related problems
107 DECLARE_EVENT_TYPE(wxEVT_NULL,0);
108 const wxEventType wxEVT_FIRST = 10000;
109 const wxEventType wxEVT_USER_FIRST = wxEVT_FIRST + 2000;
110 #endif // WXWIN_COMPATIBILITY_EVENT_TYPES/!WXWIN_COMPATIBILITY_EVENT_TYPES
111
112 DECLARE_EVENT_TYPE(wxEVT_COMMAND_BUTTON_CLICKED, 1)
113 DECLARE_EVENT_TYPE(wxEVT_COMMAND_CHECKBOX_CLICKED, 2)
114 DECLARE_EVENT_TYPE(wxEVT_COMMAND_CHOICE_SELECTED, 3)
115 DECLARE_EVENT_TYPE(wxEVT_COMMAND_LISTBOX_SELECTED, 4)
116 DECLARE_EVENT_TYPE(wxEVT_COMMAND_LISTBOX_DOUBLECLICKED, 5)
117 DECLARE_EVENT_TYPE(wxEVT_COMMAND_CHECKLISTBOX_TOGGLED, 6)
118 // now they are in wx/textctrl.h
119 #if WXWIN_COMPATIBILITY_EVENT_TYPES
120 DECLARE_EVENT_TYPE(wxEVT_COMMAND_TEXT_UPDATED, 7)
121 DECLARE_EVENT_TYPE(wxEVT_COMMAND_TEXT_ENTER, 8)
122 DECLARE_EVENT_TYPE(wxEVT_COMMAND_TEXT_URL, 13)
123 DECLARE_EVENT_TYPE(wxEVT_COMMAND_TEXT_MAXLEN, 14)
124 #endif // WXWIN_COMPATIBILITY_EVENT_TYPES
125 DECLARE_EVENT_TYPE(wxEVT_COMMAND_MENU_SELECTED, 9)
126 DECLARE_EVENT_TYPE(wxEVT_COMMAND_SLIDER_UPDATED, 10)
127 DECLARE_EVENT_TYPE(wxEVT_COMMAND_RADIOBOX_SELECTED, 11)
128 DECLARE_EVENT_TYPE(wxEVT_COMMAND_RADIOBUTTON_SELECTED, 12)
129
130 // wxEVT_COMMAND_SCROLLBAR_UPDATED is now obsolete since we use
131 // wxEVT_SCROLL... events
132
133 DECLARE_EVENT_TYPE(wxEVT_COMMAND_SCROLLBAR_UPDATED, 13)
134 DECLARE_EVENT_TYPE(wxEVT_COMMAND_VLBOX_SELECTED, 14)
135 DECLARE_EVENT_TYPE(wxEVT_COMMAND_COMBOBOX_SELECTED, 15)
136 DECLARE_EVENT_TYPE(wxEVT_COMMAND_TOOL_RCLICKED, 16)
137 DECLARE_EVENT_TYPE(wxEVT_COMMAND_TOOL_ENTER, 17)
138 DECLARE_EVENT_TYPE(wxEVT_COMMAND_SPINCTRL_UPDATED, 18)
139
140 // Sockets and timers send events, too
141 DECLARE_EVENT_TYPE(wxEVT_SOCKET, 50)
142 DECLARE_EVENT_TYPE(wxEVT_TIMER , 80)
143
144 // Mouse event types
145 DECLARE_EVENT_TYPE(wxEVT_LEFT_DOWN, 100)
146 DECLARE_EVENT_TYPE(wxEVT_LEFT_UP, 101)
147 DECLARE_EVENT_TYPE(wxEVT_MIDDLE_DOWN, 102)
148 DECLARE_EVENT_TYPE(wxEVT_MIDDLE_UP, 103)
149 DECLARE_EVENT_TYPE(wxEVT_RIGHT_DOWN, 104)
150 DECLARE_EVENT_TYPE(wxEVT_RIGHT_UP, 105)
151 DECLARE_EVENT_TYPE(wxEVT_MOTION, 106)
152 DECLARE_EVENT_TYPE(wxEVT_ENTER_WINDOW, 107)
153 DECLARE_EVENT_TYPE(wxEVT_LEAVE_WINDOW, 108)
154 DECLARE_EVENT_TYPE(wxEVT_LEFT_DCLICK, 109)
155 DECLARE_EVENT_TYPE(wxEVT_MIDDLE_DCLICK, 110)
156 DECLARE_EVENT_TYPE(wxEVT_RIGHT_DCLICK, 111)
157 DECLARE_EVENT_TYPE(wxEVT_SET_FOCUS, 112)
158 DECLARE_EVENT_TYPE(wxEVT_KILL_FOCUS, 113)
159 DECLARE_EVENT_TYPE(wxEVT_CHILD_FOCUS, 114)
160 DECLARE_EVENT_TYPE(wxEVT_MOUSEWHEEL, 115)
161
162 // Non-client mouse events
163 DECLARE_EVENT_TYPE(wxEVT_NC_LEFT_DOWN, 200)
164 DECLARE_EVENT_TYPE(wxEVT_NC_LEFT_UP, 201)
165 DECLARE_EVENT_TYPE(wxEVT_NC_MIDDLE_DOWN, 202)
166 DECLARE_EVENT_TYPE(wxEVT_NC_MIDDLE_UP, 203)
167 DECLARE_EVENT_TYPE(wxEVT_NC_RIGHT_DOWN, 204)
168 DECLARE_EVENT_TYPE(wxEVT_NC_RIGHT_UP, 205)
169 DECLARE_EVENT_TYPE(wxEVT_NC_MOTION, 206)
170 DECLARE_EVENT_TYPE(wxEVT_NC_ENTER_WINDOW, 207)
171 DECLARE_EVENT_TYPE(wxEVT_NC_LEAVE_WINDOW, 208)
172 DECLARE_EVENT_TYPE(wxEVT_NC_LEFT_DCLICK, 209)
173 DECLARE_EVENT_TYPE(wxEVT_NC_MIDDLE_DCLICK, 210)
174 DECLARE_EVENT_TYPE(wxEVT_NC_RIGHT_DCLICK, 211)
175
176 // Character input event type
177 DECLARE_EVENT_TYPE(wxEVT_CHAR, 212)
178 DECLARE_EVENT_TYPE(wxEVT_CHAR_HOOK, 213)
179 DECLARE_EVENT_TYPE(wxEVT_NAVIGATION_KEY, 214)
180 DECLARE_EVENT_TYPE(wxEVT_KEY_DOWN, 215)
181 DECLARE_EVENT_TYPE(wxEVT_KEY_UP, 216)
182
183 // Set cursor event
184 DECLARE_EVENT_TYPE(wxEVT_SET_CURSOR, 230)
185
186 // wxScrollbar and wxSlider event identifiers
187 DECLARE_EVENT_TYPE(wxEVT_SCROLL_TOP, 300)
188 DECLARE_EVENT_TYPE(wxEVT_SCROLL_BOTTOM, 301)
189 DECLARE_EVENT_TYPE(wxEVT_SCROLL_LINEUP, 302)
190 DECLARE_EVENT_TYPE(wxEVT_SCROLL_LINEDOWN, 303)
191 DECLARE_EVENT_TYPE(wxEVT_SCROLL_PAGEUP, 304)
192 DECLARE_EVENT_TYPE(wxEVT_SCROLL_PAGEDOWN, 305)
193 DECLARE_EVENT_TYPE(wxEVT_SCROLL_THUMBTRACK, 306)
194 DECLARE_EVENT_TYPE(wxEVT_SCROLL_THUMBRELEASE, 307)
195
196 // Scroll events from wxWindow
197 DECLARE_EVENT_TYPE(wxEVT_SCROLLWIN_TOP, 320)
198 DECLARE_EVENT_TYPE(wxEVT_SCROLLWIN_BOTTOM, 321)
199 DECLARE_EVENT_TYPE(wxEVT_SCROLLWIN_LINEUP, 322)
200 DECLARE_EVENT_TYPE(wxEVT_SCROLLWIN_LINEDOWN, 323)
201 DECLARE_EVENT_TYPE(wxEVT_SCROLLWIN_PAGEUP, 324)
202 DECLARE_EVENT_TYPE(wxEVT_SCROLLWIN_PAGEDOWN, 325)
203 DECLARE_EVENT_TYPE(wxEVT_SCROLLWIN_THUMBTRACK, 326)
204 DECLARE_EVENT_TYPE(wxEVT_SCROLLWIN_THUMBRELEASE, 327)
205
206 // System events
207 DECLARE_EVENT_TYPE(wxEVT_SIZE, 400)
208 DECLARE_EVENT_TYPE(wxEVT_MOVE, 401)
209 DECLARE_EVENT_TYPE(wxEVT_CLOSE_WINDOW, 402)
210 DECLARE_EVENT_TYPE(wxEVT_END_SESSION, 403)
211 DECLARE_EVENT_TYPE(wxEVT_QUERY_END_SESSION, 404)
212 DECLARE_EVENT_TYPE(wxEVT_ACTIVATE_APP, 405)
213 DECLARE_EVENT_TYPE(wxEVT_POWER, 406)
214 DECLARE_EVENT_TYPE(wxEVT_ACTIVATE, 409)
215 DECLARE_EVENT_TYPE(wxEVT_CREATE, 410)
216 DECLARE_EVENT_TYPE(wxEVT_DESTROY, 411)
217 DECLARE_EVENT_TYPE(wxEVT_SHOW, 412)
218 DECLARE_EVENT_TYPE(wxEVT_ICONIZE, 413)
219 DECLARE_EVENT_TYPE(wxEVT_MAXIMIZE, 414)
220 DECLARE_EVENT_TYPE(wxEVT_MOUSE_CAPTURE_CHANGED, 415)
221 DECLARE_EVENT_TYPE(wxEVT_PAINT, 416)
222 DECLARE_EVENT_TYPE(wxEVT_ERASE_BACKGROUND, 417)
223 DECLARE_EVENT_TYPE(wxEVT_NC_PAINT, 418)
224 DECLARE_EVENT_TYPE(wxEVT_PAINT_ICON, 419)
225 DECLARE_EVENT_TYPE(wxEVT_MENU_CHAR, 420)
226 DECLARE_EVENT_TYPE(wxEVT_MENU_INIT, 421)
227 DECLARE_EVENT_TYPE(wxEVT_MENU_HIGHLIGHT, 422)
228 DECLARE_EVENT_TYPE(wxEVT_POPUP_MENU_INIT, 423)
229 DECLARE_EVENT_TYPE(wxEVT_CONTEXT_MENU, 424)
230 DECLARE_EVENT_TYPE(wxEVT_SYS_COLOUR_CHANGED, 425)
231 DECLARE_EVENT_TYPE(wxEVT_SETTING_CHANGED, 426)
232 DECLARE_EVENT_TYPE(wxEVT_QUERY_NEW_PALETTE, 427)
233 DECLARE_EVENT_TYPE(wxEVT_PALETTE_CHANGED, 428)
234 DECLARE_EVENT_TYPE(wxEVT_JOY_BUTTON_DOWN, 429)
235 DECLARE_EVENT_TYPE(wxEVT_JOY_BUTTON_UP, 430)
236 DECLARE_EVENT_TYPE(wxEVT_JOY_MOVE, 431)
237 DECLARE_EVENT_TYPE(wxEVT_JOY_ZMOVE, 432)
238 DECLARE_EVENT_TYPE(wxEVT_DROP_FILES, 433)
239 DECLARE_EVENT_TYPE(wxEVT_DRAW_ITEM, 434)
240 DECLARE_EVENT_TYPE(wxEVT_MEASURE_ITEM, 435)
241 DECLARE_EVENT_TYPE(wxEVT_COMPARE_ITEM, 436)
242 DECLARE_EVENT_TYPE(wxEVT_INIT_DIALOG, 437)
243 DECLARE_EVENT_TYPE(wxEVT_IDLE, 438)
244 DECLARE_EVENT_TYPE(wxEVT_UPDATE_UI, 439)
245
246 // Generic command events
247 // Note: a click is a higher-level event than button down/up
248 DECLARE_EVENT_TYPE(wxEVT_COMMAND_LEFT_CLICK, 500)
249 DECLARE_EVENT_TYPE(wxEVT_COMMAND_LEFT_DCLICK, 501)
250 DECLARE_EVENT_TYPE(wxEVT_COMMAND_RIGHT_CLICK, 502)
251 DECLARE_EVENT_TYPE(wxEVT_COMMAND_RIGHT_DCLICK, 503)
252 DECLARE_EVENT_TYPE(wxEVT_COMMAND_SET_FOCUS, 504)
253 DECLARE_EVENT_TYPE(wxEVT_COMMAND_KILL_FOCUS, 505)
254 DECLARE_EVENT_TYPE(wxEVT_COMMAND_ENTER, 506)
255
256 // Help events
257 DECLARE_EVENT_TYPE(wxEVT_HELP, 1050)
258 DECLARE_EVENT_TYPE(wxEVT_DETAILED_HELP, 1051)
259
260 END_DECLARE_EVENT_TYPES()
261
262 // these 2 events are the same
263 #define wxEVT_COMMAND_TOOL_CLICKED wxEVT_COMMAND_MENU_SELECTED
264
265 // ----------------------------------------------------------------------------
266 // Compatibility
267 // ----------------------------------------------------------------------------
268
269 // this event is also used by wxComboBox and wxSpinCtrl which don't include
270 // wx/textctrl.h in all ports [yet], so declare it here as well
271 //
272 // still, any new code using it should include wx/textctrl.h explicitly
273 #if !WXWIN_COMPATIBILITY_EVENT_TYPES
274 extern const wxEventType WXDLLEXPORT wxEVT_COMMAND_TEXT_UPDATED;
275 #endif
276
277 #if WXWIN_COMPATIBILITY
278
279 #define wxEVENT_TYPE_BUTTON_COMMAND wxEVT_COMMAND_BUTTON_CLICKED
280 #define wxEVENT_TYPE_CHECKBOX_COMMAND wxEVT_COMMAND_CHECKBOX_CLICKED
281 #define wxEVENT_TYPE_CHOICE_COMMAND wxEVT_COMMAND_CHOICE_SELECTED
282 #define wxEVENT_TYPE_LISTBOX_COMMAND wxEVT_COMMAND_LISTBOX_SELECTED
283 #define wxEVENT_TYPE_LISTBOX_DCLICK_COMMAND wxEVT_COMMAND_LISTBOX_DOUBLECLICKED
284 #define wxEVENT_TYPE_TEXT_COMMAND wxEVT_COMMAND_TEXT_UPDATED
285 #define wxEVENT_TYPE_MULTITEXT_COMMAND wxEVT_COMMAND_TEXT_UPDATED
286 #define wxEVENT_TYPE_MENU_COMMAND wxEVT_COMMAND_MENU_SELECTED
287 #define wxEVENT_TYPE_SLIDER_COMMAND wxEVT_COMMAND_SLIDER_UPDATED
288 #define wxEVENT_TYPE_RADIOBOX_COMMAND wxEVT_COMMAND_RADIOBOX_SELECTED
289 #define wxEVENT_TYPE_RADIOBUTTON_COMMAND wxEVT_COMMAND_RADIOBUTTON_SELECTED
290 #define wxEVENT_TYPE_TEXT_ENTER_COMMAND wxEVT_COMMAND_TEXT_ENTER
291 #define wxEVENT_TYPE_SET_FOCUS wxEVT_SET_FOCUS
292 #define wxEVENT_TYPE_KILL_FOCUS wxEVT_KILL_FOCUS
293 #define wxEVENT_TYPE_SCROLLBAR_COMMAND wxEVT_COMMAND_SCROLLBAR_UPDATED
294 #define wxEVENT_TYPE_VIRT_LISTBOX_COMMAND wxEVT_COMMAND_VLBOX_SELECTED
295 #define wxEVENT_TYPE_COMBOBOX_COMMAND wxEVT_COMMAND_COMBOBOX_SELECTED
296
297 #define wxEVENT_TYPE_LEFT_DOWN wxEVT_LEFT_DOWN
298 #define wxEVENT_TYPE_LEFT_UP wxEVT_LEFT_UP
299 #define wxEVENT_TYPE_MIDDLE_DOWN wxEVT_MIDDLE_DOWN
300 #define wxEVENT_TYPE_MIDDLE_UP wxEVT_MIDDLE_UP
301 #define wxEVENT_TYPE_RIGHT_DOWN wxEVT_RIGHT_DOWN
302 #define wxEVENT_TYPE_RIGHT_UP wxEVT_RIGHT_UP
303 #define wxEVENT_TYPE_MOTION wxEVT_MOTION
304 #define wxEVENT_TYPE_ENTER_WINDOW wxEVT_ENTER_WINDOW
305 #define wxEVENT_TYPE_LEAVE_WINDOW wxEVT_LEAVE_WINDOW
306 #define wxEVENT_TYPE_LEFT_DCLICK wxEVT_LEFT_DCLICK
307 #define wxEVENT_TYPE_MIDDLE_DCLICK wxEVT_MIDDLE_DCLICK
308 #define wxEVENT_TYPE_RIGHT_DCLICK wxEVT_RIGHT_DCLICK
309 #define wxEVENT_TYPE_CHAR wxEVT_CHAR
310 #define wxEVENT_TYPE_SCROLL_TOP wxEVT_SCROLL_TOP
311 #define wxEVENT_TYPE_SCROLL_BOTTOM wxEVT_SCROLL_BOTTOM
312 #define wxEVENT_TYPE_SCROLL_LINEUP wxEVT_SCROLL_LINEUP
313 #define wxEVENT_TYPE_SCROLL_LINEDOWN wxEVT_SCROLL_LINEDOWN
314 #define wxEVENT_TYPE_SCROLL_PAGEUP wxEVT_SCROLL_PAGEUP
315 #define wxEVENT_TYPE_SCROLL_PAGEDOWN wxEVT_SCROLL_PAGEDOWN
316 #define wxEVENT_TYPE_SCROLL_THUMBTRACK wxEVT_SCROLL_THUMBTRACK
317
318 #endif // WXWIN_COMPATIBILITY
319
320 /*
321 * wxWindows events, covering all interesting things that might happen
322 * (button clicking, resizing, setting text in widgets, etc.).
323 *
324 * For each completely new event type, derive a new event class.
325 * An event CLASS represents a C++ class defining a range of similar event TYPES;
326 * examples are canvas events, panel item command events.
327 * An event TYPE is a unique identifier for a particular system event,
328 * such as a button press or a listbox deselection.
329 *
330 */
331
332 class WXDLLEXPORT wxEvent : public wxObject
333 {
334 DECLARE_ABSTRACT_CLASS(wxEvent)
335
336 public:
337 wxEvent(int id = 0);
338 ~wxEvent() {}
339
340 void SetEventType(wxEventType typ) { m_eventType = typ; }
341 wxEventType GetEventType() const { return m_eventType; }
342 wxObject *GetEventObject() const { return m_eventObject; }
343 void SetEventObject(wxObject *obj) { m_eventObject = obj; }
344 long GetTimestamp() const { return m_timeStamp; }
345 void SetTimestamp(long ts = 0) { m_timeStamp = ts; }
346 int GetId() const { return m_id; }
347 void SetId(int Id) { m_id = Id; }
348
349 // Can instruct event processor that we wish to ignore this event
350 // (treat as if the event table entry had not been found): this must be done
351 // to allow the event processing by the base classes (calling event.Skip()
352 // is the analog of calling the base class verstion of a virtual function)
353 void Skip(bool skip = TRUE) { m_skipped = skip; }
354 bool GetSkipped() const { return m_skipped; };
355
356 // implementation only: this test is explicitlty anti OO and this functions
357 // exists only for optimization purposes
358 bool IsCommandEvent() const { return m_isCommandEvent; }
359
360 void CopyObject(wxObject& object_dest) const;
361
362 public:
363 wxObject* m_eventObject;
364 wxEventType m_eventType;
365 long m_timeStamp;
366 int m_id;
367 wxObject* m_callbackUserData;
368 bool m_skipped;
369
370 // optimization: instead of using costly IsKindOf() we keep a flag telling
371 // whether we're a command event (by far the most common case)
372 bool m_isCommandEvent;
373 };
374
375 #if wxUSE_GUI
376
377 // Item or menu event class
378 /*
379 wxEVT_COMMAND_BUTTON_CLICKED
380 wxEVT_COMMAND_CHECKBOX_CLICKED
381 wxEVT_COMMAND_CHOICE_SELECTED
382 wxEVT_COMMAND_LISTBOX_SELECTED
383 wxEVT_COMMAND_LISTBOX_DOUBLECLICKED
384 wxEVT_COMMAND_TEXT_UPDATED
385 wxEVT_COMMAND_TEXT_ENTER
386 wxEVT_COMMAND_MENU_SELECTED
387 wxEVT_COMMAND_SLIDER_UPDATED
388 wxEVT_COMMAND_RADIOBOX_SELECTED
389 wxEVT_COMMAND_RADIOBUTTON_SELECTED
390 wxEVT_COMMAND_SCROLLBAR_UPDATED
391 wxEVT_COMMAND_VLBOX_SELECTED
392 wxEVT_COMMAND_COMBOBOX_SELECTED
393 wxEVT_COMMAND_TOGGLEBUTTON_CLICKED
394 */
395
396 class WXDLLEXPORT wxCommandEvent : public wxEvent
397 {
398 DECLARE_DYNAMIC_CLASS(wxCommandEvent)
399
400 public:
401 wxCommandEvent(wxEventType commandType = wxEVT_NULL, int id = 0);
402 ~wxCommandEvent() {}
403
404 /*
405 * Accessors dependent on context
406 *
407 */
408
409 // Set/Get client data from controls
410 void SetClientData(void* clientData) { m_clientData = clientData; }
411 void *GetClientData() const { return m_clientData; }
412
413 // Set/Get client object from controls
414 void SetClientObject(wxClientData* clientObject) { m_clientObject = clientObject; }
415 void *GetClientObject() const { return m_clientObject; }
416
417 // Get listbox selection if single-choice
418 int GetSelection() const { return m_commandInt; }
419
420 // Set/Get listbox/choice selection string
421 void SetString(const wxString& s) { m_commandString = s; }
422 wxString GetString() const { return m_commandString; }
423
424 // Get checkbox value
425 bool IsChecked() const { return m_commandInt != 0; }
426
427 // TRUE if the listbox event was a selection.
428 bool IsSelection() const { return (m_extraLong != 0); }
429
430 void SetExtraLong(long extraLong) { m_extraLong = extraLong; }
431 long GetExtraLong() const { return m_extraLong ; }
432
433 void SetInt(int i) { m_commandInt = i; }
434 long GetInt() const { return m_commandInt ; }
435
436 void CopyObject(wxObject& obj) const;
437
438 #if WXWIN_COMPATIBILITY_2
439 bool Checked() const { return IsChecked(); }
440 #endif // WXWIN_COMPATIBILITY_2
441
442 public:
443 wxString m_commandString; // String event argument
444 int m_commandInt;
445 long m_extraLong; // Additional information (e.g. select/deselect)
446 void* m_clientData; // Arbitrary client data
447 wxClientData* m_clientObject; // Arbitrary client object
448 };
449
450 // this class adds a possibility to react (from the user) code to a control
451 // notification: allow or veto the operation being reported.
452 class WXDLLEXPORT wxNotifyEvent : public wxCommandEvent
453 {
454 public:
455 wxNotifyEvent(wxEventType commandType = wxEVT_NULL, int id = 0)
456 : wxCommandEvent(commandType, id) { m_bAllow = TRUE; }
457
458 // veto the operation (usually it's allowed by default)
459 void Veto() { m_bAllow = FALSE; }
460
461 // allow the operation if it was disabled by default
462 void Allow() { m_bAllow = TRUE; }
463
464 // for implementation code only: is the operation allowed?
465 bool IsAllowed() const { return m_bAllow; }
466
467 // probably useless: CopyObject() is used for deferred event
468 // handling but wxNotifyEvent must be processed immediately
469 void CopyObject(wxObject& obj) const;
470
471 private:
472 bool m_bAllow;
473
474 DECLARE_DYNAMIC_CLASS(wxNotifyEvent)
475 };
476
477 // Scroll event class, derived form wxCommandEvent. wxScrollEvents are
478 // sent by wxSlider and wxScrollbar.
479 /*
480 wxEVT_SCROLL_TOP
481 wxEVT_SCROLL_BOTTOM
482 wxEVT_SCROLL_LINEUP
483 wxEVT_SCROLL_LINEDOWN
484 wxEVT_SCROLL_PAGEUP
485 wxEVT_SCROLL_PAGEDOWN
486 wxEVT_SCROLL_THUMBTRACK
487 wxEVT_SCROLL_THUMBRELEASE
488 */
489
490 class WXDLLEXPORT wxScrollEvent : public wxCommandEvent
491 {
492 DECLARE_DYNAMIC_CLASS(wxScrollEvent)
493
494 public:
495 wxScrollEvent(wxEventType commandType = wxEVT_NULL,
496 int id = 0, int pos = 0, int orient = 0);
497 ~wxScrollEvent() {}
498
499 /*
500 * Accessors
501 *
502 */
503
504 int GetOrientation() const { return (int) m_extraLong ; }
505 int GetPosition() const { return m_commandInt ; }
506 void SetOrientation(int orient) { m_extraLong = (long) orient; }
507 void SetPosition(int pos) { m_commandInt = pos; }
508 };
509
510 // ScrollWin event class, derived fom wxEvent. wxScrollWinEvents
511 // are sent by wxWindow.
512 /*
513 wxEVT_SCROLLWIN_TOP
514 wxEVT_SCROLLWIN_BOTTOM
515 wxEVT_SCROLLWIN_LINEUP
516 wxEVT_SCROLLWIN_LINEDOWN
517 wxEVT_SCROLLWIN_PAGEUP
518 wxEVT_SCROLLWIN_PAGEDOWN
519 wxEVT_SCROLLWIN_THUMBTRACK
520 wxEVT_SCROLLWIN_THUMBRELEASE
521 */
522
523 class WXDLLEXPORT wxScrollWinEvent : public wxEvent
524 {
525 public:
526 wxScrollWinEvent(wxEventType commandType = wxEVT_NULL,
527 int pos = 0, int orient = 0);
528 ~wxScrollWinEvent() {}
529
530 /*
531 * Accessors
532 */
533
534 int GetOrientation() const { return (int) m_extraLong ; }
535 int GetPosition() const { return m_commandInt ; }
536 void SetOrientation(int orient) { m_extraLong = (long) orient; }
537 void SetPosition(int pos) { m_commandInt = pos; }
538
539 void CopyObject(wxObject& object_dest) const;
540
541 public:
542 int m_commandInt; // Additional information
543 long m_extraLong;
544
545 DECLARE_DYNAMIC_CLASS(wxScrollWinEvent)
546 };
547
548 // Mouse event class
549
550 /*
551 wxEVT_LEFT_DOWN
552 wxEVT_LEFT_UP
553 wxEVT_MIDDLE_DOWN
554 wxEVT_MIDDLE_UP
555 wxEVT_RIGHT_DOWN
556 wxEVT_RIGHT_UP
557 wxEVT_MOTION
558 wxEVT_ENTER_WINDOW
559 wxEVT_LEAVE_WINDOW
560 wxEVT_LEFT_DCLICK
561 wxEVT_MIDDLE_DCLICK
562 wxEVT_RIGHT_DCLICK
563 wxEVT_NC_LEFT_DOWN
564 wxEVT_NC_LEFT_UP,
565 wxEVT_NC_MIDDLE_DOWN,
566 wxEVT_NC_MIDDLE_UP,
567 wxEVT_NC_RIGHT_DOWN,
568 wxEVT_NC_RIGHT_UP,
569 wxEVT_NC_MOTION,
570 wxEVT_NC_ENTER_WINDOW,
571 wxEVT_NC_LEAVE_WINDOW,
572 wxEVT_NC_LEFT_DCLICK,
573 wxEVT_NC_MIDDLE_DCLICK,
574 wxEVT_NC_RIGHT_DCLICK,
575 */
576
577 class WXDLLEXPORT wxMouseEvent : public wxEvent
578 {
579 public:
580 wxMouseEvent(wxEventType mouseType = wxEVT_NULL);
581
582 // Was it a button event? (*doesn't* mean: is any button *down*?)
583 bool IsButton() const { return Button(-1); }
584
585 // Was it a down event from button 1, 2 or 3 or any?
586 bool ButtonDown(int but = -1) const;
587
588 // Was it a dclick event from button 1, 2 or 3 or any?
589 bool ButtonDClick(int but = -1) const;
590
591 // Was it a up event from button 1, 2 or 3 or any?
592 bool ButtonUp(int but = -1) const;
593
594 // Was the given button 1,2,3 or any changing state?
595 bool Button(int but) const;
596
597 // Was the given button 1,2,3 or any in Down state?
598 bool ButtonIsDown(int but) const;
599
600 // Get the button which is changing state (-1 if none)
601 int GetButton() const;
602
603 // Find state of shift/control keys
604 bool ControlDown() const { return m_controlDown; }
605 bool MetaDown() const { return m_metaDown; }
606 bool AltDown() const { return m_altDown; }
607 bool ShiftDown() const { return m_shiftDown; }
608
609 // Find which event was just generated
610 bool LeftDown() const { return (m_eventType == wxEVT_LEFT_DOWN); }
611 bool MiddleDown() const { return (m_eventType == wxEVT_MIDDLE_DOWN); }
612 bool RightDown() const { return (m_eventType == wxEVT_RIGHT_DOWN); }
613
614 bool LeftUp() const { return (m_eventType == wxEVT_LEFT_UP); }
615 bool MiddleUp() const { return (m_eventType == wxEVT_MIDDLE_UP); }
616 bool RightUp() const { return (m_eventType == wxEVT_RIGHT_UP); }
617
618 bool LeftDClick() const { return (m_eventType == wxEVT_LEFT_DCLICK); }
619 bool MiddleDClick() const { return (m_eventType == wxEVT_MIDDLE_DCLICK); }
620 bool RightDClick() const { return (m_eventType == wxEVT_RIGHT_DCLICK); }
621
622 // Find the current state of the mouse buttons (regardless
623 // of current event type)
624 bool LeftIsDown() const { return m_leftDown; }
625 bool MiddleIsDown() const { return m_middleDown; }
626 bool RightIsDown() const { return m_rightDown; }
627
628 // True if a button is down and the mouse is moving
629 bool Dragging() const
630 {
631 return ((m_eventType == wxEVT_MOTION) &&
632 (LeftIsDown() || MiddleIsDown() || RightIsDown()));
633 }
634
635 // True if the mouse is moving, and no button is down
636 bool Moving() const { return (m_eventType == wxEVT_MOTION); }
637
638 // True if the mouse is just entering the window
639 bool Entering() const { return (m_eventType == wxEVT_ENTER_WINDOW); }
640
641 // True if the mouse is just leaving the window
642 bool Leaving() const { return (m_eventType == wxEVT_LEAVE_WINDOW); }
643
644 // Find the position of the event
645 void GetPosition(wxCoord *xpos, wxCoord *ypos) const
646 {
647 if (xpos)
648 *xpos = m_x;
649 if (ypos)
650 *ypos = m_y;
651 }
652
653 #ifndef __WIN16__
654 void GetPosition(long *xpos, long *ypos) const
655 {
656 if (xpos)
657 *xpos = (long)m_x;
658 if (ypos)
659 *ypos = (long)m_y;
660 }
661 #endif
662
663 // Find the position of the event
664 wxPoint GetPosition() const { return wxPoint(m_x, m_y); }
665
666 // Find the logical position of the event given the DC
667 wxPoint GetLogicalPosition(const wxDC& dc) const ;
668
669 // Compatibility
670 #if WXWIN_COMPATIBILITY
671 void Position(long *xpos, long *ypos) const
672 {
673 if (xpos)
674 *xpos = (long)m_x;
675 if (ypos)
676 *ypos = (long)m_y;
677 }
678
679 void Position(float *xpos, float *ypos) const
680 {
681 *xpos = (float) m_x; *ypos = (float) m_y;
682 }
683 #endif // WXWIN_COMPATIBILITY
684
685 // Get X position
686 wxCoord GetX() const { return m_x; }
687
688 // Get Y position
689 wxCoord GetY() const { return m_y; }
690
691 // Get wheel rotation, positive or negative indicates direction of
692 // rotation. Current devices all send an event when rotation is equal to
693 // +/-WheelDelta, but this allows for finer resolution devices to be
694 // created in the future. Because of this you shouldn't assume that one
695 // event is equal to 1 line or whatever, but you should be able to either
696 // do partial line scrolling or wait until +/-WheelDelta rotation values
697 // have been accumulated before scrolling.
698 int GetWheelRotation() const { return m_wheelRotation; }
699
700 // Get wheel delta, normally 120. This is the threshold for action to be
701 // taken, and one such action (for example, scrolling one increment)
702 // should occur for each delta.
703 int GetWheelDelta() const { return m_wheelDelta; }
704
705 // Returns the configured number of lines (or whatever) to be scrolled per
706 // wheel action. Defaults to one.
707 int GetLinesPerAction() const { return m_linesPerAction; }
708
709
710 void CopyObject(wxObject& obj) const;
711
712 public:
713 wxCoord m_x, m_y;
714
715 bool m_leftDown;
716 bool m_middleDown;
717 bool m_rightDown;
718
719 bool m_controlDown;
720 bool m_shiftDown;
721 bool m_altDown;
722 bool m_metaDown;
723
724 int m_wheelRotation;
725 int m_wheelDelta;
726 int m_linesPerAction;
727
728 private:
729 DECLARE_DYNAMIC_CLASS(wxMouseEvent)
730 };
731
732 // Cursor set event
733
734 /*
735 wxEVT_SET_CURSOR
736 */
737
738 class WXDLLEXPORT wxSetCursorEvent : public wxEvent
739 {
740 public:
741 wxSetCursorEvent(wxCoord x, wxCoord y)
742 {
743 m_eventType = wxEVT_SET_CURSOR;
744
745 m_x = x;
746 m_y = y;
747 }
748
749 wxCoord GetX() const { return m_x; }
750 wxCoord GetY() const { return m_y; }
751
752 void SetCursor(const wxCursor& cursor) { m_cursor = cursor; }
753 const wxCursor& GetCursor() const { return m_cursor; }
754 bool HasCursor() const { return m_cursor.Ok(); }
755
756 private:
757 wxCoord m_x, m_y;
758 wxCursor m_cursor;
759 };
760
761 // Keyboard input event class
762
763 /*
764 wxEVT_CHAR
765 wxEVT_CHAR_HOOK
766 wxEVT_KEY_DOWN
767 wxEVT_KEY_UP
768 */
769
770 class WXDLLEXPORT wxKeyEvent : public wxEvent
771 {
772 DECLARE_DYNAMIC_CLASS(wxKeyEvent)
773
774 public:
775 wxKeyEvent(wxEventType keyType = wxEVT_NULL);
776
777 // Find state of shift/control keys
778 bool ControlDown() const { return m_controlDown; }
779 bool MetaDown() const { return m_metaDown; }
780 bool AltDown() const { return m_altDown; }
781 bool ShiftDown() const { return m_shiftDown; }
782
783 // exclude MetaDown() from HasModifiers() because NumLock under X is often
784 // configured as mod2 modifier, yet the key events even when it is pressed
785 // should be processed normally, not like Ctrl- or Alt-key
786 bool HasModifiers() const { return ControlDown() || AltDown(); }
787
788 // get the key code: an ASCII7 char or an element of wxKeyCode enum
789 int GetKeyCode() const { return (int)m_keyCode; }
790
791 // Find the position of the event
792 void GetPosition(wxCoord *xpos, wxCoord *ypos) const
793 {
794 if (xpos) *xpos = m_x;
795 if (ypos) *ypos = m_y;
796 }
797
798 #ifndef __WIN16__
799 void GetPosition(long *xpos, long *ypos) const
800 {
801 if (xpos) *xpos = (long)m_x;
802 if (ypos) *ypos = (long)m_y;
803 }
804 #endif
805
806 wxPoint GetPosition() const
807 { return wxPoint(m_x, m_y); }
808
809 // Get X position
810 wxCoord GetX() const { return m_x; }
811
812 // Get Y position
813 wxCoord GetY() const { return m_y; }
814
815 void CopyObject(wxObject& obj) const;
816
817 // deprecated
818 long KeyCode() const { return m_keyCode; }
819
820 public:
821 wxCoord m_x, m_y;
822
823 long m_keyCode;
824
825 bool m_controlDown;
826 bool m_shiftDown;
827 bool m_altDown;
828 bool m_metaDown;
829 bool m_scanCode;
830 };
831
832 // Size event class
833 /*
834 wxEVT_SIZE
835 */
836
837 class WXDLLEXPORT wxSizeEvent : public wxEvent
838 {
839 DECLARE_DYNAMIC_CLASS(wxSizeEvent)
840
841 public:
842 wxSize m_size;
843
844 wxSizeEvent() { m_eventType = wxEVT_SIZE; }
845 wxSizeEvent(const wxSize& sz, int id = 0)
846 : m_size(sz)
847 { m_eventType = wxEVT_SIZE; m_id = id; }
848
849 wxSize GetSize() const { return m_size; }
850
851 void CopyObject(wxObject& obj) const;
852 };
853
854 // Move event class
855
856 /*
857 wxEVT_MOVE
858 */
859
860 class WXDLLEXPORT wxMoveEvent : public wxEvent
861 {
862 DECLARE_DYNAMIC_CLASS(wxMoveEvent)
863
864 public:
865 wxPoint m_pos;
866
867 wxMoveEvent() { m_eventType = wxEVT_MOVE; }
868 wxMoveEvent(const wxPoint& pos, int id = 0)
869 : m_pos(pos)
870 { m_eventType = wxEVT_MOVE; m_id = id; }
871
872 wxPoint GetPosition() const { return m_pos; }
873
874 void CopyObject(wxObject& obj) const;
875 };
876
877 // Paint event class
878 /*
879 wxEVT_PAINT
880 wxEVT_NC_PAINT
881 wxEVT_PAINT_ICON
882 */
883
884 #if defined(__WXDEBUG__) && (defined(__WXMSW__) || defined(__WXPM__))
885 // see comments in src/msw|os2/dcclient.cpp where g_isPainting is defined
886 extern WXDLLEXPORT int g_isPainting;
887 #endif // debug
888
889 class WXDLLEXPORT wxPaintEvent : public wxEvent
890 {
891 DECLARE_DYNAMIC_CLASS(wxPaintEvent)
892
893 public:
894 wxPaintEvent(int Id = 0)
895 {
896 m_eventType = wxEVT_PAINT;
897 m_id = Id;
898
899 #if defined(__WXDEBUG__) && (defined(__WXMSW__) || defined(__WXPM__))
900 // set the internal flag for the duration of processing of WM_PAINT
901 g_isPainting++;
902 #endif // debug
903 }
904
905 #if defined(__WXDEBUG__) && (defined(__WXMSW__) || defined(__WXPM__))
906 ~wxPaintEvent()
907 {
908 g_isPainting--;
909 }
910 #endif // debug
911 };
912
913 class WXDLLEXPORT wxNcPaintEvent : public wxEvent
914 {
915 public:
916 wxNcPaintEvent(int id = 0) : wxEvent(id) { SetEventType(wxEVT_NC_PAINT); }
917
918 private:
919 DECLARE_DYNAMIC_CLASS(wxNcPaintEvent)
920 };
921
922 // Erase background event class
923 /*
924 wxEVT_ERASE_BACKGROUND
925 */
926
927 class WXDLLEXPORT wxEraseEvent : public wxEvent
928 {
929 DECLARE_DYNAMIC_CLASS(wxEraseEvent)
930
931 public:
932 wxDC *m_dc;
933
934 wxEraseEvent(int Id = 0, wxDC *dc = (wxDC *) NULL)
935 { m_eventType = wxEVT_ERASE_BACKGROUND; m_id = Id; m_dc = dc; }
936 wxDC *GetDC() const { return m_dc; }
937
938 void CopyObject(wxObject& obj) const;
939 };
940
941 // Focus event class
942 /*
943 wxEVT_SET_FOCUS
944 wxEVT_KILL_FOCUS
945 */
946
947 class WXDLLEXPORT wxFocusEvent : public wxEvent
948 {
949 public:
950 wxFocusEvent(wxEventType type = wxEVT_NULL, int id = 0)
951 { m_eventType = type; m_id = id; m_win = NULL; }
952
953 // the window associated with this event is the window which had focus
954 // before for SET event and the window which will have focus for the KILL
955 // one
956 //
957 // NB: it may be NULL in both cases!
958 wxWindow *GetWindow() const { return m_win; }
959 void SetWindow(wxWindow *win) { m_win = win; }
960
961 private:
962 wxWindow *m_win;
963
964 DECLARE_DYNAMIC_CLASS(wxFocusEvent)
965 };
966
967 // wxChildFocusEvent notifies the parent that a child has got the focus: unlike
968 // wxFocusEvent it is propgated upwards the window chain
969 class WXDLLEXPORT wxChildFocusEvent : public wxCommandEvent
970 {
971 public:
972 wxChildFocusEvent(wxWindow *win = NULL);
973
974 wxWindow *GetWindow() const { return (wxWindow *)GetEventObject(); }
975
976 DECLARE_DYNAMIC_CLASS(wxChildFocusEvent)
977 };
978
979 // Activate event class
980 /*
981 wxEVT_ACTIVATE
982 wxEVT_ACTIVATE_APP
983 */
984
985 class WXDLLEXPORT wxActivateEvent : public wxEvent
986 {
987 DECLARE_DYNAMIC_CLASS(wxActivateEvent)
988
989 public:
990 wxActivateEvent(wxEventType type = wxEVT_NULL, bool active = TRUE, int Id = 0)
991 { m_eventType = type; m_active = active; m_id = Id; }
992 bool GetActive() const { return m_active; }
993
994 void CopyObject(wxObject& obj) const;
995
996 private:
997 bool m_active;
998 };
999
1000 // InitDialog event class
1001 /*
1002 wxEVT_INIT_DIALOG
1003 */
1004
1005 class WXDLLEXPORT wxInitDialogEvent : public wxEvent
1006 {
1007 DECLARE_DYNAMIC_CLASS(wxInitDialogEvent)
1008
1009 public:
1010 wxInitDialogEvent(int Id = 0)
1011 { m_eventType = wxEVT_INIT_DIALOG; m_id = Id; }
1012 };
1013
1014 // Miscellaneous menu event class
1015 /*
1016 wxEVT_MENU_CHAR,
1017 wxEVT_MENU_INIT,
1018 wxEVT_MENU_HIGHLIGHT,
1019 wxEVT_POPUP_MENU_INIT,
1020 */
1021
1022 class WXDLLEXPORT wxMenuEvent : public wxEvent
1023 {
1024 DECLARE_DYNAMIC_CLASS(wxMenuEvent)
1025
1026 public:
1027 wxMenuEvent(wxEventType type = wxEVT_NULL, int id = 0)
1028 { m_eventType = type; m_menuId = id; }
1029
1030 int GetMenuId() const { return m_menuId; }
1031
1032 void CopyObject(wxObject& obj) const;
1033 private:
1034 int m_menuId;
1035 };
1036
1037 // Window close or session close event class
1038 /*
1039 wxEVT_CLOSE_WINDOW,
1040 wxEVT_END_SESSION,
1041 wxEVT_QUERY_END_SESSION
1042 */
1043
1044 class WXDLLEXPORT wxCloseEvent : public wxEvent
1045 {
1046 DECLARE_DYNAMIC_CLASS(wxCloseEvent)
1047
1048 public:
1049 wxCloseEvent(wxEventType type = wxEVT_NULL, int id = 0)
1050 {
1051 m_eventType = type;
1052 m_loggingOff = TRUE;
1053 m_veto = FALSE; // should be FALSE by default
1054 m_id = id;
1055 #if WXWIN_COMPATIBILITY
1056 m_force = FALSE;
1057 #endif // WXWIN_COMPATIBILITY
1058 m_canVeto = TRUE;
1059 }
1060
1061 void SetLoggingOff(bool logOff) { m_loggingOff = logOff; }
1062 bool GetLoggingOff() const { return m_loggingOff; }
1063
1064 void Veto(bool veto = TRUE)
1065 {
1066 // GetVeto() will return FALSE anyhow...
1067 wxCHECK_RET( m_canVeto,
1068 wxT("call to Veto() ignored (can't veto this event)") );
1069
1070 m_veto = veto;
1071 }
1072 void SetCanVeto(bool canVeto) { m_canVeto = canVeto; }
1073 // No more asserts here please, the one you put here was wrong.
1074 bool CanVeto() const { return m_canVeto; }
1075 bool GetVeto() const { return m_canVeto && m_veto; }
1076
1077 #if WXWIN_COMPATIBILITY
1078 // This is probably obsolete now, since we use CanVeto instead, in
1079 // both OnCloseWindow and OnQueryEndSession.
1080 // m_force == ! m_canVeto i.e., can't veto means we must force it to close.
1081 void SetForce(bool force) { m_force = force; }
1082 bool GetForce() const { return m_force; }
1083 #endif
1084
1085 void CopyObject(wxObject& obj) const;
1086
1087 protected:
1088 bool m_loggingOff;
1089 bool m_veto, m_canVeto;
1090
1091 #if WXWIN_COMPATIBILITY
1092 bool m_force;
1093 #endif
1094 };
1095
1096 /*
1097 wxEVT_SHOW
1098 */
1099
1100 class WXDLLEXPORT wxShowEvent : public wxEvent
1101 {
1102 public:
1103 wxShowEvent(int id = 0, bool show = FALSE)
1104 { m_eventType = wxEVT_SHOW; m_id = id; m_show = show; }
1105
1106 void SetShow(bool show) { m_show = show; }
1107 bool GetShow() const { return m_show; }
1108
1109 void CopyObject(wxObject& obj) const;
1110
1111 protected:
1112 bool m_show;
1113
1114 DECLARE_DYNAMIC_CLASS(wxShowEvent)
1115 };
1116
1117 /*
1118 wxEVT_ICONIZE
1119 */
1120
1121 class WXDLLEXPORT wxIconizeEvent : public wxEvent
1122 {
1123 public:
1124 wxIconizeEvent(int id = 0, bool iconized = TRUE)
1125 { m_eventType = wxEVT_ICONIZE; m_id = id; m_iconized = iconized; }
1126
1127 // return true if the frame was iconized, false if restored
1128 bool Iconized() const { return m_iconized; }
1129
1130 protected:
1131 bool m_iconized;
1132
1133 DECLARE_DYNAMIC_CLASS(wxIconizeEvent)
1134 };
1135
1136 /*
1137 wxEVT_MAXIMIZE
1138 */
1139
1140 class WXDLLEXPORT wxMaximizeEvent : public wxEvent
1141 {
1142 public:
1143 wxMaximizeEvent(int id = 0)
1144 { m_eventType = wxEVT_MAXIMIZE; m_id = id; }
1145
1146 DECLARE_DYNAMIC_CLASS(wxMaximizeEvent)
1147 };
1148
1149 // Joystick event class
1150 /*
1151 wxEVT_JOY_BUTTON_DOWN,
1152 wxEVT_JOY_BUTTON_UP,
1153 wxEVT_JOY_MOVE,
1154 wxEVT_JOY_ZMOVE
1155 */
1156
1157 // Which joystick? Same as Windows ids so no conversion necessary.
1158 #define wxJOYSTICK1 0
1159 #define wxJOYSTICK2 1
1160
1161 // Which button is down?
1162 #define wxJOY_BUTTON1 1
1163 #define wxJOY_BUTTON2 2
1164 #define wxJOY_BUTTON3 4
1165 #define wxJOY_BUTTON4 8
1166 #define wxJOY_BUTTON_ANY -1
1167
1168 class WXDLLEXPORT wxJoystickEvent : public wxEvent
1169 {
1170 DECLARE_DYNAMIC_CLASS(wxJoystickEvent)
1171
1172 public:
1173 wxPoint m_pos;
1174 int m_zPosition;
1175 int m_buttonChange; // Which button changed?
1176 int m_buttonState; // Which buttons are down?
1177 int m_joyStick; // Which joystick?
1178
1179 wxJoystickEvent(wxEventType type = wxEVT_NULL,
1180 int state = 0,
1181 int joystick = wxJOYSTICK1,
1182 int change = 0)
1183 {
1184 m_eventType = type;
1185 m_buttonState = state;
1186 m_pos = wxPoint(0,0);
1187 m_zPosition = 0;
1188 m_joyStick = joystick;
1189 m_buttonChange = change;
1190 }
1191
1192 wxPoint GetPosition() const { return m_pos; }
1193 int GetZPosition() const { return m_zPosition; }
1194 int GetButtonState() const { return m_buttonState; }
1195 int GetButtonChange() const { return m_buttonChange; }
1196 int GetJoystick() const { return m_joyStick; }
1197
1198 void SetJoystick(int stick) { m_joyStick = stick; }
1199 void SetButtonState(int state) { m_buttonState = state; }
1200 void SetButtonChange(int change) { m_buttonChange = change; }
1201 void SetPosition(const wxPoint& pos) { m_pos = pos; }
1202 void SetZPosition(int zPos) { m_zPosition = zPos; }
1203
1204 // Was it a button event? (*doesn't* mean: is any button *down*?)
1205 bool IsButton() const { return ((GetEventType() == wxEVT_JOY_BUTTON_DOWN) ||
1206 (GetEventType() == wxEVT_JOY_BUTTON_UP)); }
1207
1208 // Was it a move event?
1209 bool IsMove() const { return (GetEventType() == wxEVT_JOY_MOVE) ; }
1210
1211 // Was it a zmove event?
1212 bool IsZMove() const { return (GetEventType() == wxEVT_JOY_ZMOVE) ; }
1213
1214 // Was it a down event from button 1, 2, 3, 4 or any?
1215 bool ButtonDown(int but = wxJOY_BUTTON_ANY) const
1216 { return ((GetEventType() == wxEVT_JOY_BUTTON_DOWN) &&
1217 ((but == wxJOY_BUTTON_ANY) || (but == m_buttonChange))); }
1218
1219 // Was it a up event from button 1, 2, 3 or any?
1220 bool ButtonUp(int but = wxJOY_BUTTON_ANY) const
1221 { return ((GetEventType() == wxEVT_JOY_BUTTON_UP) &&
1222 ((but == wxJOY_BUTTON_ANY) || (but == m_buttonChange))); }
1223
1224 // Was the given button 1,2,3,4 or any in Down state?
1225 bool ButtonIsDown(int but = wxJOY_BUTTON_ANY) const
1226 { return (((but == wxJOY_BUTTON_ANY) && (m_buttonState != 0)) ||
1227 ((m_buttonState & but) == but)); }
1228
1229 void CopyObject(wxObject& obj) const;
1230 };
1231
1232 // Drop files event class
1233 /*
1234 wxEVT_DROP_FILES
1235 */
1236
1237 class WXDLLEXPORT wxDropFilesEvent : public wxEvent
1238 {
1239 DECLARE_DYNAMIC_CLASS(wxDropFilesEvent)
1240
1241 public:
1242 int m_noFiles;
1243 wxPoint m_pos;
1244 wxString* m_files; // Memory (de)allocated by code calling ProcessEvent
1245
1246 wxDropFilesEvent(wxEventType type = wxEVT_NULL,
1247 int noFiles = 0,
1248 wxString *files = (wxString *) NULL)
1249 { m_eventType = type; m_noFiles = noFiles; m_files = files; }
1250
1251 wxPoint GetPosition() const { return m_pos; }
1252 int GetNumberOfFiles() const { return m_noFiles; }
1253 wxString *GetFiles() const { return m_files; }
1254
1255 void CopyObject(wxObject& obj) const;
1256 };
1257
1258 // Update UI event
1259 /*
1260 wxEVT_UPDATE_UI
1261 */
1262
1263 class WXDLLEXPORT wxUpdateUIEvent : public wxCommandEvent
1264 {
1265 DECLARE_DYNAMIC_CLASS(wxUpdateUIEvent)
1266
1267 public:
1268 wxUpdateUIEvent(wxWindowID commandId = 0)
1269 {
1270 m_eventType = wxEVT_UPDATE_UI;
1271 m_id = commandId;
1272 m_checked = FALSE;
1273 m_setChecked = FALSE;
1274 m_enabled = FALSE;
1275 m_setEnabled = FALSE;
1276 m_setText = FALSE;
1277 m_text = "";
1278 }
1279
1280 bool GetChecked() const { return m_checked; }
1281 bool GetEnabled() const { return m_enabled; }
1282 wxString GetText() const { return m_text; }
1283 bool GetSetText() const { return m_setText; }
1284 bool GetSetChecked() const { return m_setChecked; }
1285 bool GetSetEnabled() const { return m_setEnabled; }
1286
1287 void Check(bool check) { m_checked = check; m_setChecked = TRUE; }
1288 void Enable(bool enable) { m_enabled = enable; m_setEnabled = TRUE; }
1289 void SetText(const wxString& text) { m_text = text; m_setText = TRUE; }
1290
1291 void CopyObject(wxObject& obj) const;
1292
1293 protected:
1294 bool m_checked;
1295 bool m_enabled;
1296 bool m_setEnabled;
1297 bool m_setText;
1298 bool m_setChecked;
1299 wxString m_text;
1300 };
1301
1302 /*
1303 wxEVT_SYS_COLOUR_CHANGED
1304 */
1305
1306 // TODO: shouldn't all events record the window ID?
1307 class WXDLLEXPORT wxSysColourChangedEvent : public wxEvent
1308 {
1309 DECLARE_DYNAMIC_CLASS(wxSysColourChangedEvent)
1310
1311 public:
1312 wxSysColourChangedEvent()
1313 { m_eventType = wxEVT_SYS_COLOUR_CHANGED; }
1314 };
1315
1316 /*
1317 wxEVT_PALETTE_CHANGED
1318 */
1319
1320 class WXDLLEXPORT wxPaletteChangedEvent : public wxEvent
1321 {
1322 DECLARE_DYNAMIC_CLASS(wxPaletteChangedEvent)
1323
1324 public:
1325 wxPaletteChangedEvent(wxWindowID id = 0) : wxEvent(id)
1326 {
1327 m_eventType = wxEVT_PALETTE_CHANGED;
1328 m_changedWindow = (wxWindow *) NULL;
1329 }
1330
1331 void SetChangedWindow(wxWindow* win) { m_changedWindow = win; }
1332 wxWindow* GetChangedWindow() const { return m_changedWindow; }
1333
1334 void CopyObject(wxObject& obj) const;
1335
1336 protected:
1337 wxWindow* m_changedWindow;
1338 };
1339
1340 /*
1341 wxEVT_QUERY_NEW_PALETTE
1342 Indicates the window is getting keyboard focus and should re-do its palette.
1343 */
1344
1345 class WXDLLEXPORT wxQueryNewPaletteEvent : public wxEvent
1346 {
1347 DECLARE_DYNAMIC_CLASS(wxQueryNewPaletteEvent)
1348
1349 public:
1350 wxQueryNewPaletteEvent(wxWindowID id = 0): wxEvent(id)
1351 { m_eventType = wxEVT_QUERY_NEW_PALETTE; m_paletteRealized = FALSE; }
1352
1353 // App sets this if it changes the palette.
1354 void SetPaletteRealized(bool realized) { m_paletteRealized = realized; }
1355 bool GetPaletteRealized() const { return m_paletteRealized; }
1356
1357 void CopyObject(wxObject& obj) const;
1358
1359 protected:
1360 bool m_paletteRealized;
1361 };
1362
1363 /*
1364 Event generated by dialog navigation keys
1365 wxEVT_NAVIGATION_KEY
1366 */
1367 // NB: don't derive from command event to avoid being propagated to the parent
1368 class WXDLLEXPORT wxNavigationKeyEvent : public wxEvent
1369 {
1370 public:
1371 wxNavigationKeyEvent()
1372 {
1373 SetEventType(wxEVT_NAVIGATION_KEY);
1374
1375 m_flags = IsForward | Propagate; // defaults are for TAB
1376 m_focus = (wxWindow *)NULL;
1377 }
1378
1379 // direction: forward (true) or backward (false)
1380 bool GetDirection() const
1381 { return (m_flags & IsForward) != 0; }
1382 void SetDirection(bool bForward)
1383 { if ( bForward ) m_flags |= IsForward; else m_flags &= ~IsForward; }
1384
1385 // it may be a window change event (MDI, notebook pages...) or a control
1386 // change event
1387 bool IsWindowChange() const
1388 { return (m_flags & WinChange) != 0; }
1389 void SetWindowChange(bool bIs)
1390 { if ( bIs ) m_flags |= WinChange; else m_flags &= ~WinChange; }
1391
1392 // some navigation events are meant to be propagated upwards (Windows
1393 // convention is to do this for TAB events) while others should always
1394 // cycle inside the panel/radiobox/whatever we're current inside
1395 bool ShouldPropagate() const
1396 { return (m_flags & Propagate) != 0; }
1397 void SetPropagate(bool bDoIt)
1398 { if ( bDoIt ) m_flags |= Propagate; else m_flags &= ~Propagate; }
1399
1400 // the child which has the focus currently (may be NULL - use
1401 // wxWindow::FindFocus then)
1402 wxWindow* GetCurrentFocus() const { return m_focus; }
1403 void SetCurrentFocus(wxWindow *win) { m_focus = win; }
1404
1405 private:
1406 enum
1407 {
1408 IsForward = 0x0001,
1409 WinChange = 0x0002,
1410 Propagate = 0x0004
1411 };
1412
1413 long m_flags;
1414 wxWindow *m_focus;
1415
1416 DECLARE_DYNAMIC_CLASS(wxNavigationKeyEvent)
1417 };
1418
1419 // Window creation/destruction events: the first is sent as soon as window is
1420 // created (i.e. the underlying GUI object exists), but when the C++ object is
1421 // fully initialized (so virtual functions may be called). The second,
1422 // wxEVT_DESTROY, is sent right before the window is destroyed - again, it's
1423 // still safe to call virtual functions at this moment
1424 /*
1425 wxEVT_CREATE
1426 wxEVT_DESTROY
1427 */
1428
1429 class WXDLLEXPORT wxWindowCreateEvent : public wxCommandEvent
1430 {
1431 DECLARE_DYNAMIC_CLASS(wxWindowCreateEvent)
1432
1433 public:
1434 wxWindowCreateEvent(wxWindow *win = NULL);
1435
1436 wxWindow *GetWindow() const { return (wxWindow *)GetEventObject(); }
1437 };
1438
1439 class WXDLLEXPORT wxWindowDestroyEvent : public wxCommandEvent
1440 {
1441 DECLARE_DYNAMIC_CLASS(wxWindowDestroyEvent)
1442
1443 public:
1444 wxWindowDestroyEvent(wxWindow *win = NULL);
1445
1446 wxWindow *GetWindow() const { return (wxWindow *)GetEventObject(); }
1447 };
1448
1449 // A help event is sent when the user clicks on a window in context-help mode.
1450 /*
1451 wxEVT_HELP
1452 wxEVT_DETAILED_HELP
1453 */
1454
1455 class WXDLLEXPORT wxHelpEvent : public wxCommandEvent
1456 {
1457 public:
1458 wxHelpEvent(wxEventType type = wxEVT_NULL,
1459 wxWindowID id = 0,
1460 const wxPoint& pt = wxDefaultPosition)
1461 {
1462 m_eventType = type;
1463 m_id = id;
1464 m_pos = pt;
1465 }
1466
1467 // Position of event (in screen coordinates)
1468 const wxPoint& GetPosition() const { return m_pos; }
1469 void SetPosition(const wxPoint& pos) { m_pos = pos; }
1470
1471 // Optional link to further help
1472 const wxString& GetLink() const { return m_link; }
1473 void SetLink(const wxString& link) { m_link = link; }
1474
1475 // Optional target to display help in. E.g. a window specification
1476 const wxString& GetTarget() const { return m_target; }
1477 void SetTarget(const wxString& target) { m_target = target; }
1478
1479 protected:
1480 wxPoint m_pos;
1481 wxString m_target;
1482 wxString m_link;
1483
1484 private:
1485 DECLARE_DYNAMIC_CLASS(wxHelpEvent)
1486 };
1487
1488 // A Context event is sent when the user right clicks on a window or
1489 // presses Shift-F10
1490 // NOTE : Under windows this is a repackaged WM_CONTETXMENU message
1491 // Under other systems it may have to be generated from a right click event
1492 /*
1493 wxEVT_CONTEXT_MENU
1494 */
1495
1496 class WXDLLEXPORT wxContextMenuEvent : public wxCommandEvent
1497 {
1498 public:
1499 wxContextMenuEvent(wxEventType type = wxEVT_NULL,
1500 wxWindowID id = 0,
1501 const wxPoint& pt = wxDefaultPosition)
1502 {
1503 m_eventType = type;
1504 m_id = id;
1505 m_pos = pt;
1506 }
1507
1508 // Position of event (in screen coordinates)
1509 const wxPoint& GetPosition() const { return m_pos; }
1510 void SetPosition(const wxPoint& pos) { m_pos = pos; }
1511
1512 protected:
1513 wxPoint m_pos;
1514
1515 private:
1516 DECLARE_DYNAMIC_CLASS(wxContextMenuEvent)
1517 };
1518
1519 // Idle event
1520 /*
1521 wxEVT_IDLE
1522 */
1523
1524 class WXDLLEXPORT wxIdleEvent : public wxEvent
1525 {
1526 DECLARE_DYNAMIC_CLASS(wxIdleEvent)
1527
1528 public:
1529 wxIdleEvent()
1530 { m_eventType = wxEVT_IDLE; m_requestMore = FALSE; }
1531
1532 void RequestMore(bool needMore = TRUE) { m_requestMore = needMore; }
1533 bool MoreRequested() const { return m_requestMore; }
1534
1535 void CopyObject(wxObject& obj) const;
1536
1537 protected:
1538 bool m_requestMore;
1539 };
1540
1541 #endif // wxUSE_GUI
1542
1543 /* TODO
1544 wxEVT_POWER,
1545 wxEVT_MOUSE_CAPTURE_CHANGED,
1546 wxEVT_SETTING_CHANGED, // WM_WININICHANGE (NT) / WM_SETTINGCHANGE (Win95)
1547 // wxEVT_FONT_CHANGED, // WM_FONTCHANGE: roll into wxEVT_SETTING_CHANGED, but remember to propagate
1548 // wxEVT_FONT_CHANGED to all other windows (maybe).
1549 wxEVT_DRAW_ITEM, // Leave these three as virtual functions in wxControl?? Platform-specific.
1550 wxEVT_MEASURE_ITEM,
1551 wxEVT_COMPARE_ITEM
1552 */
1553
1554 // ============================================================================
1555 // event handler and related classes
1556 // ============================================================================
1557
1558 typedef void (wxObject::*wxObjectEventFunction)(wxEvent&);
1559
1560 // we can't have ctors nor base struct in backwards compatibility mode or
1561 // otherwise we won't be able to initialize the objects with an agregate, so
1562 // we have to keep both versions
1563 #if WXWIN_COMPATIBILITY_EVENT_TYPES
1564
1565 struct WXDLLEXPORT wxEventTableEntry
1566 {
1567 // For some reason, this can't be wxEventType, or VC++ complains.
1568 int m_eventType; // main event type
1569 int m_id; // control/menu/toolbar id
1570 int m_lastId; // used for ranges of ids
1571 wxObjectEventFunction m_fn; // function to call: not wxEventFunction,
1572 // because of dependency problems
1573
1574 wxObject* m_callbackUserData;
1575 };
1576
1577 #else // !WXWIN_COMPATIBILITY_EVENT_TYPES
1578
1579 // struct containing the members common to static and dynamic event tables
1580 // entries
1581 struct WXDLLEXPORT wxEventTableEntryBase
1582 {
1583 wxEventTableEntryBase(int id, int idLast,
1584 wxObjectEventFunction fn, wxObject *data)
1585 {
1586 m_id = id;
1587 m_lastId = idLast;
1588 m_fn = fn;
1589 m_callbackUserData = data;
1590 }
1591
1592 // the range of ids for this entry: if m_lastId == -1, the range consists
1593 // only of m_id, otherwise it is m_id..m_lastId inclusive
1594 int m_id, m_lastId;
1595
1596 // function to call: not wxEventFunction, because of dependency problems
1597 wxObjectEventFunction m_fn;
1598
1599 // arbitrary user data asosciated with the callback
1600 wxObject* m_callbackUserData;
1601 };
1602
1603 // an entry from a static event table
1604 struct WXDLLEXPORT wxEventTableEntry : public wxEventTableEntryBase
1605 {
1606 wxEventTableEntry(const int& evType, int id, int idLast,
1607 wxObjectEventFunction fn, wxObject *data)
1608 : wxEventTableEntryBase(id, idLast, fn, data),
1609 m_eventType(evType)
1610 {
1611 }
1612
1613 // the reference to event type: this allows us to not care about the
1614 // (undefined) order in which the event table entries and the event types
1615 // are initialized: initially the value of this reference might be
1616 // invalid, but by the time it is used for the first time, all global
1617 // objects will have been initialized (including the event type constants)
1618 // and so it will have the correct value when it is needed
1619 const int& m_eventType;
1620 };
1621
1622 // an entry used in dynamic event table managed by wxEvtHandler::Connect()
1623 struct WXDLLEXPORT wxDynamicEventTableEntry : public wxEventTableEntryBase
1624 {
1625 wxDynamicEventTableEntry(int evType, int id, int idLast,
1626 wxObjectEventFunction fn, wxObject *data)
1627 : wxEventTableEntryBase(id, idLast, fn, data)
1628 {
1629 m_eventType = evType;
1630 }
1631
1632 // not a reference here as we can't keep a reference to a temporary int
1633 // created to wrap the constant value typically passed to Connect() - nor
1634 // do we need it
1635 int m_eventType;
1636 };
1637
1638 #endif // !WXWIN_COMPATIBILITY_EVENT_TYPES
1639
1640 // ----------------------------------------------------------------------------
1641 // wxEventTable: an array of event entries terminated with {0, 0, 0, 0, 0}
1642 // ----------------------------------------------------------------------------
1643 struct WXDLLEXPORT wxEventTable
1644 {
1645 const wxEventTable *baseTable; // base event table (next in chain)
1646 const wxEventTableEntry *entries; // bottom of entry array
1647 };
1648
1649 // ----------------------------------------------------------------------------
1650 // wxEvtHandler: the base class for all objects handling wxWindows events
1651 // ----------------------------------------------------------------------------
1652
1653 class WXDLLEXPORT wxEvtHandler : public wxObject
1654 {
1655 public:
1656 wxEvtHandler();
1657 virtual ~wxEvtHandler();
1658
1659 wxEvtHandler *GetNextHandler() const { return m_nextHandler; }
1660 wxEvtHandler *GetPreviousHandler() const { return m_previousHandler; }
1661 void SetNextHandler(wxEvtHandler *handler) { m_nextHandler = handler; }
1662 void SetPreviousHandler(wxEvtHandler *handler) { m_previousHandler = handler; }
1663
1664 void SetEvtHandlerEnabled(bool enabled) { m_enabled = enabled; }
1665 bool GetEvtHandlerEnabled() const { return m_enabled; }
1666
1667 // process an event right now
1668 virtual bool ProcessEvent(wxEvent& event);
1669
1670 // add an event to be processed later
1671 void AddPendingEvent(wxEvent& event);
1672
1673 // process all pending events
1674 void ProcessPendingEvents();
1675
1676 // add a
1677 #if wxUSE_THREADS
1678 bool ProcessThreadEvent(wxEvent& event);
1679 #endif
1680
1681 // Dynamic association of a member function handler with the event handler,
1682 // id and event type
1683 void Connect( int id, int lastId, int eventType,
1684 wxObjectEventFunction func,
1685 wxObject *userData = (wxObject *) NULL );
1686
1687 // Convenience function: take just one id
1688 void Connect( int id, int eventType,
1689 wxObjectEventFunction func,
1690 wxObject *userData = (wxObject *) NULL )
1691 { Connect(id, -1, eventType, func, userData); }
1692
1693 bool Disconnect( int id, int lastId, wxEventType eventType,
1694 wxObjectEventFunction func = NULL,
1695 wxObject *userData = (wxObject *) NULL );
1696
1697 // Convenience function: take just one id
1698 bool Disconnect( int id, wxEventType eventType = wxEVT_NULL,
1699 wxObjectEventFunction func = NULL,
1700 wxObject *userData = (wxObject *) NULL )
1701 { return Disconnect(id, -1, eventType, func, userData); }
1702
1703 // implementation from now on
1704 virtual bool SearchEventTable(wxEventTable& table, wxEvent& event);
1705 bool SearchDynamicEventTable( wxEvent& event );
1706
1707 #if wxUSE_THREADS
1708 void ClearEventLocker()
1709 {
1710 # if !defined(__VISAGECPP__)
1711 delete m_eventsLocker;
1712 m_eventsLocker = NULL;
1713 #endif
1714 };
1715 #endif
1716
1717 // old stuff
1718
1719 #if WXWIN_COMPATIBILITY_2
1720 virtual void OnCommand(wxWindow& WXUNUSED(win),
1721 wxCommandEvent& WXUNUSED(event))
1722 {
1723 wxFAIL_MSG(wxT("shouldn't be called any more"));
1724 }
1725
1726 // Called if child control has no callback function
1727 virtual long Default()
1728 { return GetNextHandler() ? GetNextHandler()->Default() : 0; };
1729 #endif // WXWIN_COMPATIBILITY_2
1730
1731 #if WXWIN_COMPATIBILITY
1732 virtual bool OnClose();
1733 #endif
1734
1735 private:
1736 static const wxEventTableEntry sm_eventTableEntries[];
1737
1738 protected:
1739 static const wxEventTable sm_eventTable;
1740
1741 virtual const wxEventTable *GetEventTable() const;
1742
1743 wxEvtHandler* m_nextHandler;
1744 wxEvtHandler* m_previousHandler;
1745 wxList* m_dynamicEvents;
1746 wxList* m_pendingEvents;
1747
1748 #if wxUSE_THREADS
1749 #if defined (__VISAGECPP__)
1750 wxCriticalSection m_eventsLocker;
1751 # else
1752 wxCriticalSection* m_eventsLocker;
1753 # endif
1754 #endif
1755
1756 // optimization: instead of using costly IsKindOf() to decide whether we're
1757 // a window (which is true in 99% of cases), use this flag
1758 bool m_isWindow;
1759
1760 // Is event handler enabled?
1761 bool m_enabled;
1762
1763 private:
1764 DECLARE_DYNAMIC_CLASS(wxEvtHandler)
1765 };
1766
1767 typedef void (wxEvtHandler::*wxEventFunction)(wxEvent&);
1768 #if wxUSE_GUI
1769 typedef void (wxEvtHandler::*wxCommandEventFunction)(wxCommandEvent&);
1770 typedef void (wxEvtHandler::*wxScrollEventFunction)(wxScrollEvent&);
1771 typedef void (wxEvtHandler::*wxScrollWinEventFunction)(wxScrollWinEvent&);
1772 typedef void (wxEvtHandler::*wxSizeEventFunction)(wxSizeEvent&);
1773 typedef void (wxEvtHandler::*wxMoveEventFunction)(wxMoveEvent&);
1774 typedef void (wxEvtHandler::*wxPaintEventFunction)(wxPaintEvent&);
1775 typedef void (wxEvtHandler::*wxEraseEventFunction)(wxEraseEvent&);
1776 typedef void (wxEvtHandler::*wxMouseEventFunction)(wxMouseEvent&);
1777 typedef void (wxEvtHandler::*wxCharEventFunction)(wxKeyEvent&);
1778 typedef void (wxEvtHandler::*wxFocusEventFunction)(wxFocusEvent&);
1779 typedef void (wxEvtHandler::*wxChildFocusEventFunction)(wxChildFocusEvent&);
1780 typedef void (wxEvtHandler::*wxActivateEventFunction)(wxActivateEvent&);
1781 typedef void (wxEvtHandler::*wxMenuEventFunction)(wxMenuEvent&);
1782 typedef void (wxEvtHandler::*wxJoystickEventFunction)(wxJoystickEvent&);
1783 typedef void (wxEvtHandler::*wxDropFilesEventFunction)(wxDropFilesEvent&);
1784 typedef void (wxEvtHandler::*wxInitDialogEventFunction)(wxInitDialogEvent&);
1785 typedef void (wxEvtHandler::*wxSysColourChangedFunction)(wxSysColourChangedEvent&);
1786 typedef void (wxEvtHandler::*wxUpdateUIEventFunction)(wxUpdateUIEvent&);
1787 typedef void (wxEvtHandler::*wxIdleEventFunction)(wxIdleEvent&);
1788 typedef void (wxEvtHandler::*wxCloseEventFunction)(wxCloseEvent&);
1789 typedef void (wxEvtHandler::*wxShowEventFunction)(wxShowEvent&);
1790 typedef void (wxEvtHandler::*wxIconizeEventFunction)(wxShowEvent&);
1791 typedef void (wxEvtHandler::*wxMaximizeEventFunction)(wxShowEvent&);
1792 typedef void (wxEvtHandler::*wxNavigationKeyEventFunction)(wxNavigationKeyEvent&);
1793 typedef void (wxEvtHandler::*wxPaletteChangedEventFunction)(wxPaletteChangedEvent&);
1794 typedef void (wxEvtHandler::*wxQueryNewPaletteEventFunction)(wxQueryNewPaletteEvent&);
1795 typedef void (wxEvtHandler::*wxWindowCreateEventFunction)(wxWindowCreateEvent&);
1796 typedef void (wxEvtHandler::*wxWindowDestroyEventFunction)(wxWindowDestroyEvent&);
1797 typedef void (wxEvtHandler::*wxSetCursorEventFunction)(wxSetCursorEvent&);
1798 typedef void (wxEvtHandler::*wxNotifyEventFunction)(wxNotifyEvent&);
1799 typedef void (wxEvtHandler::*wxHelpEventFunction)(wxHelpEvent&);
1800 typedef void (wxEvtHandler::*wxContextMenuEventFunction)(wxContextMenuEvent&);
1801 #endif // wxUSE_GUI
1802
1803 // N.B. In GNU-WIN32, you *have* to take the address of a member function
1804 // (use &) or the compiler crashes...
1805
1806 #define DECLARE_EVENT_TABLE() \
1807 private: \
1808 static const wxEventTableEntry sm_eventTableEntries[]; \
1809 protected: \
1810 static const wxEventTable sm_eventTable; \
1811 virtual const wxEventTable* GetEventTable() const;
1812
1813 #define BEGIN_EVENT_TABLE(theClass, baseClass) \
1814 const wxEventTable *theClass::GetEventTable() const \
1815 { return &theClass::sm_eventTable; } \
1816 const wxEventTable theClass::sm_eventTable = \
1817 { &baseClass::sm_eventTable, &theClass::sm_eventTableEntries[0] }; \
1818 const wxEventTableEntry theClass::sm_eventTableEntries[] = { \
1819
1820 #define END_EVENT_TABLE() DECLARE_EVENT_TABLE_ENTRY( wxEVT_NULL, 0, 0, 0, 0 ) };
1821
1822 /*
1823 * Event table macros
1824 */
1825
1826 // Generic events
1827 #define EVT_CUSTOM(event, id, func) DECLARE_EVENT_TABLE_ENTRY( event, id, -1, (wxObjectEventFunction) (wxEventFunction) & func, (wxObject *) NULL ),
1828 #define EVT_CUSTOM_RANGE(event, id1, id2, func) DECLARE_EVENT_TABLE_ENTRY( event, id1, id2, (wxObjectEventFunction) (wxEventFunction) & func, (wxObject *) NULL ),
1829
1830 // Miscellaneous
1831 #define EVT_SIZE(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SIZE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxSizeEventFunction) & func, (wxObject *) NULL ),
1832 #define EVT_MOVE(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_MOVE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMoveEventFunction) & func, (wxObject *) NULL ),
1833 #define EVT_CLOSE(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_CLOSE_WINDOW, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCloseEventFunction) & func, (wxObject *) NULL ),
1834 #define EVT_END_SESSION(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_END_SESSION, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCloseEventFunction) & func, (wxObject *) NULL ),
1835 #define EVT_QUERY_END_SESSION(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_QUERY_END_SESSION, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCloseEventFunction) & func, (wxObject *) NULL ),
1836 #define EVT_PAINT(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_PAINT, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxPaintEventFunction) & func, (wxObject *) NULL ),
1837 #define EVT_NC_PAINT(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_NC_PAINT, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxPaintEventFunction) & func, (wxObject *) NULL ),
1838 #define EVT_ERASE_BACKGROUND(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_ERASE_BACKGROUND, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxEraseEventFunction) & func, (wxObject *) NULL ),
1839 #define EVT_CHAR(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_CHAR, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCharEventFunction) & func, (wxObject *) NULL ),
1840 #define EVT_KEY_DOWN(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_KEY_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCharEventFunction) & func, (wxObject *) NULL ),
1841 #define EVT_KEY_UP(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_KEY_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCharEventFunction) & func, (wxObject *) NULL ),
1842 #define EVT_CHAR_HOOK(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_CHAR_HOOK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCharEventFunction) & func, NULL ),
1843 #define EVT_MENU_HIGHLIGHT(id, func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_MENU_HIGHLIGHT, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxMenuEventFunction) & func, (wxObject *) NULL ),
1844 #define EVT_MENU_HIGHLIGHT_ALL(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_MENU_HIGHLIGHT, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMenuEventFunction) & func, (wxObject *) NULL ),
1845 #define EVT_SET_FOCUS(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SET_FOCUS, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxFocusEventFunction) & func, (wxObject *) NULL ),
1846 #define EVT_KILL_FOCUS(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_KILL_FOCUS, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxFocusEventFunction) & func, (wxObject *) NULL ),
1847 #define EVT_CHILD_FOCUS(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_CHILD_FOCUS, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) (wxChildFocusEventFunction) & func, (wxObject *) NULL ),
1848 #define EVT_ACTIVATE(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_ACTIVATE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxActivateEventFunction) & func, (wxObject *) NULL ),
1849 #define EVT_ACTIVATE_APP(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_ACTIVATE_APP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxActivateEventFunction) & func, (wxObject *) NULL ),
1850 #define EVT_END_SESSION(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_END_SESSION, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCloseEventFunction) & func, (wxObject *) NULL ),
1851 #define EVT_QUERY_END_SESSION(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_QUERY_END_SESSION, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCloseEventFunction) & func, (wxObject *) NULL ),
1852 #define EVT_DROP_FILES(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_DROP_FILES, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxDropFilesEventFunction) & func, (wxObject *) NULL ),
1853 #define EVT_INIT_DIALOG(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_INIT_DIALOG, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxInitDialogEventFunction) & func, (wxObject *) NULL ),
1854 #define EVT_SYS_COLOUR_CHANGED(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SYS_COLOUR_CHANGED, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxSysColourChangedFunction) & func, (wxObject *) NULL ),
1855 #define EVT_SHOW(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SHOW, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxShowEventFunction) & func, (wxObject *) NULL ),
1856 #define EVT_MAXIMIZE(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_MAXIMIZE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMaximizeEventFunction) & func, (wxObject *) NULL ),
1857 #define EVT_ICONIZE(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_ICONIZE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxIconizeEventFunction) & func, (wxObject *) NULL ),
1858 #define EVT_NAVIGATION_KEY(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_NAVIGATION_KEY, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) (wxNavigationKeyEventFunction) & func, (wxObject *) NULL ),
1859 #define EVT_PALETTE_CHANGED(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_PALETTE_CHANGED, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxPaletteChangedEventFunction) & func, (wxObject *) NULL ),
1860 #define EVT_QUERY_NEW_PALETTE(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_QUERY_NEW_PALETTE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxQueryNewPaletteEventFunction) & func, (wxObject *) NULL ),
1861 #define EVT_WINDOW_CREATE(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_CREATE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxWindowCreateEventFunction) & func, (wxObject *) NULL ),
1862 #define EVT_WINDOW_DESTROY(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_DESTROY, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxWindowDestroyEventFunction) & func, (wxObject *) NULL ),
1863 #define EVT_SET_CURSOR(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SET_CURSOR, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxSetCursorEventFunction) & func, (wxObject *) NULL ),
1864
1865 // Mouse events
1866 #define EVT_LEFT_DOWN(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_LEFT_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),
1867 #define EVT_LEFT_UP(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_LEFT_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),
1868 #define EVT_MIDDLE_DOWN(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_MIDDLE_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),
1869 #define EVT_MIDDLE_UP(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_MIDDLE_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),
1870 #define EVT_RIGHT_DOWN(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_RIGHT_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),
1871 #define EVT_RIGHT_UP(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_RIGHT_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),
1872 #define EVT_MOTION(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_MOTION, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),
1873 #define EVT_LEFT_DCLICK(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_LEFT_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),
1874 #define EVT_MIDDLE_DCLICK(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_MIDDLE_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),
1875 #define EVT_RIGHT_DCLICK(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_RIGHT_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),
1876 #define EVT_LEAVE_WINDOW(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_LEAVE_WINDOW, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),
1877 #define EVT_ENTER_WINDOW(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_ENTER_WINDOW, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),
1878 #define EVT_MOUSEWHEEL(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_MOUSEWHEEL, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),
1879
1880 // All mouse events
1881 #define EVT_MOUSE_EVENTS(func) \
1882 DECLARE_EVENT_TABLE_ENTRY( wxEVT_LEFT_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),\
1883 DECLARE_EVENT_TABLE_ENTRY( wxEVT_LEFT_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),\
1884 DECLARE_EVENT_TABLE_ENTRY( wxEVT_MIDDLE_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),\
1885 DECLARE_EVENT_TABLE_ENTRY( wxEVT_MIDDLE_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),\
1886 DECLARE_EVENT_TABLE_ENTRY( wxEVT_RIGHT_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),\
1887 DECLARE_EVENT_TABLE_ENTRY( wxEVT_RIGHT_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),\
1888 DECLARE_EVENT_TABLE_ENTRY( wxEVT_MOTION, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),\
1889 DECLARE_EVENT_TABLE_ENTRY( wxEVT_LEFT_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),\
1890 DECLARE_EVENT_TABLE_ENTRY( wxEVT_MIDDLE_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),\
1891 DECLARE_EVENT_TABLE_ENTRY( wxEVT_RIGHT_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),\
1892 DECLARE_EVENT_TABLE_ENTRY( wxEVT_ENTER_WINDOW, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),\
1893 DECLARE_EVENT_TABLE_ENTRY( wxEVT_LEAVE_WINDOW, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),\
1894 DECLARE_EVENT_TABLE_ENTRY( wxEVT_MOUSEWHEEL, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL ),
1895
1896 // EVT_COMMAND
1897 #define EVT_COMMAND(id, event, fn) DECLARE_EVENT_TABLE_ENTRY( event, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1898 #define EVT_COMMAND_RANGE(id1, id2, event, fn) DECLARE_EVENT_TABLE_ENTRY( event, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1899
1900 // Scrolling from wxWindow (sent to wxScrolledWindow)
1901 #define EVT_SCROLLWIN(func) \
1902 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLLWIN_TOP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL ),\
1903 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLLWIN_BOTTOM, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL ),\
1904 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLLWIN_LINEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL ),\
1905 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLLWIN_LINEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL ),\
1906 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLLWIN_PAGEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL ),\
1907 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLLWIN_PAGEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL ),\
1908 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLLWIN_THUMBTRACK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL ),\
1909 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLLWIN_THUMBRELEASE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL ),
1910
1911 #define EVT_SCROLLWIN_TOP(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLLWIN_TOP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL ),
1912 #define EVT_SCROLLWIN_BOTTOM(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLLWIN_BOTTOM, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL ),
1913 #define EVT_SCROLLWIN_LINEUP(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLLWIN_LINEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL ),
1914 #define EVT_SCROLLWIN_LINEDOWN(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLLWIN_LINEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL ),
1915 #define EVT_SCROLLWIN_PAGEUP(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLLWIN_PAGEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL ),
1916 #define EVT_SCROLLWIN_PAGEDOWN(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLLWIN_PAGEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL ),
1917 #define EVT_SCROLLWIN_THUMBTRACK(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLLWIN_THUMBTRACK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL ),
1918 #define EVT_SCROLLWIN_THUMBRELEASE(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLLWIN_THUMBRELEASE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL ),
1919
1920 // Scrolling from wxSlider and wxScrollBar
1921 #define EVT_SCROLL(func) \
1922 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_TOP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),\
1923 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_BOTTOM, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),\
1924 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_LINEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),\
1925 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_LINEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),\
1926 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_PAGEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),\
1927 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_PAGEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),\
1928 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_THUMBTRACK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),\
1929 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_THUMBRELEASE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),
1930
1931 #define EVT_SCROLL_TOP(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_TOP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),
1932 #define EVT_SCROLL_BOTTOM(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_BOTTOM, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),
1933 #define EVT_SCROLL_LINEUP(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_LINEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),
1934 #define EVT_SCROLL_LINEDOWN(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_LINEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),
1935 #define EVT_SCROLL_PAGEUP(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_PAGEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),
1936 #define EVT_SCROLL_PAGEDOWN(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_PAGEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),
1937 #define EVT_SCROLL_THUMBTRACK(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_THUMBTRACK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),
1938 #define EVT_SCROLL_THUMBRELEASE(func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_THUMBRELEASE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),
1939
1940 // Scrolling from wxSlider and wxScrollBar, with an id
1941 #define EVT_COMMAND_SCROLL(id, func) \
1942 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_TOP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),\
1943 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_BOTTOM, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),\
1944 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_LINEUP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),\
1945 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_LINEDOWN, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),\
1946 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_PAGEUP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),\
1947 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_PAGEDOWN, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),\
1948 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_THUMBTRACK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),\
1949 DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_THUMBRELEASE, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),
1950
1951 #define EVT_COMMAND_SCROLL_TOP(id, func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_TOP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),
1952 #define EVT_COMMAND_SCROLL_BOTTOM(id, func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_BOTTOM, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),
1953 #define EVT_COMMAND_SCROLL_LINEUP(id, func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_LINEUP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),
1954 #define EVT_COMMAND_SCROLL_LINEDOWN(id, func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_LINEDOWN, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),
1955 #define EVT_COMMAND_SCROLL_PAGEUP(id, func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_PAGEUP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),
1956 #define EVT_COMMAND_SCROLL_PAGEDOWN(id, func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_PAGEDOWN, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),
1957 #define EVT_COMMAND_SCROLL_THUMBTRACK(id, func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_THUMBTRACK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),
1958 #define EVT_COMMAND_SCROLL_THUMBRELEASE(id, func) DECLARE_EVENT_TABLE_ENTRY( wxEVT_SCROLL_THUMBRELEASE, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL ),
1959
1960 // Convenience macros for commonly-used commands
1961 #define EVT_BUTTON(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_BUTTON_CLICKED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1962 #define EVT_CHECKBOX(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_CHECKBOX_CLICKED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1963 #define EVT_CHOICE(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_CHOICE_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1964 #define EVT_LISTBOX(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_LISTBOX_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1965 #define EVT_LISTBOX_DCLICK(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_LISTBOX_DOUBLECLICKED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1966 #define EVT_MENU(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_MENU_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1967 #define EVT_MENU_RANGE(id1, id2, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_MENU_SELECTED, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1968 #define EVT_SLIDER(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_SLIDER_UPDATED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1969 #define EVT_RADIOBOX(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RADIOBOX_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1970 #define EVT_RADIOBUTTON(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RADIOBUTTON_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1971 // EVT_SCROLLBAR is now obsolete since we use EVT_COMMAND_SCROLL... events
1972 #define EVT_SCROLLBAR(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_SCROLLBAR_UPDATED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1973 #define EVT_VLBOX(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_VLBOX_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1974 #define EVT_COMBOBOX(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_COMBOBOX_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1975 #define EVT_TOOL(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_TOOL_CLICKED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1976 #define EVT_TOOL_RANGE(id1, id2, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_TOOL_CLICKED, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1977 #define EVT_TOOL_RCLICKED(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_TOOL_RCLICKED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1978 #define EVT_TOOL_RCLICKED_RANGE(id1, id2, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_TOOL_RCLICKED, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1979 #define EVT_TOOL_ENTER(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_TOOL_ENTER, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1980 #define EVT_CHECKLISTBOX(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_CHECKLISTBOX_TOGGLED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1981
1982 // Generic command events
1983 #define EVT_COMMAND_LEFT_CLICK(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_LEFT_CLICK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1984 #define EVT_COMMAND_LEFT_DCLICK(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_LEFT_DCLICK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1985 #define EVT_COMMAND_RIGHT_CLICK(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RIGHT_CLICK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1986 #define EVT_COMMAND_RIGHT_DCLICK(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_RIGHT_DCLICK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1987 #define EVT_COMMAND_SET_FOCUS(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_SET_FOCUS, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1988 #define EVT_COMMAND_KILL_FOCUS(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_KILL_FOCUS, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1989 #define EVT_COMMAND_ENTER(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_ENTER, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
1990
1991 // Joystick events
1992 #define EVT_JOY_DOWN(func) \
1993 DECLARE_EVENT_TABLE_ENTRY( wxEVT_JOY_BUTTON_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL ),
1994 #define EVT_JOY_UP(func) \
1995 DECLARE_EVENT_TABLE_ENTRY( wxEVT_JOY_BUTTON_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL ),
1996 #define EVT_JOY_MOVE(func) \
1997 DECLARE_EVENT_TABLE_ENTRY( wxEVT_JOY_MOVE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL ),
1998 #define EVT_JOY_ZMOVE(func) \
1999 DECLARE_EVENT_TABLE_ENTRY( wxEVT_JOY_ZMOVE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL ),
2000
2001 // All joystick events
2002 #define EVT_JOYSTICK_EVENTS(func) \
2003 DECLARE_EVENT_TABLE_ENTRY( wxEVT_JOY_BUTTON_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL ),\
2004 DECLARE_EVENT_TABLE_ENTRY( wxEVT_JOY_BUTTON_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL ),\
2005 DECLARE_EVENT_TABLE_ENTRY( wxEVT_JOY_MOVE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL ),\
2006 DECLARE_EVENT_TABLE_ENTRY( wxEVT_JOY_ZMOVE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL ),
2007
2008 // Idle event
2009 #define EVT_IDLE(func) \
2010 DECLARE_EVENT_TABLE_ENTRY( wxEVT_IDLE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxIdleEventFunction) & func, (wxObject *) NULL ),
2011
2012 // Update UI event
2013 #define EVT_UPDATE_UI(id, func) \
2014 DECLARE_EVENT_TABLE_ENTRY( wxEVT_UPDATE_UI, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxUpdateUIEventFunction) & func, (wxObject *) NULL ),
2015 #define EVT_UPDATE_UI_RANGE(id1, id2, func) \
2016 DECLARE_EVENT_TABLE_ENTRY( wxEVT_UPDATE_UI, id1, id2, (wxObjectEventFunction)(wxEventFunction)(wxUpdateUIEventFunction)&func, (wxObject *) NULL ),
2017
2018 // Help events
2019 #define EVT_HELP(id, func) \
2020 DECLARE_EVENT_TABLE_ENTRY( wxEVT_HELP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) (wxHelpEventFunction) & func, (wxObject *) NULL ),
2021
2022 #define EVT_HELP_RANGE(id1, id2, func) \
2023 DECLARE_EVENT_TABLE_ENTRY( wxEVT_HELP, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) (wxHelpEventFunction) & func, (wxObject *) NULL ),
2024
2025 #define EVT_DETAILED_HELP(id, func) \
2026 DECLARE_EVENT_TABLE_ENTRY( wxEVT_DETAILED_HELP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) (wxHelpEventFunction) & func, (wxObject *) NULL ),
2027
2028 #define EVT_DETAILED_HELP_RANGE(id1, id2, func) \
2029 DECLARE_EVENT_TABLE_ENTRY( wxEVT_DETAILED_HELP, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) (wxHelpEventFunction) & func, (wxObject *) NULL ),
2030
2031 // Context Menu Events
2032 #define EVT_CONTEXT_MENU(func) \
2033 DECLARE_EVENT_TABLE_ENTRY(wxEVT_CONTEXT_MENU, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxContextMenuEventFunction) & func, (wxObject *) NULL ),
2034
2035 // ----------------------------------------------------------------------------
2036 // Global data
2037 // ----------------------------------------------------------------------------
2038
2039 // for pending event processing - notice that there is intentionally no
2040 // WXDLLEXPORT here
2041 extern wxList *wxPendingEvents;
2042 #if wxUSE_THREADS
2043 extern wxCriticalSection *wxPendingEventsLocker;
2044 #endif
2045
2046 // ----------------------------------------------------------------------------
2047 // Helper functions
2048 // ----------------------------------------------------------------------------
2049
2050 #if wxUSE_GUI
2051
2052 // Find a window with the focus, that is also a descendant of the given window.
2053 // This is used to determine the window to initially send commands to.
2054 wxWindow* wxFindFocusDescendant(wxWindow* ancestor);
2055
2056 #endif // wxUSE_GUI
2057
2058 #endif
2059 // _WX_EVENTH__