1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: Event classes
4 // Author: Julian Smart
8 // Copyright: (c) wxWindows team
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 // generate a new unique event type
57 // the standard event types
58 extern const int wxEVT_NULL
;
59 extern const int wxEVT_FIRST
;
61 extern const int wxEVT_COMMAND_BUTTON_CLICKED
;
62 extern const int wxEVT_COMMAND_CHECKBOX_CLICKED
;
63 extern const int wxEVT_COMMAND_CHOICE_SELECTED
;
64 extern const int wxEVT_COMMAND_LISTBOX_SELECTED
;
65 extern const int wxEVT_COMMAND_LISTBOX_DOUBLECLICKED
;
66 extern const int wxEVT_COMMAND_CHECKLISTBOX_TOGGLED
;
67 extern const int wxEVT_COMMAND_TEXT_UPDATED
;
68 extern const int wxEVT_COMMAND_TEXT_ENTER
;
69 extern const int wxEVT_COMMAND_MENU_SELECTED
;
70 extern const int wxEVT_COMMAND_TOOL_CLICKED
;
71 extern const int wxEVT_COMMAND_SLIDER_UPDATED
;
72 extern const int wxEVT_COMMAND_RADIOBOX_SELECTED
;
73 extern const int wxEVT_COMMAND_RADIOBUTTON_SELECTED
;
74 extern const int wxEVT_COMMAND_SCROLLBAR_UPDATED
;
75 extern const int wxEVT_COMMAND_VLBOX_SELECTED
;
76 extern const int wxEVT_COMMAND_COMBOBOX_SELECTED
;
77 extern const int wxEVT_COMMAND_TOOL_RCLICKED
;
78 extern const int wxEVT_COMMAND_TOOL_ENTER
;
79 extern const int wxEVT_COMMAND_SPINCTRL_UPDATED
;
81 // Sockets and timers send events, too
82 extern const int wxEVT_SOCKET
;
83 extern const int wxEVT_TIMER
;
86 extern const int wxEVT_LEFT_DOWN
;
87 extern const int wxEVT_LEFT_UP
;
88 extern const int wxEVT_MIDDLE_DOWN
;
89 extern const int wxEVT_MIDDLE_UP
;
90 extern const int wxEVT_RIGHT_DOWN
;
91 extern const int wxEVT_RIGHT_UP
;
92 extern const int wxEVT_MOTION
;
93 extern const int wxEVT_ENTER_WINDOW
;
94 extern const int wxEVT_LEAVE_WINDOW
;
95 extern const int wxEVT_LEFT_DCLICK
;
96 extern const int wxEVT_MIDDLE_DCLICK
;
97 extern const int wxEVT_RIGHT_DCLICK
;
98 extern const int wxEVT_SET_FOCUS
;
99 extern const int wxEVT_KILL_FOCUS
;
101 // Non-client mouse events
102 extern const int wxEVT_NC_LEFT_DOWN
;
103 extern const int wxEVT_NC_LEFT_UP
;
104 extern const int wxEVT_NC_MIDDLE_DOWN
;
105 extern const int wxEVT_NC_MIDDLE_UP
;
106 extern const int wxEVT_NC_RIGHT_DOWN
;
107 extern const int wxEVT_NC_RIGHT_UP
;
108 extern const int wxEVT_NC_MOTION
;
109 extern const int wxEVT_NC_ENTER_WINDOW
;
110 extern const int wxEVT_NC_LEAVE_WINDOW
;
111 extern const int wxEVT_NC_LEFT_DCLICK
;
112 extern const int wxEVT_NC_MIDDLE_DCLICK
;
113 extern const int wxEVT_NC_RIGHT_DCLICK
;
115 // Character input event type
116 extern const int wxEVT_CHAR
;
117 extern const int wxEVT_CHAR_HOOK
;
118 extern const int wxEVT_NAVIGATION_KEY
;
119 extern const int wxEVT_KEY_DOWN
;
120 extern const int wxEVT_KEY_UP
;
123 extern const int wxEVT_SET_CURSOR
;
125 // wxScrollbar and wxSlider event identifiers
126 extern const int wxEVT_SCROLL_TOP
;
127 extern const int wxEVT_SCROLL_BOTTOM
;
128 extern const int wxEVT_SCROLL_LINEUP
;
129 extern const int wxEVT_SCROLL_LINEDOWN
;
130 extern const int wxEVT_SCROLL_PAGEUP
;
131 extern const int wxEVT_SCROLL_PAGEDOWN
;
132 extern const int wxEVT_SCROLL_THUMBTRACK
;
133 extern const int wxEVT_SCROLL_THUMBRELEASE
;
135 // Scroll events from wxWindow
136 extern const int wxEVT_SCROLLWIN_TOP
;
137 extern const int wxEVT_SCROLLWIN_BOTTOM
;
138 extern const int wxEVT_SCROLLWIN_LINEUP
;
139 extern const int wxEVT_SCROLLWIN_LINEDOWN
;
140 extern const int wxEVT_SCROLLWIN_PAGEUP
;
141 extern const int wxEVT_SCROLLWIN_PAGEDOWN
;
142 extern const int wxEVT_SCROLLWIN_THUMBTRACK
;
143 extern const int wxEVT_SCROLLWIN_THUMBRELEASE
;
146 extern const int wxEVT_SIZE
;
147 extern const int wxEVT_MOVE
;
148 extern const int wxEVT_CLOSE_WINDOW
;
149 extern const int wxEVT_END_SESSION
;
150 extern const int wxEVT_QUERY_END_SESSION
;
151 extern const int wxEVT_ACTIVATE_APP
;
152 extern const int wxEVT_POWER
;
153 extern const int wxEVT_ACTIVATE
;
154 extern const int wxEVT_CREATE
;
155 extern const int wxEVT_DESTROY
;
156 extern const int wxEVT_SHOW
;
157 extern const int wxEVT_ICONIZE
;
158 extern const int wxEVT_MAXIMIZE
;
159 extern const int wxEVT_MOUSE_CAPTURE_CHANGED
;
160 extern const int wxEVT_PAINT
;
161 extern const int wxEVT_ERASE_BACKGROUND
;
162 extern const int wxEVT_NC_PAINT
;
163 extern const int wxEVT_PAINT_ICON
;
164 extern const int wxEVT_MENU_CHAR
;
165 extern const int wxEVT_MENU_INIT
;
166 extern const int wxEVT_MENU_HIGHLIGHT
;
167 extern const int wxEVT_POPUP_MENU_INIT
;
168 extern const int wxEVT_CONTEXT_MENU
;
169 extern const int wxEVT_SYS_COLOUR_CHANGED
;
170 extern const int wxEVT_SETTING_CHANGED
;
171 extern const int wxEVT_QUERY_NEW_PALETTE
;
172 extern const int wxEVT_PALETTE_CHANGED
;
173 extern const int wxEVT_JOY_BUTTON_DOWN
;
174 extern const int wxEVT_JOY_BUTTON_UP
;
175 extern const int wxEVT_JOY_MOVE
;
176 extern const int wxEVT_JOY_ZMOVE
;
177 extern const int wxEVT_DROP_FILES
;
178 extern const int wxEVT_DRAW_ITEM
;
179 extern const int wxEVT_MEASURE_ITEM
;
180 extern const int wxEVT_COMPARE_ITEM
;
181 extern const int wxEVT_INIT_DIALOG
;
182 extern const int wxEVT_IDLE
;
183 extern const int wxEVT_UPDATE_UI
;
186 extern const int wxEVT_END_PROCESS
;
189 extern const int wxEVT_DIALUP_CONNECTED
;
190 extern const int wxEVT_DIALUP_DISCONNECTED
;
192 // Generic command events
193 // Note: a click is a higher-level event than button down/up
194 extern const int wxEVT_COMMAND_LEFT_CLICK
;
195 extern const int wxEVT_COMMAND_LEFT_DCLICK
;
196 extern const int wxEVT_COMMAND_RIGHT_CLICK
;
197 extern const int wxEVT_COMMAND_RIGHT_DCLICK
;
198 extern const int wxEVT_COMMAND_SET_FOCUS
;
199 extern const int wxEVT_COMMAND_KILL_FOCUS
;
200 extern const int wxEVT_COMMAND_ENTER
;
202 // Tree control event types
203 extern const int wxEVT_COMMAND_TREE_BEGIN_DRAG
;
204 extern const int wxEVT_COMMAND_TREE_BEGIN_RDRAG
;
205 extern const int wxEVT_COMMAND_TREE_BEGIN_LABEL_EDIT
;
206 extern const int wxEVT_COMMAND_TREE_END_LABEL_EDIT
;
207 extern const int wxEVT_COMMAND_TREE_DELETE_ITEM
;
208 extern const int wxEVT_COMMAND_TREE_GET_INFO
;
209 extern const int wxEVT_COMMAND_TREE_SET_INFO
;
210 extern const int wxEVT_COMMAND_TREE_ITEM_EXPANDED
;
211 extern const int wxEVT_COMMAND_TREE_ITEM_EXPANDING
;
212 extern const int wxEVT_COMMAND_TREE_ITEM_COLLAPSED
;
213 extern const int wxEVT_COMMAND_TREE_ITEM_COLLAPSING
;
214 extern const int wxEVT_COMMAND_TREE_SEL_CHANGED
;
215 extern const int wxEVT_COMMAND_TREE_SEL_CHANGING
;
216 extern const int wxEVT_COMMAND_TREE_KEY_DOWN
;
217 extern const int wxEVT_COMMAND_TREE_ITEM_ACTIVATED
;
218 extern const int wxEVT_COMMAND_TREE_ITEM_RIGHT_CLICK
;
219 extern const int wxEVT_COMMAND_TREE_ITEM_MIDDLE_CLICK
;
220 extern const int wxEVT_COMMAND_TREE_END_DRAG
;
222 // List control event types
223 extern const int wxEVT_COMMAND_LIST_BEGIN_DRAG
;
224 extern const int wxEVT_COMMAND_LIST_BEGIN_RDRAG
;
225 extern const int wxEVT_COMMAND_LIST_BEGIN_LABEL_EDIT
;
226 extern const int wxEVT_COMMAND_LIST_END_LABEL_EDIT
;
227 extern const int wxEVT_COMMAND_LIST_DELETE_ITEM
;
228 extern const int wxEVT_COMMAND_LIST_DELETE_ALL_ITEMS
;
229 extern const int wxEVT_COMMAND_LIST_GET_INFO
;
230 extern const int wxEVT_COMMAND_LIST_SET_INFO
;
231 extern const int wxEVT_COMMAND_LIST_ITEM_SELECTED
;
232 extern const int wxEVT_COMMAND_LIST_ITEM_DESELECTED
;
233 extern const int wxEVT_COMMAND_LIST_KEY_DOWN
;
234 extern const int wxEVT_COMMAND_LIST_INSERT_ITEM
;
235 extern const int wxEVT_COMMAND_LIST_COL_CLICK
;
236 extern const int wxEVT_COMMAND_LIST_ITEM_RIGHT_CLICK
;
237 extern const int wxEVT_COMMAND_LIST_ITEM_MIDDLE_CLICK
;
238 extern const int wxEVT_COMMAND_LIST_ITEM_ACTIVATED
;
240 // Tab and notebook control event types
241 extern const int wxEVT_COMMAND_TAB_SEL_CHANGED
;
242 extern const int wxEVT_COMMAND_TAB_SEL_CHANGING
;
243 extern const int wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGED
;
244 extern const int wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGING
;
247 extern const int wxEVT_COMMAND_SPLITTER_SASH_POS_CHANGED
;
248 extern const int wxEVT_COMMAND_SPLITTER_SASH_POS_CHANGING
;
249 extern const int wxEVT_COMMAND_SPLITTER_DOUBLECLICKED
;
250 extern const int wxEVT_COMMAND_SPLITTER_UNSPLIT
;
253 extern const int wxEVT_WIZARD_PAGE_CHANGED
;
254 extern const int wxEVT_WIZARD_PAGE_CHANGING
;
255 extern const int wxEVT_WIZARD_CANCEL
;
258 extern const int wxEVT_CALENDAR_SEL_CHANGED
;
259 extern const int wxEVT_CALENDAR_DAY_CHANGED
;
260 extern const int wxEVT_CALENDAR_MONTH_CHANGED
;
261 extern const int wxEVT_CALENDAR_YEAR_CHANGED
;
262 extern const int wxEVT_CALENDAR_DOUBLECLICKED
;
263 extern const int wxEVT_CALENDAR_WEEKDAY_CLICKED
;
266 extern const int wxEVT_HELP
;
267 extern const int wxEVT_DETAILED_HELP
;
271 #if WXWIN_COMPATIBILITY
273 #define wxEVENT_TYPE_BUTTON_COMMAND wxEVT_COMMAND_BUTTON_CLICKED
274 #define wxEVENT_TYPE_CHECKBOX_COMMAND wxEVT_COMMAND_CHECKBOX_CLICKED
275 #define wxEVENT_TYPE_CHOICE_COMMAND wxEVT_COMMAND_CHOICE_SELECTED
276 #define wxEVENT_TYPE_LISTBOX_COMMAND wxEVT_COMMAND_LISTBOX_SELECTED
277 #define wxEVENT_TYPE_LISTBOX_DCLICK_COMMAND wxEVT_COMMAND_LISTBOX_DOUBLECLICKED
278 #define wxEVENT_TYPE_TEXT_COMMAND wxEVT_COMMAND_TEXT_UPDATED
279 #define wxEVENT_TYPE_MULTITEXT_COMMAND wxEVT_COMMAND_TEXT_UPDATED
280 #define wxEVENT_TYPE_MENU_COMMAND wxEVT_COMMAND_MENU_SELECTED
281 #define wxEVENT_TYPE_SLIDER_COMMAND wxEVT_COMMAND_SLIDER_UPDATED
282 #define wxEVENT_TYPE_RADIOBOX_COMMAND wxEVT_COMMAND_RADIOBOX_SELECTED
283 #define wxEVENT_TYPE_RADIOBUTTON_COMMAND wxEVT_COMMAND_RADIOBUTTON_SELECTED
284 #define wxEVENT_TYPE_TEXT_ENTER_COMMAND wxEVT_COMMAND_TEXT_ENTER
285 #define wxEVENT_TYPE_SET_FOCUS wxEVT_SET_FOCUS
286 #define wxEVENT_TYPE_KILL_FOCUS wxEVT_KILL_FOCUS
287 #define wxEVENT_TYPE_SCROLLBAR_COMMAND wxEVT_COMMAND_SCROLLBAR_UPDATED
288 #define wxEVENT_TYPE_VIRT_LISTBOX_COMMAND wxEVT_COMMAND_VLBOX_SELECTED
289 #define wxEVENT_TYPE_COMBOBOX_COMMAND wxEVT_COMMAND_COMBOBOX_SELECTED
291 #define wxEVENT_TYPE_LEFT_DOWN wxEVT_LEFT_DOWN
292 #define wxEVENT_TYPE_LEFT_UP wxEVT_LEFT_UP
293 #define wxEVENT_TYPE_MIDDLE_DOWN wxEVT_MIDDLE_DOWN
294 #define wxEVENT_TYPE_MIDDLE_UP wxEVT_MIDDLE_UP
295 #define wxEVENT_TYPE_RIGHT_DOWN wxEVT_RIGHT_DOWN
296 #define wxEVENT_TYPE_RIGHT_UP wxEVT_RIGHT_UP
297 #define wxEVENT_TYPE_MOTION wxEVT_MOTION
298 #define wxEVENT_TYPE_ENTER_WINDOW wxEVT_ENTER_WINDOW
299 #define wxEVENT_TYPE_LEAVE_WINDOW wxEVT_LEAVE_WINDOW
300 #define wxEVENT_TYPE_LEFT_DCLICK wxEVT_LEFT_DCLICK
301 #define wxEVENT_TYPE_MIDDLE_DCLICK wxEVT_MIDDLE_DCLICK
302 #define wxEVENT_TYPE_RIGHT_DCLICK wxEVT_RIGHT_DCLICK
303 #define wxEVENT_TYPE_CHAR wxEVT_CHAR
304 #define wxEVENT_TYPE_SCROLL_TOP wxEVT_SCROLL_TOP
305 #define wxEVENT_TYPE_SCROLL_BOTTOM wxEVT_SCROLL_BOTTOM
306 #define wxEVENT_TYPE_SCROLL_LINEUP wxEVT_SCROLL_LINEUP
307 #define wxEVENT_TYPE_SCROLL_LINEDOWN wxEVT_SCROLL_LINEDOWN
308 #define wxEVENT_TYPE_SCROLL_PAGEUP wxEVT_SCROLL_PAGEUP
309 #define wxEVENT_TYPE_SCROLL_PAGEDOWN wxEVT_SCROLL_PAGEDOWN
310 #define wxEVENT_TYPE_SCROLL_THUMBTRACK wxEVT_SCROLL_THUMBTRACK
312 #endif // WXWIN_COMPATIBILITY
315 * wxWindows events, covering all interesting things that might happen
316 * (button clicking, resizing, setting text in widgets, etc.).
318 * For each completely new event type, derive a new event class.
319 * An event CLASS represents a C++ class defining a range of similar event TYPES;
320 * examples are canvas events, panel item command events.
321 * An event TYPE is a unique identifier for a particular system event,
322 * such as a button press or a listbox deselection.
326 class WXDLLEXPORT wxEvent
: public wxObject
328 DECLARE_ABSTRACT_CLASS(wxEvent
)
334 void SetEventType(wxEventType typ
) { m_eventType
= typ
; }
335 wxEventType
GetEventType() const { return m_eventType
; }
336 wxObject
*GetEventObject() const { return m_eventObject
; }
337 void SetEventObject(wxObject
*obj
) { m_eventObject
= obj
; }
338 long GetTimestamp() const { return m_timeStamp
; }
339 void SetTimestamp(long ts
= 0) { m_timeStamp
= ts
; }
340 int GetId() const { return m_id
; }
341 void SetId(int Id
) { m_id
= Id
; }
343 // Can instruct event processor that we wish to ignore this event
344 // (treat as if the event table entry had not been found): this must be done
345 // to allow the event processing by the base classes (calling event.Skip()
346 // is the analog of calling the base class verstion of a virtual function)
347 void Skip(bool skip
= TRUE
) { m_skipped
= skip
; }
348 bool GetSkipped() const { return m_skipped
; };
350 // implementation only: this test is explicitlty anti OO and this functions
351 // exists only for optimization purposes
352 bool IsCommandEvent() const { return m_isCommandEvent
; }
354 void CopyObject(wxObject
& object_dest
) const;
357 wxObject
* m_eventObject
;
358 wxEventType m_eventType
;
361 wxObject
* m_callbackUserData
;
364 // optimization: instead of using costly IsKindOf() we keep a flag telling
365 // whether we're a command event (by far the most common case)
366 bool m_isCommandEvent
;
371 // Item or menu event class
373 wxEVT_COMMAND_BUTTON_CLICKED
374 wxEVT_COMMAND_CHECKBOX_CLICKED
375 wxEVT_COMMAND_CHOICE_SELECTED
376 wxEVT_COMMAND_LISTBOX_SELECTED
377 wxEVT_COMMAND_LISTBOX_DOUBLECLICKED
378 wxEVT_COMMAND_TEXT_UPDATED
379 wxEVT_COMMAND_TEXT_ENTER
380 wxEVT_COMMAND_MENU_SELECTED
381 wxEVT_COMMAND_SLIDER_UPDATED
382 wxEVT_COMMAND_RADIOBOX_SELECTED
383 wxEVT_COMMAND_RADIOBUTTON_SELECTED
384 wxEVT_COMMAND_SCROLLBAR_UPDATED
385 wxEVT_COMMAND_VLBOX_SELECTED
386 wxEVT_COMMAND_COMBOBOX_SELECTED
389 class WXDLLEXPORT wxCommandEvent
: public wxEvent
391 DECLARE_DYNAMIC_CLASS(wxCommandEvent
)
394 wxCommandEvent(wxEventType commandType
= wxEVT_NULL
, int id
= 0);
398 * Accessors dependent on context
402 // Set/Get client data from controls
403 void SetClientData(void* clientData
) { m_clientData
= clientData
; }
404 void *GetClientData() const { return m_clientData
; }
406 // Set/Get client object from controls
407 void SetClientObject(wxClientData
* clientObject
) { m_clientObject
= clientObject
; }
408 void *GetClientObject() const { return m_clientObject
; }
410 // Get listbox selection if single-choice
411 int GetSelection() const { return m_commandInt
; }
413 // Set/Get listbox/choice selection string
414 void SetString(const wxString
& s
) { m_commandString
= s
; }
415 wxString
GetString() const { return m_commandString
; }
417 // Get checkbox value
418 bool IsChecked() const { return m_commandInt
!= 0; }
420 // TRUE if the listbox event was a selection.
421 bool IsSelection() const { return (m_extraLong
!= 0); }
423 void SetExtraLong(long extraLong
) { m_extraLong
= extraLong
; }
424 long GetExtraLong() const { return m_extraLong
; }
426 void SetInt(int i
) { m_commandInt
= i
; }
427 long GetInt() const { return m_commandInt
; }
429 void CopyObject(wxObject
& obj
) const;
431 #ifdef WXWIN_COMPATIBILITY_2
432 bool Checked() const { return IsChecked(); }
433 #endif // WXWIN_COMPATIBILITY_2
436 wxString m_commandString
; // String event argument
438 long m_extraLong
; // Additional information (e.g. select/deselect)
439 void* m_clientData
; // Arbitrary client data
440 wxClientData
* m_clientObject
; // Arbitrary client object
443 // this class adds a possibility to react (from the user) code to a control
444 // notification: allow or veto the operation being reported.
445 class WXDLLEXPORT wxNotifyEvent
: public wxCommandEvent
448 wxNotifyEvent(wxEventType commandType
= wxEVT_NULL
, int id
= 0)
449 : wxCommandEvent(commandType
, id
) { m_bAllow
= TRUE
; }
451 // veto the operation (usually it's allowed by default)
452 void Veto() { m_bAllow
= FALSE
; }
454 // allow the operation if it was disabled by default
455 void Allow() { m_bAllow
= TRUE
; }
457 // for implementation code only: is the operation allowed?
458 bool IsAllowed() const { return m_bAllow
; }
460 // probably useless: CopyObject() is used for deferred event
461 // handling but wxNotifyEvent must be processed immediately
462 void CopyObject(wxObject
& obj
) const;
467 DECLARE_DYNAMIC_CLASS(wxNotifyEvent
)
470 // Scroll event class, derived form wxCommandEvent. wxScrollEvents are
471 // sent by wxSlider and wxScrollbar.
476 wxEVT_SCROLL_LINEDOWN
478 wxEVT_SCROLL_PAGEDOWN
479 wxEVT_SCROLL_THUMBTRACK
480 wxEVT_SCROLL_THUMBRELEASE
483 class WXDLLEXPORT wxScrollEvent
: public wxCommandEvent
485 DECLARE_DYNAMIC_CLASS(wxScrollEvent
)
488 wxScrollEvent(wxEventType commandType
= wxEVT_NULL
,
489 int id
= 0, int pos
= 0, int orient
= 0);
497 int GetOrientation() const { return (int) m_extraLong
; }
498 int GetPosition() const { return m_commandInt
; }
499 void SetOrientation(int orient
) { m_extraLong
= (long) orient
; }
500 void SetPosition(int pos
) { m_commandInt
= pos
; }
503 // ScrollWin event class, derived fom wxEvent. wxScrollWinEvents
504 // are sent by wxWindow.
507 wxEVT_SCROLLWIN_BOTTOM
508 wxEVT_SCROLLWIN_LINEUP
509 wxEVT_SCROLLWIN_LINEDOWN
510 wxEVT_SCROLLWIN_PAGEUP
511 wxEVT_SCROLLWIN_PAGEDOWN
512 wxEVT_SCROLLWIN_THUMBTRACK
513 wxEVT_SCROLLWIN_THUMBRELEASE
516 class WXDLLEXPORT wxScrollWinEvent
: public wxEvent
518 DECLARE_DYNAMIC_CLASS(wxScrollWinEvent
)
521 wxScrollWinEvent(wxEventType commandType
= wxEVT_NULL
,
522 int pos
= 0, int orient
= 0);
523 ~wxScrollWinEvent() {}
529 int GetOrientation() const { return (int) m_extraLong
; }
530 int GetPosition() const { return m_commandInt
; }
531 void SetOrientation(int orient
) { m_extraLong
= (long) orient
; }
532 void SetPosition(int pos
) { m_commandInt
= pos
; }
534 void CopyObject(wxObject
& object_dest
) const;
536 int m_commandInt
; // Additional information
557 wxEVT_NC_MIDDLE_DOWN,
562 wxEVT_NC_ENTER_WINDOW,
563 wxEVT_NC_LEAVE_WINDOW,
564 wxEVT_NC_LEFT_DCLICK,
565 wxEVT_NC_MIDDLE_DCLICK,
566 wxEVT_NC_RIGHT_DCLICK,
569 class WXDLLEXPORT wxMouseEvent
: public wxEvent
571 DECLARE_DYNAMIC_CLASS(wxMouseEvent
)
574 wxMouseEvent(wxEventType mouseType
= wxEVT_NULL
);
576 // Was it a button event? (*doesn't* mean: is any button *down*?)
577 bool IsButton() const { return Button(-1); }
579 // Was it a down event from button 1, 2 or 3 or any?
580 bool ButtonDown(int but
= -1) const;
582 // Was it a dclick event from button 1, 2 or 3 or any?
583 bool ButtonDClick(int but
= -1) const;
585 // Was it a up event from button 1, 2 or 3 or any?
586 bool ButtonUp(int but
= -1) const;
588 // Was the given button 1,2,3 or any changing state?
589 bool Button(int but
) const;
591 // Was the given button 1,2,3 or any in Down state?
592 bool ButtonIsDown(int but
) const;
594 // Find state of shift/control keys
595 bool ControlDown() const { return m_controlDown
; }
596 bool MetaDown() const { return m_metaDown
; }
597 bool AltDown() const { return m_altDown
; }
598 bool ShiftDown() const { return m_shiftDown
; }
600 // Find which event was just generated
601 bool LeftDown() const { return (m_eventType
== wxEVT_LEFT_DOWN
); }
602 bool MiddleDown() const { return (m_eventType
== wxEVT_MIDDLE_DOWN
); }
603 bool RightDown() const { return (m_eventType
== wxEVT_RIGHT_DOWN
); }
605 bool LeftUp() const { return (m_eventType
== wxEVT_LEFT_UP
); }
606 bool MiddleUp() const { return (m_eventType
== wxEVT_MIDDLE_UP
); }
607 bool RightUp() const { return (m_eventType
== wxEVT_RIGHT_UP
); }
609 bool LeftDClick() const { return (m_eventType
== wxEVT_LEFT_DCLICK
); }
610 bool MiddleDClick() const { return (m_eventType
== wxEVT_MIDDLE_DCLICK
); }
611 bool RightDClick() const { return (m_eventType
== wxEVT_RIGHT_DCLICK
); }
613 // Find the current state of the mouse buttons (regardless
614 // of current event type)
615 bool LeftIsDown() const { return m_leftDown
; }
616 bool MiddleIsDown() const { return m_middleDown
; }
617 bool RightIsDown() const { return m_rightDown
; }
619 // True if a button is down and the mouse is moving
620 bool Dragging() const
622 return ((m_eventType
== wxEVT_MOTION
) &&
623 (LeftIsDown() || MiddleIsDown() || RightIsDown()));
626 // True if the mouse is moving, and no button is down
627 bool Moving() const { return (m_eventType
== wxEVT_MOTION
); }
629 // True if the mouse is just entering the window
630 bool Entering() const { return (m_eventType
== wxEVT_ENTER_WINDOW
); }
632 // True if the mouse is just leaving the window
633 bool Leaving() const { return (m_eventType
== wxEVT_LEAVE_WINDOW
); }
635 // Find the position of the event
636 void GetPosition(wxCoord
*xpos
, wxCoord
*ypos
) const
645 void GetPosition(long *xpos
, long *ypos
) const
654 // Find the position of the event
655 wxPoint
GetPosition() const { return wxPoint(m_x
, m_y
); }
657 // Find the logical position of the event given the DC
658 wxPoint
GetLogicalPosition(const wxDC
& dc
) const ;
661 #if WXWIN_COMPATIBILITY
662 void Position(long *xpos
, long *ypos
) const
670 void Position(float *xpos
, float *ypos
) const
672 *xpos
= (float) m_x
; *ypos
= (float) m_y
;
674 #endif // WXWIN_COMPATIBILITY
677 wxCoord
GetX() const { return m_x
; }
680 wxCoord
GetY() const { return m_y
; }
682 void CopyObject(wxObject
& obj
) const;
703 class WXDLLEXPORT wxSetCursorEvent
: public wxEvent
706 wxSetCursorEvent(wxCoord x
, wxCoord y
)
708 m_eventType
= wxEVT_SET_CURSOR
;
714 wxCoord
GetX() const { return m_x
; }
715 wxCoord
GetY() const { return m_y
; }
717 void SetCursor(const wxCursor
& cursor
) { m_cursor
= cursor
; }
718 const wxCursor
& GetCursor() const { return m_cursor
; }
719 bool HasCursor() const { return m_cursor
.Ok(); }
726 // Keyboard input event class
735 class WXDLLEXPORT wxKeyEvent
: public wxEvent
737 DECLARE_DYNAMIC_CLASS(wxKeyEvent
)
740 wxKeyEvent(wxEventType keyType
= wxEVT_NULL
);
742 // Find state of shift/control keys
743 bool ControlDown() const { return m_controlDown
; }
744 bool MetaDown() const { return m_metaDown
; }
745 bool AltDown() const { return m_altDown
; }
746 bool ShiftDown() const { return m_shiftDown
; }
748 bool HasModifiers() const { return ControlDown() || AltDown() || MetaDown(); }
750 // get the key code: an ASCII7 char or an element of wxKeyCode enum
751 int GetKeyCode() const { return (int)m_keyCode
; }
753 // Find the position of the event
754 void GetPosition(wxCoord
*xpos
, wxCoord
*ypos
) const
756 if (xpos
) *xpos
= m_x
;
757 if (ypos
) *ypos
= m_y
;
761 void GetPosition(long *xpos
, long *ypos
) const
763 if (xpos
) *xpos
= (long)m_x
;
764 if (ypos
) *ypos
= (long)m_y
;
768 wxPoint
GetPosition() const
769 { return wxPoint(m_x
, m_y
); }
772 wxCoord
GetX() const { return m_x
; }
775 wxCoord
GetY() const { return m_y
; }
777 void CopyObject(wxObject
& obj
) const;
780 long KeyCode() const { return m_keyCode
; }
799 class WXDLLEXPORT wxSizeEvent
: public wxEvent
801 DECLARE_DYNAMIC_CLASS(wxSizeEvent
)
806 wxSizeEvent() { m_eventType
= wxEVT_SIZE
; }
807 wxSizeEvent(const wxSize
& sz
, int id
= 0)
809 { m_eventType
= wxEVT_SIZE
; m_id
= id
; }
811 wxSize
GetSize() const { return m_size
; }
813 void CopyObject(wxObject
& obj
) const;
822 class WXDLLEXPORT wxMoveEvent
: public wxEvent
824 DECLARE_DYNAMIC_CLASS(wxMoveEvent
)
829 wxMoveEvent() { m_eventType
= wxEVT_MOVE
; }
830 wxMoveEvent(const wxPoint
& pos
, int id
= 0)
832 { m_eventType
= wxEVT_MOVE
; m_id
= id
; }
834 wxPoint
GetPosition() const { return m_pos
; }
836 void CopyObject(wxObject
& obj
) const;
846 #if defined(__WXDEBUG__) && (defined(__WXMSW__) || defined(__WXPM__))
847 // see comments in src/msw|os2/dcclient.cpp where g_isPainting is defined
848 extern WXDLLEXPORT
int g_isPainting
;
851 class WXDLLEXPORT wxPaintEvent
: public wxEvent
853 DECLARE_DYNAMIC_CLASS(wxPaintEvent
)
856 wxPaintEvent(int Id
= 0)
858 m_eventType
= wxEVT_PAINT
;
861 #if defined(__WXDEBUG__) && (defined(__WXMSW__) || defined(__WXPM__))
862 // set the internal flag for the duration of processing of WM_PAINT
867 #if defined(__WXDEBUG__) && (defined(__WXMSW__) || defined(__WXPM__))
875 // Erase background event class
877 wxEVT_ERASE_BACKGROUND
880 class WXDLLEXPORT wxEraseEvent
: public wxEvent
882 DECLARE_DYNAMIC_CLASS(wxEraseEvent
)
887 wxEraseEvent(int Id
= 0, wxDC
*dc
= (wxDC
*) NULL
)
888 { m_eventType
= wxEVT_ERASE_BACKGROUND
; m_id
= Id
; m_dc
= dc
; }
889 wxDC
*GetDC() const { return m_dc
; }
891 void CopyObject(wxObject
& obj
) const;
900 class WXDLLEXPORT wxFocusEvent
: public wxEvent
902 DECLARE_DYNAMIC_CLASS(wxFocusEvent
)
905 wxFocusEvent(wxEventType type
= wxEVT_NULL
, int Id
= 0)
906 { m_eventType
= type
; m_id
= Id
; }
909 // Activate event class
915 class WXDLLEXPORT wxActivateEvent
: public wxEvent
917 DECLARE_DYNAMIC_CLASS(wxActivateEvent
)
920 wxActivateEvent(wxEventType type
= wxEVT_NULL
, bool active
= TRUE
, int Id
= 0)
921 { m_eventType
= type
; m_active
= active
; m_id
= Id
; }
922 bool GetActive() const { return m_active
; }
924 void CopyObject(wxObject
& obj
) const;
930 // InitDialog event class
935 class WXDLLEXPORT wxInitDialogEvent
: public wxEvent
937 DECLARE_DYNAMIC_CLASS(wxInitDialogEvent
)
940 wxInitDialogEvent(int Id
= 0)
941 { m_eventType
= wxEVT_INIT_DIALOG
; m_id
= Id
; }
944 // Miscellaneous menu event class
948 wxEVT_MENU_HIGHLIGHT,
949 wxEVT_POPUP_MENU_INIT,
953 class WXDLLEXPORT wxMenuEvent
: public wxEvent
955 DECLARE_DYNAMIC_CLASS(wxMenuEvent
)
958 wxMenuEvent(wxEventType type
= wxEVT_NULL
, int id
= 0)
959 { m_eventType
= type
; m_menuId
= id
; }
961 int GetMenuId() const { return m_menuId
; }
963 void CopyObject(wxObject
& obj
) const;
968 // Window close or session close event class
972 wxEVT_QUERY_END_SESSION
975 class WXDLLEXPORT wxCloseEvent
: public wxEvent
977 DECLARE_DYNAMIC_CLASS(wxCloseEvent
)
980 wxCloseEvent(wxEventType type
= wxEVT_NULL
, int id
= 0)
984 m_veto
= FALSE
; // should be FALSE by default
986 #if WXWIN_COMPATIBILITY
988 #endif // WXWIN_COMPATIBILITY
992 void SetLoggingOff(bool logOff
) { m_loggingOff
= logOff
; }
993 bool GetLoggingOff() const { return m_loggingOff
; }
995 void Veto(bool veto
= TRUE
)
997 // GetVeto() will return FALSE anyhow...
998 wxCHECK_RET( m_canVeto
,
999 wxT("call to Veto() ignored (can't veto this event)") );
1003 void SetCanVeto(bool canVeto
) { m_canVeto
= canVeto
; }
1004 // No more asserts here please, the one you put here was wrong.
1005 bool CanVeto() const { return m_canVeto
; }
1006 bool GetVeto() const { return m_canVeto
&& m_veto
; }
1008 #if WXWIN_COMPATIBILITY
1009 // This is probably obsolete now, since we use CanVeto instead, in
1010 // both OnCloseWindow and OnQueryEndSession.
1011 // m_force == ! m_canVeto i.e., can't veto means we must force it to close.
1012 void SetForce(bool force
) { m_force
= force
; }
1013 bool GetForce() const { return m_force
; }
1016 void CopyObject(wxObject
& obj
) const;
1020 bool m_veto
, m_canVeto
;
1022 #if WXWIN_COMPATIBILITY
1031 class WXDLLEXPORT wxShowEvent
: public wxEvent
1033 DECLARE_DYNAMIC_CLASS(wxShowEvent
)
1037 wxShowEvent(int id
= 0, bool show
= FALSE
)
1038 { m_eventType
= wxEVT_SHOW
; m_id
= id
; m_show
= show
; }
1040 void SetShow(bool show
) { m_show
= show
; }
1041 bool GetShow() const { return m_show
; }
1043 void CopyObject(wxObject
& obj
) const;
1053 class WXDLLEXPORT wxIconizeEvent
: public wxEvent
1055 DECLARE_DYNAMIC_CLASS(wxIconizeEvent
)
1058 wxIconizeEvent(int id
= 0)
1059 { m_eventType
= wxEVT_ICONIZE
; m_id
= id
; }
1066 class WXDLLEXPORT wxMaximizeEvent
: public wxEvent
1068 DECLARE_DYNAMIC_CLASS(wxMaximizeEvent
)
1071 wxMaximizeEvent(int id
= 0)
1072 { m_eventType
= wxEVT_MAXIMIZE
; m_id
= id
; }
1075 // Joystick event class
1077 wxEVT_JOY_BUTTON_DOWN,
1078 wxEVT_JOY_BUTTON_UP,
1083 // Which joystick? Same as Windows ids so no conversion necessary.
1084 #define wxJOYSTICK1 0
1085 #define wxJOYSTICK2 1
1087 // Which button is down?
1088 #define wxJOY_BUTTON1 1
1089 #define wxJOY_BUTTON2 2
1090 #define wxJOY_BUTTON3 4
1091 #define wxJOY_BUTTON4 8
1092 #define wxJOY_BUTTON_ANY -1
1094 class WXDLLEXPORT wxJoystickEvent
: public wxEvent
1096 DECLARE_DYNAMIC_CLASS(wxJoystickEvent
)
1101 int m_buttonChange
; // Which button changed?
1102 int m_buttonState
; // Which buttons are down?
1103 int m_joyStick
; // Which joystick?
1105 wxJoystickEvent(wxEventType type
= wxEVT_NULL
,
1107 int joystick
= wxJOYSTICK1
,
1111 m_buttonState
= state
;
1112 m_pos
= wxPoint(0,0);
1114 m_joyStick
= joystick
;
1115 m_buttonChange
= change
;
1118 wxPoint
GetPosition() const { return m_pos
; }
1119 int GetZPosition() const { return m_zPosition
; }
1120 int GetButtonState() const { return m_buttonState
; }
1121 int GetButtonChange() const { return m_buttonChange
; }
1122 int GetJoystick() const { return m_joyStick
; }
1124 void SetJoystick(int stick
) { m_joyStick
= stick
; }
1125 void SetButtonState(int state
) { m_buttonState
= state
; }
1126 void SetButtonChange(int change
) { m_buttonChange
= change
; }
1127 void SetPosition(const wxPoint
& pos
) { m_pos
= pos
; }
1128 void SetZPosition(int zPos
) { m_zPosition
= zPos
; }
1130 // Was it a button event? (*doesn't* mean: is any button *down*?)
1131 bool IsButton() const { return ((GetEventType() == wxEVT_JOY_BUTTON_DOWN
) ||
1132 (GetEventType() == wxEVT_JOY_BUTTON_UP
)); }
1134 // Was it a move event?
1135 bool IsMove() const { return (GetEventType() == wxEVT_JOY_MOVE
) ; }
1137 // Was it a zmove event?
1138 bool IsZMove() const { return (GetEventType() == wxEVT_JOY_ZMOVE
) ; }
1140 // Was it a down event from button 1, 2, 3, 4 or any?
1141 bool ButtonDown(int but
= wxJOY_BUTTON_ANY
) const
1142 { return ((GetEventType() == wxEVT_JOY_BUTTON_DOWN
) &&
1143 ((but
== wxJOY_BUTTON_ANY
) || (but
== m_buttonChange
))); }
1145 // Was it a up event from button 1, 2, 3 or any?
1146 bool ButtonUp(int but
= wxJOY_BUTTON_ANY
) const
1147 { return ((GetEventType() == wxEVT_JOY_BUTTON_UP
) &&
1148 ((but
== wxJOY_BUTTON_ANY
) || (but
== m_buttonChange
))); }
1150 // Was the given button 1,2,3,4 or any in Down state?
1151 bool ButtonIsDown(int but
= wxJOY_BUTTON_ANY
) const
1152 { return (((but
== wxJOY_BUTTON_ANY
) && (m_buttonState
!= 0)) ||
1153 ((m_buttonState
& but
) == but
)); }
1155 void CopyObject(wxObject
& obj
) const;
1158 // Drop files event class
1163 class WXDLLEXPORT wxDropFilesEvent
: public wxEvent
1165 DECLARE_DYNAMIC_CLASS(wxDropFilesEvent
)
1170 wxString
* m_files
; // Memory (de)allocated by code calling ProcessEvent
1172 wxDropFilesEvent(wxEventType type
= wxEVT_NULL
,
1174 wxString
*files
= (wxString
*) NULL
)
1175 { m_eventType
= type
; m_noFiles
= noFiles
; m_files
= files
; }
1177 wxPoint
GetPosition() const { return m_pos
; }
1178 int GetNumberOfFiles() const { return m_noFiles
; }
1179 wxString
*GetFiles() const { return m_files
; }
1181 void CopyObject(wxObject
& obj
) const;
1189 class WXDLLEXPORT wxUpdateUIEvent
: public wxCommandEvent
1191 DECLARE_DYNAMIC_CLASS(wxUpdateUIEvent
)
1194 wxUpdateUIEvent(wxWindowID commandId
= 0)
1196 m_eventType
= wxEVT_UPDATE_UI
;
1199 m_setChecked
= FALSE
;
1201 m_setEnabled
= FALSE
;
1206 bool GetChecked() const { return m_checked
; }
1207 bool GetEnabled() const { return m_enabled
; }
1208 wxString
GetText() const { return m_text
; }
1209 bool GetSetText() const { return m_setText
; }
1210 bool GetSetChecked() const { return m_setChecked
; }
1211 bool GetSetEnabled() const { return m_setEnabled
; }
1213 void Check(bool check
) { m_checked
= check
; m_setChecked
= TRUE
; }
1214 void Enable(bool enable
) { m_enabled
= enable
; m_setEnabled
= TRUE
; }
1215 void SetText(const wxString
& text
) { m_text
= text
; m_setText
= TRUE
; }
1217 void CopyObject(wxObject
& obj
) const;
1229 wxEVT_SYS_COLOUR_CHANGED
1232 // TODO: shouldn't all events record the window ID?
1233 class WXDLLEXPORT wxSysColourChangedEvent
: public wxEvent
1235 DECLARE_DYNAMIC_CLASS(wxSysColourChangedEvent
)
1238 wxSysColourChangedEvent()
1239 { m_eventType
= wxEVT_SYS_COLOUR_CHANGED
; }
1243 wxEVT_PALETTE_CHANGED
1246 class WXDLLEXPORT wxPaletteChangedEvent
: public wxEvent
1248 DECLARE_DYNAMIC_CLASS(wxPaletteChangedEvent
)
1251 wxPaletteChangedEvent(wxWindowID id
= 0) : wxEvent(id
)
1253 m_eventType
= wxEVT_PALETTE_CHANGED
;
1254 m_changedWindow
= (wxWindow
*) NULL
;
1257 void SetChangedWindow(wxWindow
* win
) { m_changedWindow
= win
; }
1258 wxWindow
* GetChangedWindow() const { return m_changedWindow
; }
1260 void CopyObject(wxObject
& obj
) const;
1263 wxWindow
* m_changedWindow
;
1267 wxEVT_QUERY_NEW_PALETTE
1268 Indicates the window is getting keyboard focus and should re-do its palette.
1271 class WXDLLEXPORT wxQueryNewPaletteEvent
: public wxEvent
1273 DECLARE_DYNAMIC_CLASS(wxQueryNewPaletteEvent
)
1276 wxQueryNewPaletteEvent(wxWindowID id
= 0): wxEvent(id
)
1277 { m_eventType
= wxEVT_QUERY_NEW_PALETTE
; m_paletteRealized
= FALSE
; }
1279 // App sets this if it changes the palette.
1280 void SetPaletteRealized(bool realized
) { m_paletteRealized
= realized
; }
1281 bool GetPaletteRealized() const { return m_paletteRealized
; }
1283 void CopyObject(wxObject
& obj
) const;
1286 bool m_paletteRealized
;
1290 Event generated by dialog navigation keys
1291 wxEVT_NAVIGATION_KEY
1293 // NB: don't derive from command event to avoid being propagated to the parent
1294 class WXDLLEXPORT wxNavigationKeyEvent
: public wxEvent
1297 wxNavigationKeyEvent()
1299 SetEventType(wxEVT_NAVIGATION_KEY
);
1301 m_flags
= IsForward
| Propagate
; // defaults are for TAB
1302 m_focus
= (wxWindow
*)NULL
;
1305 // direction: forward (true) or backward (false)
1306 bool GetDirection() const
1307 { return (m_flags
& IsForward
) != 0; }
1308 void SetDirection(bool bForward
)
1309 { if ( bForward
) m_flags
|= IsForward
; else m_flags
&= ~IsForward
; }
1311 // it may be a window change event (MDI, notebook pages...) or a control
1313 bool IsWindowChange() const
1314 { return (m_flags
& WinChange
) != 0; }
1315 void SetWindowChange(bool bIs
)
1316 { if ( bIs
) m_flags
|= WinChange
; else m_flags
&= ~WinChange
; }
1318 // some navigation events are meant to be propagated upwards (Windows
1319 // convention is to do this for TAB events) while others should always
1320 // cycle inside the panel/radiobox/whatever we're current inside
1321 bool ShouldPropagate() const
1322 { return (m_flags
& Propagate
) != 0; }
1323 void SetPropagate(bool bDoIt
)
1324 { if ( bDoIt
) m_flags
|= Propagate
; else m_flags
&= ~Propagate
; }
1326 // the child which has the focus currently (may be NULL - use
1327 // wxWindow::FindFocus then)
1328 wxWindow
* GetCurrentFocus() const { return m_focus
; }
1329 void SetCurrentFocus(wxWindow
*win
) { m_focus
= win
; }
1342 DECLARE_DYNAMIC_CLASS(wxNavigationKeyEvent
)
1345 // Window creation/destruction events: the first is sent as soon as window is
1346 // created (i.e. the underlying GUI object exists), but when the C++ object is
1347 // fully initialized (so virtual functions may be called). The second,
1348 // wxEVT_DESTROY, is sent right before the window is destroyed - again, it's
1349 // still safe to call virtual functions at this moment
1355 class WXDLLEXPORT wxWindowCreateEvent
: public wxCommandEvent
1357 DECLARE_DYNAMIC_CLASS(wxWindowCreateEvent
)
1360 wxWindowCreateEvent(wxWindow
*win
= NULL
);
1362 wxWindow
*GetWindow() const { return (wxWindow
*)GetEventObject(); }
1365 class WXDLLEXPORT wxWindowDestroyEvent
: public wxCommandEvent
1367 DECLARE_DYNAMIC_CLASS(wxWindowDestroyEvent
)
1370 wxWindowDestroyEvent(wxWindow
*win
= NULL
);
1372 wxWindow
*GetWindow() const { return (wxWindow
*)GetEventObject(); }
1375 // A help event is sent when the user clicks on a window in context-help mode.
1381 class WXDLLEXPORT wxHelpEvent
: public wxCommandEvent
1384 wxHelpEvent(wxEventType type
= wxEVT_NULL
,
1386 const wxPoint
& pt
= wxDefaultPosition
)
1393 // Position of event (in screen coordinates)
1394 const wxPoint
& GetPosition() const { return m_pos
; }
1395 void SetPosition(const wxPoint
& pos
) { m_pos
= pos
; }
1397 // Optional link to further help
1398 const wxString
& GetLink() const { return m_link
; }
1399 void SetLink(const wxString
& link
) { m_link
= link
; }
1401 // Optional target to display help in. E.g. a window specification
1402 const wxString
& GetTarget() const { return m_target
; }
1403 void SetTarget(const wxString
& target
) { m_target
= target
; }
1411 DECLARE_DYNAMIC_CLASS(wxHelpEvent
)
1421 class WXDLLEXPORT wxIdleEvent
: public wxEvent
1423 DECLARE_DYNAMIC_CLASS(wxIdleEvent
)
1427 { m_eventType
= wxEVT_IDLE
; m_requestMore
= FALSE
; }
1429 void RequestMore(bool needMore
= TRUE
) { m_requestMore
= needMore
; }
1430 bool MoreRequested() const { return m_requestMore
; }
1432 void CopyObject(wxObject
& obj
) const;
1440 wxEVT_MOUSE_CAPTURE_CHANGED,
1441 wxEVT_SETTING_CHANGED, // WM_WININICHANGE (NT) / WM_SETTINGCHANGE (Win95)
1442 // wxEVT_FONT_CHANGED, // WM_FONTCHANGE: roll into wxEVT_SETTING_CHANGED, but remember to propagate
1443 // wxEVT_FONT_CHANGED to all other windows (maybe).
1444 wxEVT_DRAW_ITEM, // Leave these three as virtual functions in wxControl?? Platform-specific.
1449 // ============================================================================
1450 // event handler and related classes
1451 // ============================================================================
1453 typedef void (wxObject::*wxObjectEventFunction
)(wxEvent
&);
1455 struct WXDLLEXPORT wxEventTableEntry
1457 // For some reason, this can't be wxEventType, or VC++ complains.
1458 const int &m_eventType
; // main event type
1459 int m_id
; // control/menu/toolbar id
1460 int m_lastId
; // used for ranges of ids
1461 wxObjectEventFunction m_fn
; // function to call: not wxEventFunction,
1462 // because of dependency problems
1464 wxObject
* m_callbackUserData
;
1467 struct WXDLLEXPORT wxDynamicEventTableEntry
1469 // For some reason, this can't be wxEventType, or VC++ complains.
1470 int m_eventType
; // main event type
1471 int m_id
; // control/menu/toolbar id
1472 int m_lastId
; // used for ranges of ids
1473 wxObjectEventFunction m_fn
; // function to call: not wxEventFunction,
1474 // because of dependency problems
1476 wxObject
* m_callbackUserData
;
1479 struct WXDLLEXPORT wxEventTable
1481 const wxEventTable
*baseTable
; // Points to base event table (next in chain)
1482 const wxEventTableEntry
*entries
; // Points to bottom of entry array
1485 class WXDLLEXPORT wxEvtHandler
: public wxObject
1487 DECLARE_DYNAMIC_CLASS(wxEvtHandler
)
1493 wxEvtHandler
*GetNextHandler() const { return m_nextHandler
; }
1494 wxEvtHandler
*GetPreviousHandler() const { return m_previousHandler
; }
1495 void SetNextHandler(wxEvtHandler
*handler
) { m_nextHandler
= handler
; }
1496 void SetPreviousHandler(wxEvtHandler
*handler
) { m_previousHandler
= handler
; }
1498 void SetEvtHandlerEnabled(bool enabled
) { m_enabled
= enabled
; }
1499 bool GetEvtHandlerEnabled() const { return m_enabled
; }
1501 // process an event right now
1502 virtual bool ProcessEvent(wxEvent
& event
);
1504 // add an event to be processed later
1505 void AddPendingEvent(wxEvent
& event
);
1507 // process all pending events
1508 void ProcessPendingEvents();
1512 bool ProcessThreadEvent(wxEvent
& event
);
1515 // Dynamic association of a member function handler with the event handler,
1516 // id and event type
1517 void Connect( int id
, int lastId
, int eventType
,
1518 wxObjectEventFunction func
,
1519 wxObject
*userData
= (wxObject
*) NULL
);
1521 // Convenience function: take just one id
1522 void Connect( int id
, int eventType
,
1523 wxObjectEventFunction func
,
1524 wxObject
*userData
= (wxObject
*) NULL
)
1525 { Connect(id
, -1, eventType
, func
, userData
); }
1527 bool Disconnect( int id
, int lastId
= -1, wxEventType eventType
= wxEVT_NULL
,
1528 wxObjectEventFunction func
= NULL
,
1529 wxObject
*userData
= (wxObject
*) NULL
);
1531 // Convenience function: take just one id
1532 bool Disconnect( int id
, wxEventType eventType
= wxEVT_NULL
,
1533 wxObjectEventFunction func
= NULL
,
1534 wxObject
*userData
= (wxObject
*) NULL
)
1535 { return Disconnect(id
, -1, eventType
, func
, userData
); }
1537 // implementation from now on
1538 virtual bool SearchEventTable(wxEventTable
& table
, wxEvent
& event
);
1539 bool SearchDynamicEventTable( wxEvent
& event
);
1542 void ClearEventLocker()
1544 # if !defined(__VISAGECPP__)
1545 delete m_eventsLocker
;
1546 m_eventsLocker
= NULL
;
1553 #if WXWIN_COMPATIBILITY_2
1554 virtual void OnCommand(wxWindow
& WXUNUSED(win
),
1555 wxCommandEvent
& WXUNUSED(event
))
1557 wxFAIL_MSG(wxT("shouldn't be called any more"));
1560 // Called if child control has no callback function
1561 virtual long Default()
1562 { return GetNextHandler() ? GetNextHandler()->Default() : 0; };
1563 #endif // WXWIN_COMPATIBILITY_2
1565 #if WXWIN_COMPATIBILITY
1566 virtual bool OnClose();
1570 static const wxEventTableEntry sm_eventTableEntries
[];
1573 static const wxEventTable sm_eventTable
;
1575 virtual const wxEventTable
*GetEventTable() const;
1578 wxEvtHandler
* m_nextHandler
;
1579 wxEvtHandler
* m_previousHandler
;
1580 wxList
* m_dynamicEvents
;
1581 wxList
* m_pendingEvents
;
1583 #if defined (__VISAGECPP__)
1584 wxCriticalSection m_eventsLocker
;
1586 wxCriticalSection
* m_eventsLocker
;
1590 // optimization: instead of using costly IsKindOf() to decide whether we're
1591 // a window (which is true in 99% of cases), use this flag
1594 // Is event handler enabled?
1598 typedef void (wxEvtHandler::*wxEventFunction
)(wxEvent
&);
1600 typedef void (wxEvtHandler::*wxCommandEventFunction
)(wxCommandEvent
&);
1601 typedef void (wxEvtHandler::*wxScrollEventFunction
)(wxScrollEvent
&);
1602 typedef void (wxEvtHandler::*wxScrollWinEventFunction
)(wxScrollWinEvent
&);
1603 typedef void (wxEvtHandler::*wxSizeEventFunction
)(wxSizeEvent
&);
1604 typedef void (wxEvtHandler::*wxMoveEventFunction
)(wxMoveEvent
&);
1605 typedef void (wxEvtHandler::*wxPaintEventFunction
)(wxPaintEvent
&);
1606 typedef void (wxEvtHandler::*wxEraseEventFunction
)(wxEraseEvent
&);
1607 typedef void (wxEvtHandler::*wxMouseEventFunction
)(wxMouseEvent
&);
1608 typedef void (wxEvtHandler::*wxCharEventFunction
)(wxKeyEvent
&);
1609 typedef void (wxEvtHandler::*wxFocusEventFunction
)(wxFocusEvent
&);
1610 typedef void (wxEvtHandler::*wxActivateEventFunction
)(wxActivateEvent
&);
1611 typedef void (wxEvtHandler::*wxMenuEventFunction
)(wxMenuEvent
&);
1612 typedef void (wxEvtHandler::*wxJoystickEventFunction
)(wxJoystickEvent
&);
1613 typedef void (wxEvtHandler::*wxDropFilesEventFunction
)(wxDropFilesEvent
&);
1614 typedef void (wxEvtHandler::*wxInitDialogEventFunction
)(wxInitDialogEvent
&);
1615 typedef void (wxEvtHandler::*wxSysColourChangedFunction
)(wxSysColourChangedEvent
&);
1616 typedef void (wxEvtHandler::*wxUpdateUIEventFunction
)(wxUpdateUIEvent
&);
1617 typedef void (wxEvtHandler::*wxIdleEventFunction
)(wxIdleEvent
&);
1618 typedef void (wxEvtHandler::*wxCloseEventFunction
)(wxCloseEvent
&);
1619 typedef void (wxEvtHandler::*wxShowEventFunction
)(wxShowEvent
&);
1620 typedef void (wxEvtHandler::*wxIconizeEventFunction
)(wxShowEvent
&);
1621 typedef void (wxEvtHandler::*wxMaximizeEventFunction
)(wxShowEvent
&);
1622 typedef void (wxEvtHandler::*wxNavigationKeyEventFunction
)(wxNavigationKeyEvent
&);
1623 typedef void (wxEvtHandler::*wxPaletteChangedEventFunction
)(wxPaletteChangedEvent
&);
1624 typedef void (wxEvtHandler::*wxQueryNewPaletteEventFunction
)(wxQueryNewPaletteEvent
&);
1625 typedef void (wxEvtHandler::*wxWindowCreateEventFunction
)(wxWindowCreateEvent
&);
1626 typedef void (wxEvtHandler::*wxWindowDestroyEventFunction
)(wxWindowDestroyEvent
&);
1627 typedef void (wxEvtHandler::*wxSetCursorEventFunction
)(wxSetCursorEvent
&);
1628 typedef void (wxEvtHandler::*wxNotifyEventFunction
)(wxNotifyEvent
&);
1629 typedef void (wxEvtHandler::*wxHelpEventFunction
)(wxHelpEvent
&);
1632 // N.B. In GNU-WIN32, you *have* to take the address of a member function
1633 // (use &) or the compiler crashes...
1635 #define DECLARE_EVENT_TABLE() \
1637 static const wxEventTableEntry sm_eventTableEntries[];\
1639 static const wxEventTable sm_eventTable;\
1640 virtual const wxEventTable* GetEventTable() const;
1642 #define BEGIN_EVENT_TABLE(theClass, baseClass) \
1643 const wxEventTable *theClass::GetEventTable() const { return &theClass::sm_eventTable; }\
1644 const wxEventTable theClass::sm_eventTable =\
1645 { &baseClass::sm_eventTable, &theClass::sm_eventTableEntries[0] };\
1646 const wxEventTableEntry theClass::sm_eventTableEntries[] = { \
1648 #define END_EVENT_TABLE() \
1649 { 0, 0, 0, 0, 0 } };
1652 * Event table macros
1656 #define EVT_CUSTOM(event, id, func) { event, id, -1, (wxObjectEventFunction) (wxEventFunction) & func, (wxObject *) NULL },
1657 #define EVT_CUSTOM_RANGE(event, id1, id2, func) { event, id1, id2, (wxObjectEventFunction) (wxEventFunction) & func, (wxObject *) NULL },
1660 #define EVT_SIZE(func) { wxEVT_SIZE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxSizeEventFunction) & func, (wxObject *) NULL },
1661 #define EVT_MOVE(func) { wxEVT_MOVE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMoveEventFunction) & func, (wxObject *) NULL },
1662 #define EVT_CLOSE(func) { wxEVT_CLOSE_WINDOW, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCloseEventFunction) & func, (wxObject *) NULL },
1663 #define EVT_END_SESSION(func) { wxEVT_END_SESSION, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCloseEventFunction) & func, (wxObject *) NULL },
1664 #define EVT_QUERY_END_SESSION(func) { wxEVT_QUERY_END_SESSION, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCloseEventFunction) & func, (wxObject *) NULL },
1665 #define EVT_PAINT(func) { wxEVT_PAINT, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxPaintEventFunction) & func, (wxObject *) NULL },
1666 #define EVT_ERASE_BACKGROUND(func) { wxEVT_ERASE_BACKGROUND, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxEraseEventFunction) & func, (wxObject *) NULL },
1667 #define EVT_CHAR(func) { wxEVT_CHAR, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCharEventFunction) & func, (wxObject *) NULL },
1668 #define EVT_KEY_DOWN(func) { wxEVT_KEY_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCharEventFunction) & func, (wxObject *) NULL },
1669 #define EVT_KEY_UP(func) { wxEVT_KEY_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCharEventFunction) & func, (wxObject *) NULL },
1670 #define EVT_CHAR_HOOK(func) { wxEVT_CHAR_HOOK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCharEventFunction) & func, NULL },
1671 #define EVT_MENU_HIGHLIGHT(id, func) { wxEVT_MENU_HIGHLIGHT, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxMenuEventFunction) & func, (wxObject *) NULL },
1672 #define EVT_MENU_HIGHLIGHT_ALL(func) { wxEVT_MENU_HIGHLIGHT, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMenuEventFunction) & func, (wxObject *) NULL },
1673 #define EVT_SET_FOCUS(func) { wxEVT_SET_FOCUS, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxFocusEventFunction) & func, (wxObject *) NULL },
1674 #define EVT_KILL_FOCUS(func) { wxEVT_KILL_FOCUS, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxFocusEventFunction) & func, (wxObject *) NULL },
1675 #define EVT_ACTIVATE(func) { wxEVT_ACTIVATE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxActivateEventFunction) & func, (wxObject *) NULL },
1676 #define EVT_ACTIVATE_APP(func) { wxEVT_ACTIVATE_APP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxActivateEventFunction) & func, (wxObject *) NULL },
1677 #define EVT_END_SESSION(func) { wxEVT_END_SESSION, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCloseEventFunction) & func, (wxObject *) NULL },
1678 #define EVT_QUERY_END_SESSION(func) { wxEVT_QUERY_END_SESSION, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCloseEventFunction) & func, (wxObject *) NULL },
1679 #define EVT_DROP_FILES(func) { wxEVT_DROP_FILES, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxDropFilesEventFunction) & func, (wxObject *) NULL },
1680 #define EVT_INIT_DIALOG(func) { wxEVT_INIT_DIALOG, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxInitDialogEventFunction) & func, (wxObject *) NULL },
1681 #define EVT_SYS_COLOUR_CHANGED(func) { wxEVT_SYS_COLOUR_CHANGED, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxSysColourChangedFunction) & func, (wxObject *) NULL },
1682 #define EVT_SHOW(func) { wxEVT_SHOW, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxShowEventFunction) & func, (wxObject *) NULL },
1683 #define EVT_MAXIMIZE(func) { wxEVT_MAXIMIZE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMaximizeEventFunction) & func, (wxObject *) NULL },
1684 #define EVT_ICONIZE(func) { wxEVT_ICONIZE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxIconizeEventFunction) & func, (wxObject *) NULL },
1685 #define EVT_NAVIGATION_KEY(func) { wxEVT_NAVIGATION_KEY, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) (wxNavigationKeyEventFunction) & func, (wxObject *) NULL },
1686 #define EVT_PALETTE_CHANGED(func) { wxEVT_PALETTE_CHANGED, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxPaletteChangedEventFunction) & func, (wxObject *) NULL },
1687 #define EVT_QUERY_NEW_PALETTE(func) { wxEVT_QUERY_NEW_PALETTE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxQueryNewPaletteEventFunction) & func, (wxObject *) NULL },
1688 #define EVT_WINDOW_CREATE(func) { wxEVT_CREATE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxWindowCreateEventFunction) & func, (wxObject *) NULL },
1689 #define EVT_WINDOW_DESTROY(func) { wxEVT_DESTROY, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxWindowDestroyEventFunction) & func, (wxObject *) NULL },
1690 #define EVT_SET_CURSOR(func) { wxEVT_SET_CURSOR, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxSetCursorEventFunction) & func, (wxObject *) NULL },
1693 #define EVT_LEFT_DOWN(func) { wxEVT_LEFT_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1694 #define EVT_LEFT_UP(func) { wxEVT_LEFT_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1695 #define EVT_MIDDLE_DOWN(func) { wxEVT_MIDDLE_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1696 #define EVT_MIDDLE_UP(func) { wxEVT_MIDDLE_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1697 #define EVT_RIGHT_DOWN(func) { wxEVT_RIGHT_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1698 #define EVT_RIGHT_UP(func) { wxEVT_RIGHT_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1699 #define EVT_MOTION(func) { wxEVT_MOTION, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1700 #define EVT_LEFT_DCLICK(func) { wxEVT_LEFT_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1701 #define EVT_MIDDLE_DCLICK(func) { wxEVT_MIDDLE_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1702 #define EVT_RIGHT_DCLICK(func) { wxEVT_RIGHT_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1703 #define EVT_LEAVE_WINDOW(func) { wxEVT_LEAVE_WINDOW, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1704 #define EVT_ENTER_WINDOW(func) { wxEVT_ENTER_WINDOW, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1707 #define EVT_MOUSE_EVENTS(func) \
1708 { wxEVT_LEFT_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1709 { wxEVT_LEFT_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1710 { wxEVT_MIDDLE_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1711 { wxEVT_MIDDLE_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1712 { wxEVT_RIGHT_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1713 { wxEVT_RIGHT_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1714 { wxEVT_MOTION, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1715 { wxEVT_LEFT_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1716 { wxEVT_MIDDLE_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1717 { wxEVT_RIGHT_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1718 { wxEVT_ENTER_WINDOW, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },\
1719 { wxEVT_LEAVE_WINDOW, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxMouseEventFunction) & func, (wxObject *) NULL },
1722 #define EVT_COMMAND(id, event, fn) { event, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1723 #define EVT_COMMAND_RANGE(id1, id2, event, fn) { event, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1725 // Scrolling from wxWindow (sent to wxScrolledWindow)
1726 #define EVT_SCROLLWIN(func) \
1727 { wxEVT_SCROLLWIN_TOP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },\
1728 { wxEVT_SCROLLWIN_BOTTOM, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },\
1729 { wxEVT_SCROLLWIN_LINEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },\
1730 { wxEVT_SCROLLWIN_LINEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },\
1731 { wxEVT_SCROLLWIN_PAGEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },\
1732 { wxEVT_SCROLLWIN_PAGEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },\
1733 { wxEVT_SCROLLWIN_THUMBTRACK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },\
1734 { wxEVT_SCROLLWIN_THUMBRELEASE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },
1736 #define EVT_SCROLLWIN_TOP(func) { wxEVT_SCROLLWIN_TOP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },
1737 #define EVT_SCROLLWIN_BOTTOM(func) { wxEVT_SCROLLWIN_BOTTOM, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },
1738 #define EVT_SCROLLWIN_LINEUP(func) { wxEVT_SCROLLWIN_LINEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },
1739 #define EVT_SCROLLWIN_LINEDOWN(func) { wxEVT_SCROLLWIN_LINEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },
1740 #define EVT_SCROLLWIN_PAGEUP(func) { wxEVT_SCROLLWIN_PAGEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },
1741 #define EVT_SCROLLWIN_PAGEDOWN(func) { wxEVT_SCROLLWIN_PAGEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },
1742 #define EVT_SCROLLWIN_THUMBTRACK(func) { wxEVT_SCROLLWIN_THUMBTRACK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },
1743 #define EVT_SCROLLWIN_THUMBRELEASE(func) { wxEVT_SCROLLWIN_THUMBRELEASE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollWinEventFunction) & func, (wxObject *) NULL },
1745 // Scrolling from wxSlider and wxScrollBar
1746 #define EVT_SCROLL(func) \
1747 { wxEVT_SCROLL_TOP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1748 { wxEVT_SCROLL_BOTTOM, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1749 { wxEVT_SCROLL_LINEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1750 { wxEVT_SCROLL_LINEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1751 { wxEVT_SCROLL_PAGEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1752 { wxEVT_SCROLL_PAGEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1753 { wxEVT_SCROLL_THUMBTRACK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1754 { wxEVT_SCROLL_THUMBRELEASE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1756 #define EVT_SCROLL_TOP(func) { wxEVT_SCROLL_TOP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1757 #define EVT_SCROLL_BOTTOM(func) { wxEVT_SCROLL_BOTTOM, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1758 #define EVT_SCROLL_LINEUP(func) { wxEVT_SCROLL_LINEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1759 #define EVT_SCROLL_LINEDOWN(func) { wxEVT_SCROLL_LINEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1760 #define EVT_SCROLL_PAGEUP(func) { wxEVT_SCROLL_PAGEUP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1761 #define EVT_SCROLL_PAGEDOWN(func) { wxEVT_SCROLL_PAGEDOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1762 #define EVT_SCROLL_THUMBTRACK(func) { wxEVT_SCROLL_THUMBTRACK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1763 #define EVT_SCROLL_THUMBRELEASE(func) { wxEVT_SCROLL_THUMBRELEASE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1765 // Scrolling from wxSlider and wxScrollBar, with an id
1766 #define EVT_COMMAND_SCROLL(id, func) \
1767 { wxEVT_SCROLL_TOP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1768 { wxEVT_SCROLL_BOTTOM, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1769 { wxEVT_SCROLL_LINEUP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1770 { wxEVT_SCROLL_LINEDOWN, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1771 { wxEVT_SCROLL_PAGEUP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1772 { wxEVT_SCROLL_PAGEDOWN, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1773 { wxEVT_SCROLL_THUMBTRACK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },\
1774 { wxEVT_SCROLL_THUMBRELEASE, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1776 #define EVT_COMMAND_SCROLL_TOP(id, func) { wxEVT_SCROLL_TOP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1777 #define EVT_COMMAND_SCROLL_BOTTOM(id, func) { wxEVT_SCROLL_BOTTOM, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1778 #define EVT_COMMAND_SCROLL_LINEUP(id, func) { wxEVT_SCROLL_LINEUP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1779 #define EVT_COMMAND_SCROLL_LINEDOWN(id, func) { wxEVT_SCROLL_LINEDOWN, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1780 #define EVT_COMMAND_SCROLL_PAGEUP(id, func) { wxEVT_SCROLL_PAGEUP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1781 #define EVT_COMMAND_SCROLL_PAGEDOWN(id, func) { wxEVT_SCROLL_PAGEDOWN, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1782 #define EVT_COMMAND_SCROLL_THUMBTRACK(id, func) { wxEVT_SCROLL_THUMBTRACK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1783 #define EVT_COMMAND_SCROLL_THUMBRELEASE(id, func) { wxEVT_SCROLL_THUMBRELEASE, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxScrollEventFunction) & func, (wxObject *) NULL },
1785 // Convenience macros for commonly-used commands
1786 #define EVT_BUTTON(id, fn) { wxEVT_COMMAND_BUTTON_CLICKED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1787 #define EVT_CHECKBOX(id, fn) { wxEVT_COMMAND_CHECKBOX_CLICKED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1788 #define EVT_CHOICE(id, fn) { wxEVT_COMMAND_CHOICE_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1789 #define EVT_LISTBOX(id, fn) { wxEVT_COMMAND_LISTBOX_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1790 #define EVT_LISTBOX_DCLICK(id, fn) { wxEVT_COMMAND_LISTBOX_DOUBLECLICKED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1791 #define EVT_TEXT(id, fn) { wxEVT_COMMAND_TEXT_UPDATED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1792 #define EVT_TEXT_ENTER(id, fn) { wxEVT_COMMAND_TEXT_ENTER, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1793 #define EVT_MENU(id, fn) { wxEVT_COMMAND_MENU_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1794 #define EVT_MENU_RANGE(id1, id2, fn) { wxEVT_COMMAND_MENU_SELECTED, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1795 #define EVT_SLIDER(id, fn) { wxEVT_COMMAND_SLIDER_UPDATED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1796 #define EVT_RADIOBOX(id, fn) { wxEVT_COMMAND_RADIOBOX_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1797 #define EVT_RADIOBUTTON(id, fn) { wxEVT_COMMAND_RADIOBUTTON_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1798 // EVT_SCROLLBAR is now obsolete since we use EVT_COMMAND_SCROLL... events
1799 #define EVT_SCROLLBAR(id, fn) { wxEVT_COMMAND_SCROLLBAR_UPDATED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1800 #define EVT_VLBOX(id, fn) { wxEVT_COMMAND_VLBOX_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1801 #define EVT_COMBOBOX(id, fn) { wxEVT_COMMAND_COMBOBOX_SELECTED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1802 #define EVT_TOOL(id, fn) { wxEVT_COMMAND_TOOL_CLICKED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1803 #define EVT_TOOL_RANGE(id1, id2, fn) { wxEVT_COMMAND_TOOL_CLICKED, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1804 #define EVT_TOOL_RCLICKED(id, fn) { wxEVT_COMMAND_TOOL_RCLICKED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1805 #define EVT_TOOL_RCLICKED_RANGE(id1, id2, fn) { wxEVT_COMMAND_TOOL_RCLICKED, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1806 #define EVT_TOOL_ENTER(id, fn) { wxEVT_COMMAND_TOOL_ENTER, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1807 #define EVT_CHECKLISTBOX(id, fn) { wxEVT_COMMAND_CHECKLISTBOX_TOGGLED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1809 // Generic command events
1810 #define EVT_COMMAND_LEFT_CLICK(id, fn) { wxEVT_COMMAND_LEFT_CLICK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1811 #define EVT_COMMAND_LEFT_DCLICK(id, fn) { wxEVT_COMMAND_LEFT_DCLICK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1812 #define EVT_COMMAND_RIGHT_CLICK(id, fn) { wxEVT_COMMAND_RIGHT_CLICK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1813 #define EVT_COMMAND_RIGHT_DCLICK(id, fn) { wxEVT_COMMAND_RIGHT_DCLICK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1814 #define EVT_COMMAND_SET_FOCUS(id, fn) { wxEVT_COMMAND_SET_FOCUS, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1815 #define EVT_COMMAND_KILL_FOCUS(id, fn) { wxEVT_COMMAND_KILL_FOCUS, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1816 #define EVT_COMMAND_ENTER(id, fn) { wxEVT_COMMAND_ENTER, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
1819 #define EVT_JOY_DOWN(func) \
1820 { wxEVT_JOY_BUTTON_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL },
1821 #define EVT_JOY_UP(func) \
1822 { wxEVT_JOY_BUTTON_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL },
1823 #define EVT_JOY_MOVE(func) \
1824 { wxEVT_JOY_MOVE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL },
1825 #define EVT_JOY_ZMOVE(func) \
1826 { wxEVT_JOY_ZMOVE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL },
1828 // All joystick events
1829 #define EVT_JOYSTICK_EVENTS(func) \
1830 { wxEVT_JOY_BUTTON_DOWN, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL },\
1831 { wxEVT_JOY_BUTTON_UP, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL },\
1832 { wxEVT_JOY_MOVE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL },\
1833 { wxEVT_JOY_ZMOVE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxJoystickEventFunction) & func, (wxObject *) NULL },
1836 #define EVT_IDLE(func) \
1837 { wxEVT_IDLE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxIdleEventFunction) & func, (wxObject *) NULL },
1840 #define EVT_UPDATE_UI(id, func) \
1841 { wxEVT_UPDATE_UI, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxUpdateUIEventFunction) & func, (wxObject *) NULL },
1842 #define EVT_UPDATE_UI_RANGE(id1, id2, func) \
1843 { wxEVT_UPDATE_UI, id1, id2, (wxObjectEventFunction)(wxEventFunction)(wxUpdateUIEventFunction)&func, (wxObject *) NULL },
1846 #define EVT_HELP(id, func) \
1847 { wxEVT_HELP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) (wxHelpEventFunction) & func, (wxObject *) NULL },
1849 #define EVT_HELP_RANGE(id1, id2, func) \
1850 { wxEVT_HELP, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) (wxHelpEventFunction) & func, (wxObject *) NULL },
1852 #define EVT_DETAILED_HELP(id, func) \
1853 { wxEVT_DETAILED_HELP, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) (wxHelpEventFunction) & func, (wxObject *) NULL },
1855 #define EVT_DETAILED_HELP_RANGE(id1, id2, func) \
1856 { wxEVT_DETAILED_HELP, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) (wxHelpEventFunction) & func, (wxObject *) NULL },
1858 // ----------------------------------------------------------------------------
1860 // ----------------------------------------------------------------------------
1862 // for pending event processing - notice that there is intentionally no
1864 extern wxList
*wxPendingEvents
;
1866 extern wxCriticalSection
*wxPendingEventsLocker
;
1869 // ----------------------------------------------------------------------------
1871 // ----------------------------------------------------------------------------
1875 // Find a window with the focus, that is also a descendant of the given window.
1876 // This is used to determine the window to initially send commands to.
1877 wxWindow
* wxFindFocusDescendant(wxWindow
* ancestor
);