1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: Event classes
4 // Author: Julian Smart
8 // Copyright: (c) Julian Smart and Markus Holzem
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 // ============================================================================
14 // ============================================================================
16 // ----------------------------------------------------------------------------
18 // ----------------------------------------------------------------------------
21 #pragma implementation "event.h"
24 // For compilers that support precompilation, includes "wx.h".
25 #include "wx/wxprec.h"
37 #include "wx/control.h"
46 #include "wx/validate.h"
49 // ----------------------------------------------------------------------------
51 // ----------------------------------------------------------------------------
53 IMPLEMENT_DYNAMIC_CLASS(wxEvtHandler
, wxObject
)
54 IMPLEMENT_ABSTRACT_CLASS(wxEvent
, wxObject
)
57 IMPLEMENT_DYNAMIC_CLASS(wxIdleEvent
, wxEvent
)
58 IMPLEMENT_DYNAMIC_CLASS(wxCommandEvent
, wxEvent
)
59 IMPLEMENT_DYNAMIC_CLASS(wxNotifyEvent
, wxCommandEvent
)
60 IMPLEMENT_DYNAMIC_CLASS(wxScrollEvent
, wxCommandEvent
)
61 IMPLEMENT_DYNAMIC_CLASS(wxScrollWinEvent
, wxEvent
)
62 IMPLEMENT_DYNAMIC_CLASS(wxMouseEvent
, wxEvent
)
63 IMPLEMENT_DYNAMIC_CLASS(wxKeyEvent
, wxEvent
)
64 IMPLEMENT_DYNAMIC_CLASS(wxSizeEvent
, wxEvent
)
65 IMPLEMENT_DYNAMIC_CLASS(wxPaintEvent
, wxEvent
)
66 IMPLEMENT_DYNAMIC_CLASS(wxNcPaintEvent
, wxEvent
)
67 IMPLEMENT_DYNAMIC_CLASS(wxEraseEvent
, wxEvent
)
68 IMPLEMENT_DYNAMIC_CLASS(wxMoveEvent
, wxEvent
)
69 IMPLEMENT_DYNAMIC_CLASS(wxFocusEvent
, wxEvent
)
70 IMPLEMENT_DYNAMIC_CLASS(wxChildFocusEvent
, wxCommandEvent
)
71 IMPLEMENT_DYNAMIC_CLASS(wxCloseEvent
, wxEvent
)
72 IMPLEMENT_DYNAMIC_CLASS(wxShowEvent
, wxEvent
)
73 IMPLEMENT_DYNAMIC_CLASS(wxMaximizeEvent
, wxEvent
)
74 IMPLEMENT_DYNAMIC_CLASS(wxIconizeEvent
, wxEvent
)
75 IMPLEMENT_DYNAMIC_CLASS(wxMenuEvent
, wxEvent
)
76 IMPLEMENT_DYNAMIC_CLASS(wxJoystickEvent
, wxEvent
)
77 IMPLEMENT_DYNAMIC_CLASS(wxDropFilesEvent
, wxEvent
)
78 IMPLEMENT_DYNAMIC_CLASS(wxActivateEvent
, wxEvent
)
79 IMPLEMENT_DYNAMIC_CLASS(wxInitDialogEvent
, wxEvent
)
80 IMPLEMENT_DYNAMIC_CLASS(wxSetCursorEvent
, wxEvent
)
81 IMPLEMENT_DYNAMIC_CLASS(wxSysColourChangedEvent
, wxEvent
)
82 IMPLEMENT_DYNAMIC_CLASS(wxDisplayChangedEvent
, wxEvent
)
83 IMPLEMENT_DYNAMIC_CLASS(wxUpdateUIEvent
, wxCommandEvent
)
84 IMPLEMENT_DYNAMIC_CLASS(wxNavigationKeyEvent
, wxCommandEvent
)
85 IMPLEMENT_DYNAMIC_CLASS(wxPaletteChangedEvent
, wxEvent
)
86 IMPLEMENT_DYNAMIC_CLASS(wxQueryNewPaletteEvent
, wxEvent
)
87 IMPLEMENT_DYNAMIC_CLASS(wxWindowCreateEvent
, wxEvent
)
88 IMPLEMENT_DYNAMIC_CLASS(wxWindowDestroyEvent
, wxEvent
)
89 IMPLEMENT_DYNAMIC_CLASS(wxHelpEvent
, wxCommandEvent
)
90 IMPLEMENT_DYNAMIC_CLASS(wxContextMenuEvent
, wxCommandEvent
)
91 IMPLEMENT_DYNAMIC_CLASS(wxMouseCaptureChangedEvent
, wxEvent
)
94 const wxEventTable
*wxEvtHandler::GetEventTable() const
95 { return &wxEvtHandler::sm_eventTable
; }
97 const wxEventTable
wxEvtHandler::sm_eventTable
=
98 { (const wxEventTable
*)NULL
, &wxEvtHandler::sm_eventTableEntries
[0] };
100 const wxEventTableEntry
wxEvtHandler::sm_eventTableEntries
[] =
101 { DECLARE_EVENT_TABLE_ENTRY(wxEVT_NULL
, 0, 0, (wxObjectEventFunction
)NULL
, NULL
) };
103 // ----------------------------------------------------------------------------
105 // ----------------------------------------------------------------------------
107 // To put pending event handlers
108 wxList
*wxPendingEvents
= (wxList
*)NULL
;
111 // protects wxPendingEvents list
112 wxCriticalSection
*wxPendingEventsLocker
= (wxCriticalSection
*)NULL
;
115 #if !WXWIN_COMPATIBILITY_EVENT_TYPES
117 // common event types are defined here, other event types are defined by the
118 // components which use them
120 DEFINE_EVENT_TYPE(wxEVT_NULL
)
121 DEFINE_EVENT_TYPE(wxEVT_COMMAND_BUTTON_CLICKED
)
122 DEFINE_EVENT_TYPE(wxEVT_COMMAND_CHECKBOX_CLICKED
)
123 DEFINE_EVENT_TYPE(wxEVT_COMMAND_CHOICE_SELECTED
)
124 DEFINE_EVENT_TYPE(wxEVT_COMMAND_LISTBOX_SELECTED
)
125 DEFINE_EVENT_TYPE(wxEVT_COMMAND_LISTBOX_DOUBLECLICKED
)
126 DEFINE_EVENT_TYPE(wxEVT_COMMAND_CHECKLISTBOX_TOGGLED
)
127 DEFINE_EVENT_TYPE(wxEVT_COMMAND_MENU_SELECTED
)
128 DEFINE_EVENT_TYPE(wxEVT_COMMAND_SLIDER_UPDATED
)
129 DEFINE_EVENT_TYPE(wxEVT_COMMAND_RADIOBOX_SELECTED
)
130 DEFINE_EVENT_TYPE(wxEVT_COMMAND_RADIOBUTTON_SELECTED
)
131 DEFINE_EVENT_TYPE(wxEVT_COMMAND_SCROLLBAR_UPDATED
)
132 DEFINE_EVENT_TYPE(wxEVT_COMMAND_VLBOX_SELECTED
)
133 DEFINE_EVENT_TYPE(wxEVT_COMMAND_COMBOBOX_SELECTED
)
134 DEFINE_EVENT_TYPE(wxEVT_COMMAND_TOOL_RCLICKED
)
135 DEFINE_EVENT_TYPE(wxEVT_COMMAND_TOOL_ENTER
)
136 DEFINE_EVENT_TYPE(wxEVT_COMMAND_SPINCTRL_UPDATED
)
138 // Sockets and timers send events, too
139 DEFINE_EVENT_TYPE(wxEVT_SOCKET
)
140 DEFINE_EVENT_TYPE(wxEVT_TIMER
)
143 DEFINE_EVENT_TYPE(wxEVT_LEFT_DOWN
)
144 DEFINE_EVENT_TYPE(wxEVT_LEFT_UP
)
145 DEFINE_EVENT_TYPE(wxEVT_MIDDLE_DOWN
)
146 DEFINE_EVENT_TYPE(wxEVT_MIDDLE_UP
)
147 DEFINE_EVENT_TYPE(wxEVT_RIGHT_DOWN
)
148 DEFINE_EVENT_TYPE(wxEVT_RIGHT_UP
)
149 DEFINE_EVENT_TYPE(wxEVT_MOTION
)
150 DEFINE_EVENT_TYPE(wxEVT_ENTER_WINDOW
)
151 DEFINE_EVENT_TYPE(wxEVT_LEAVE_WINDOW
)
152 DEFINE_EVENT_TYPE(wxEVT_LEFT_DCLICK
)
153 DEFINE_EVENT_TYPE(wxEVT_MIDDLE_DCLICK
)
154 DEFINE_EVENT_TYPE(wxEVT_RIGHT_DCLICK
)
155 DEFINE_EVENT_TYPE(wxEVT_SET_FOCUS
)
156 DEFINE_EVENT_TYPE(wxEVT_KILL_FOCUS
)
157 DEFINE_EVENT_TYPE(wxEVT_CHILD_FOCUS
)
158 DEFINE_EVENT_TYPE(wxEVT_MOUSEWHEEL
)
160 // Non-client mouse events
161 DEFINE_EVENT_TYPE(wxEVT_NC_LEFT_DOWN
)
162 DEFINE_EVENT_TYPE(wxEVT_NC_LEFT_UP
)
163 DEFINE_EVENT_TYPE(wxEVT_NC_MIDDLE_DOWN
)
164 DEFINE_EVENT_TYPE(wxEVT_NC_MIDDLE_UP
)
165 DEFINE_EVENT_TYPE(wxEVT_NC_RIGHT_DOWN
)
166 DEFINE_EVENT_TYPE(wxEVT_NC_RIGHT_UP
)
167 DEFINE_EVENT_TYPE(wxEVT_NC_MOTION
)
168 DEFINE_EVENT_TYPE(wxEVT_NC_ENTER_WINDOW
)
169 DEFINE_EVENT_TYPE(wxEVT_NC_LEAVE_WINDOW
)
170 DEFINE_EVENT_TYPE(wxEVT_NC_LEFT_DCLICK
)
171 DEFINE_EVENT_TYPE(wxEVT_NC_MIDDLE_DCLICK
)
172 DEFINE_EVENT_TYPE(wxEVT_NC_RIGHT_DCLICK
)
174 // Character input event type
175 DEFINE_EVENT_TYPE(wxEVT_CHAR
)
176 DEFINE_EVENT_TYPE(wxEVT_CHAR_HOOK
)
177 DEFINE_EVENT_TYPE(wxEVT_NAVIGATION_KEY
)
178 DEFINE_EVENT_TYPE(wxEVT_KEY_DOWN
)
179 DEFINE_EVENT_TYPE(wxEVT_KEY_UP
)
182 DEFINE_EVENT_TYPE(wxEVT_SET_CURSOR
)
184 // wxScrollbar and wxSlider event identifiers
185 DEFINE_EVENT_TYPE(wxEVT_SCROLL_TOP
)
186 DEFINE_EVENT_TYPE(wxEVT_SCROLL_BOTTOM
)
187 DEFINE_EVENT_TYPE(wxEVT_SCROLL_LINEUP
)
188 DEFINE_EVENT_TYPE(wxEVT_SCROLL_LINEDOWN
)
189 DEFINE_EVENT_TYPE(wxEVT_SCROLL_PAGEUP
)
190 DEFINE_EVENT_TYPE(wxEVT_SCROLL_PAGEDOWN
)
191 DEFINE_EVENT_TYPE(wxEVT_SCROLL_THUMBTRACK
)
192 DEFINE_EVENT_TYPE(wxEVT_SCROLL_THUMBRELEASE
)
194 // Scroll events from wxWindow
195 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_TOP
)
196 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_BOTTOM
)
197 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_LINEUP
)
198 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_LINEDOWN
)
199 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_PAGEUP
)
200 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_PAGEDOWN
)
201 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_THUMBTRACK
)
202 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_THUMBRELEASE
)
205 DEFINE_EVENT_TYPE(wxEVT_SIZE
)
206 DEFINE_EVENT_TYPE(wxEVT_MOVE
)
207 DEFINE_EVENT_TYPE(wxEVT_CLOSE_WINDOW
)
208 DEFINE_EVENT_TYPE(wxEVT_END_SESSION
)
209 DEFINE_EVENT_TYPE(wxEVT_QUERY_END_SESSION
)
210 DEFINE_EVENT_TYPE(wxEVT_ACTIVATE_APP
)
211 DEFINE_EVENT_TYPE(wxEVT_POWER
)
212 DEFINE_EVENT_TYPE(wxEVT_ACTIVATE
)
213 DEFINE_EVENT_TYPE(wxEVT_CREATE
)
214 DEFINE_EVENT_TYPE(wxEVT_DESTROY
)
215 DEFINE_EVENT_TYPE(wxEVT_SHOW
)
216 DEFINE_EVENT_TYPE(wxEVT_ICONIZE
)
217 DEFINE_EVENT_TYPE(wxEVT_MAXIMIZE
)
218 DEFINE_EVENT_TYPE(wxEVT_MOUSE_CAPTURE_CHANGED
)
219 DEFINE_EVENT_TYPE(wxEVT_PAINT
)
220 DEFINE_EVENT_TYPE(wxEVT_ERASE_BACKGROUND
)
221 DEFINE_EVENT_TYPE(wxEVT_NC_PAINT
)
222 DEFINE_EVENT_TYPE(wxEVT_PAINT_ICON
)
223 DEFINE_EVENT_TYPE(wxEVT_MENU_OPEN
)
224 DEFINE_EVENT_TYPE(wxEVT_MENU_CLOSE
)
225 DEFINE_EVENT_TYPE(wxEVT_MENU_HIGHLIGHT
)
226 DEFINE_EVENT_TYPE(wxEVT_CONTEXT_MENU
)
227 DEFINE_EVENT_TYPE(wxEVT_SYS_COLOUR_CHANGED
)
228 DEFINE_EVENT_TYPE(wxEVT_DISPLAY_CHANGED
)
229 DEFINE_EVENT_TYPE(wxEVT_SETTING_CHANGED
)
230 DEFINE_EVENT_TYPE(wxEVT_QUERY_NEW_PALETTE
)
231 DEFINE_EVENT_TYPE(wxEVT_PALETTE_CHANGED
)
232 DEFINE_EVENT_TYPE(wxEVT_JOY_BUTTON_DOWN
)
233 DEFINE_EVENT_TYPE(wxEVT_JOY_BUTTON_UP
)
234 DEFINE_EVENT_TYPE(wxEVT_JOY_MOVE
)
235 DEFINE_EVENT_TYPE(wxEVT_JOY_ZMOVE
)
236 DEFINE_EVENT_TYPE(wxEVT_DROP_FILES
)
237 DEFINE_EVENT_TYPE(wxEVT_DRAW_ITEM
)
238 DEFINE_EVENT_TYPE(wxEVT_MEASURE_ITEM
)
239 DEFINE_EVENT_TYPE(wxEVT_COMPARE_ITEM
)
240 DEFINE_EVENT_TYPE(wxEVT_INIT_DIALOG
)
241 DEFINE_EVENT_TYPE(wxEVT_IDLE
)
242 DEFINE_EVENT_TYPE(wxEVT_UPDATE_UI
)
244 // Generic command events
245 // Note: a click is a higher-level event than button down/up
246 DEFINE_EVENT_TYPE(wxEVT_COMMAND_LEFT_CLICK
)
247 DEFINE_EVENT_TYPE(wxEVT_COMMAND_LEFT_DCLICK
)
248 DEFINE_EVENT_TYPE(wxEVT_COMMAND_RIGHT_CLICK
)
249 DEFINE_EVENT_TYPE(wxEVT_COMMAND_RIGHT_DCLICK
)
250 DEFINE_EVENT_TYPE(wxEVT_COMMAND_SET_FOCUS
)
251 DEFINE_EVENT_TYPE(wxEVT_COMMAND_KILL_FOCUS
)
252 DEFINE_EVENT_TYPE(wxEVT_COMMAND_ENTER
)
255 DEFINE_EVENT_TYPE(wxEVT_HELP
)
256 DEFINE_EVENT_TYPE(wxEVT_DETAILED_HELP
)
258 #endif // !WXWIN_COMPATIBILITY_EVENT_TYPES
260 // ============================================================================
262 // ============================================================================
264 // ----------------------------------------------------------------------------
265 // event initialization
266 // ----------------------------------------------------------------------------
271 static int s_lastUsedEventType
= wxEVT_FIRST
;
273 #if WXWIN_COMPATIBILITY_2
274 // check that we don't overlap with the user-defined types: if it does
275 // happen, the best solution is probably to update the existing code to
276 // use wxNewEventType() instead of wxEVT_USER_FIRST
278 // due to the uncertainty
279 wxASSERT_MSG( s_lastUsedEventType
< wxEVT_USER_FIRST
- 1,
280 _T("possible event type conflict") );
281 #endif // WXWIN_COMPATIBILITY_2
283 return s_lastUsedEventType
++;
286 // ----------------------------------------------------------------------------
288 // ----------------------------------------------------------------------------
291 * General wxWindows events, covering
292 * all interesting things that might happen (button clicking, resizing,
293 * setting text in widgets, etc.).
295 * For each completely new event type, derive a new event class.
299 wxEvent::wxEvent(int theId
, wxEventType commandType
)
301 m_eventType
= commandType
;
302 m_eventObject
= (wxObject
*) NULL
;
306 m_callbackUserData
= (wxObject
*) NULL
;
307 m_isCommandEvent
= FALSE
;
310 wxEvent::wxEvent(const wxEvent
&src
)
312 , m_eventObject(src
.m_eventObject
)
313 , m_eventType(src
.m_eventType
)
314 , m_timeStamp(src
.m_timeStamp
)
316 , m_callbackUserData(src
.m_callbackUserData
)
317 , m_skipped(src
.m_skipped
)
318 , m_isCommandEvent(src
.m_isCommandEvent
)
329 wxCommandEvent::wxCommandEvent(wxEventType commandType
, int theId
)
330 : wxEvent(theId
, commandType
)
332 m_clientData
= (char *) NULL
;
333 m_clientObject
= (wxClientData
*) NULL
;
336 m_commandString
= wxEmptyString
;
337 m_isCommandEvent
= TRUE
;
344 wxScrollEvent::wxScrollEvent(wxEventType commandType
,
348 : wxCommandEvent(commandType
, id
)
350 m_extraLong
= orient
;
358 wxScrollWinEvent::wxScrollWinEvent(wxEventType commandType
,
362 m_eventType
= commandType
;
363 m_extraLong
= orient
;
372 wxMouseEvent::wxMouseEvent(wxEventType commandType
)
374 m_eventType
= commandType
;
377 m_controlDown
= FALSE
;
381 m_middleDown
= FALSE
;
386 m_linesPerAction
= 0;
389 // True if was a button dclick event (1 = left, 2 = middle, 3 = right)
390 // or any button dclick event (but = -1)
391 bool wxMouseEvent::ButtonDClick(int but
) const
396 return (LeftDClick() || MiddleDClick() || RightDClick());
400 return MiddleDClick();
402 return RightDClick();
404 wxFAIL_MSG(wxT("invalid parameter in wxMouseEvent::ButtonDClick"));
410 // True if was a button down event (1 = left, 2 = middle, 3 = right)
411 // or any button down event (but = -1)
412 bool wxMouseEvent::ButtonDown(int but
) const
417 return (LeftDown() || MiddleDown() || RightDown());
425 wxFAIL_MSG(wxT("invalid parameter in wxMouseEvent::ButtonDown"));
431 // True if was a button up event (1 = left, 2 = middle, 3 = right)
432 // or any button up event (but = -1)
433 bool wxMouseEvent::ButtonUp(int but
) const
438 return (LeftUp() || MiddleUp() || RightUp());
446 wxFAIL_MSG(wxT("invalid parameter in wxMouseEvent::ButtonUp"));
452 // True if the given button is currently changing state
453 bool wxMouseEvent::Button(int but
) const
458 return (ButtonUp(-1) || ButtonDown(-1) || ButtonDClick(-1));
460 return (LeftDown() || LeftUp() || LeftDClick());
462 return (MiddleDown() || MiddleUp() || MiddleDClick());
464 return (RightDown() || RightUp() || RightDClick());
466 wxFAIL_MSG(wxT("invalid parameter in wxMouseEvent::Button"));
472 bool wxMouseEvent::ButtonIsDown(int but
) const
477 return (LeftIsDown() || MiddleIsDown() || RightIsDown());
481 return MiddleIsDown();
483 return RightIsDown();
485 wxFAIL_MSG(wxT("invalid parameter in wxMouseEvent::ButtonIsDown"));
491 int wxMouseEvent::GetButton() const
493 for ( int i
= 1; i
<= 3; i
++ )
504 // Find the logical position of the event given the DC
505 wxPoint
wxMouseEvent::GetLogicalPosition(const wxDC
& dc
) const
507 wxPoint
pt(dc
.DeviceToLogicalX(m_x
), dc
.DeviceToLogicalY(m_y
));
517 wxKeyEvent::wxKeyEvent(wxEventType type
)
521 m_controlDown
= FALSE
;
529 wxWindowCreateEvent::wxWindowCreateEvent(wxWindow
*win
)
531 SetEventType(wxEVT_CREATE
);
535 wxWindowDestroyEvent::wxWindowDestroyEvent(wxWindow
*win
)
537 SetEventType(wxEVT_DESTROY
);
541 wxChildFocusEvent::wxChildFocusEvent(wxWindow
*win
)
542 : wxCommandEvent(wxEVT_CHILD_FOCUS
)
549 // ----------------------------------------------------------------------------
551 // ----------------------------------------------------------------------------
557 wxEvtHandler::wxEvtHandler()
559 m_nextHandler
= (wxEvtHandler
*) NULL
;
560 m_previousHandler
= (wxEvtHandler
*) NULL
;
562 m_dynamicEvents
= (wxList
*) NULL
;
564 m_pendingEvents
= (wxList
*) NULL
;
566 # if !defined(__VISAGECPP__)
567 m_eventsLocker
= new wxCriticalSection
;
570 // no client data (yet)
572 m_clientDataType
= wxClientData_None
;
575 wxEvtHandler::~wxEvtHandler()
577 // Takes itself out of the list of handlers
578 if (m_previousHandler
)
579 m_previousHandler
->m_nextHandler
= m_nextHandler
;
582 m_nextHandler
->m_previousHandler
= m_previousHandler
;
586 wxNode
*node
= m_dynamicEvents
->First();
589 #if WXWIN_COMPATIBILITY_EVENT_TYPES
590 wxEventTableEntry
*entry
= (wxEventTableEntry
*)node
->Data();
591 #else // !WXWIN_COMPATIBILITY_EVENT_TYPES
592 wxDynamicEventTableEntry
*entry
= (wxDynamicEventTableEntry
*)node
->Data();
593 #endif // WXWIN_COMPATIBILITY_EVENT_TYPES/!WXWIN_COMPATIBILITY_EVENT_TYPES
595 if (entry
->m_callbackUserData
)
596 delete entry
->m_callbackUserData
;
600 delete m_dynamicEvents
;
603 delete m_pendingEvents
;
606 # if !defined(__VISAGECPP__)
607 delete m_eventsLocker
;
611 // we only delete object data, not untyped
612 if ( m_clientDataType
== wxClientData_Object
)
613 delete m_clientObject
;
618 bool wxEvtHandler::ProcessThreadEvent(wxEvent
& event
)
620 // check that we are really in a child thread
621 wxASSERT_MSG( !wxThread::IsMain(),
622 wxT("use ProcessEvent() in main thread") );
624 AddPendingEvent(event
);
629 #endif // wxUSE_THREADS
631 void wxEvtHandler::AddPendingEvent(wxEvent
& event
)
633 // 1) Add event to list of pending events of this event handler
635 wxEvent
*eventCopy
= event
.Clone();
637 // we must be able to copy the events here so the event class must
638 // implement Clone() properly instead of just providing a NULL stab for it
639 wxCHECK_RET( eventCopy
,
640 _T("events of this type aren't supposed to be posted") );
642 #if defined(__VISAGECPP__)
643 wxENTER_CRIT_SECT( m_eventsLocker
);
645 wxENTER_CRIT_SECT( *m_eventsLocker
);
648 if ( !m_pendingEvents
)
649 m_pendingEvents
= new wxList
;
651 m_pendingEvents
->Append(eventCopy
);
653 #if defined(__VISAGECPP__)
654 wxLEAVE_CRIT_SECT( m_eventsLocker
);
656 wxLEAVE_CRIT_SECT( *m_eventsLocker
);
659 // 2) Add this event handler to list of event handlers that
660 // have pending events.
662 wxENTER_CRIT_SECT(*wxPendingEventsLocker
);
664 if ( !wxPendingEvents
)
665 wxPendingEvents
= new wxList
;
666 wxPendingEvents
->Append(this);
668 wxLEAVE_CRIT_SECT(*wxPendingEventsLocker
);
670 // 3) Inform the system that new pending events are somwehere,
671 // and that these should be processed in idle time.
675 void wxEvtHandler::ProcessPendingEvents()
677 #if defined(__VISAGECPP__)
678 wxENTER_CRIT_SECT( m_eventsLocker
);
680 wxENTER_CRIT_SECT( *m_eventsLocker
);
683 wxNode
*node
= m_pendingEvents
->First();
686 wxEvent
*event
= (wxEvent
*)node
->Data();
689 // In ProcessEvent, new events might get added and
690 // we can safely leave the crtical section here.
691 #if defined(__VISAGECPP__)
692 wxLEAVE_CRIT_SECT( m_eventsLocker
);
694 wxLEAVE_CRIT_SECT( *m_eventsLocker
);
696 ProcessEvent(*event
);
698 #if defined(__VISAGECPP__)
699 wxENTER_CRIT_SECT( m_eventsLocker
);
701 wxENTER_CRIT_SECT( *m_eventsLocker
);
704 node
= m_pendingEvents
->First();
707 #if defined(__VISAGECPP__)
708 wxLEAVE_CRIT_SECT( m_eventsLocker
);
710 wxLEAVE_CRIT_SECT( *m_eventsLocker
);
718 bool wxEvtHandler::ProcessEvent(wxEvent
& event
)
722 // We have to use the actual window or processing events from
723 // wxWindowNative destructor won't work (we don't see the wxWindow class)
725 // check that our flag corresponds to reality
726 wxClassInfo
* info
= NULL
;
727 #ifdef __WXUNIVERSAL__
728 # if defined(__WXMSW__)
729 info
= CLASSINFO(wxWindowMSW
);
730 # elif defined(__WXGTK__)
731 info
= CLASSINFO(wxWindowGTK
);
732 # elif defined(__WXX11__)
733 info
= CLASSINFO(wxWindowX11
);
734 # elif defined(__WXMGL__)
735 info
= CLASSINFO(wxWindowMGL
);
736 # elif defined(__WXPM__)
737 info
= CLASSINFO(wxWindowOS2
);
738 # elif defined(__WXMAC__)
739 info
= CLASSINFO(wxWindowMac
);
740 # elif defined(__WXMOTIF__)
741 info
= CLASSINFO(wxWindowMotif
);
744 info
= CLASSINFO(wxWindow
);
747 wxASSERT_MSG( m_isWindow
== IsKindOf(info
),
748 wxString(GetClassInfo()->GetClassName()) + _T(" should [not] be a window but it is [not]") );
753 // An event handler can be enabled or disabled
754 if ( GetEvtHandlerEnabled() )
759 What is this? When using GUI threads, a non main
760 threads can send an event and process it itself.
761 This breaks GTK's GUI threads, so please explain.
764 // Check whether we are in a child thread.
765 if ( !wxThread::IsMain() )
766 return ProcessThreadEvent(event
);
769 // Handle per-instance dynamic event tables first
770 if ( m_dynamicEvents
&& SearchDynamicEventTable(event
) )
773 // Then static per-class event tables
774 const wxEventTable
*table
= GetEventTable();
776 #if wxUSE_GUI && wxUSE_VALIDATORS
777 // Try the associated validator first, if this is a window.
778 // Problem: if the event handler of the window has been replaced,
779 // this wxEvtHandler may no longer be a window.
780 // Therefore validators won't be processed if the handler
781 // has been replaced with SetEventHandler.
782 // THIS CAN BE CURED if PushEventHandler is used instead of
783 // SetEventHandler, and then processing will be passed down the
784 // chain of event handlers.
787 wxWindow
*win
= (wxWindow
*)this;
789 // Can only use the validator of the window which
790 // is receiving the event
791 if ( win
== event
.GetEventObject() )
793 wxValidator
*validator
= win
->GetValidator();
794 if ( validator
&& validator
->ProcessEvent(event
) )
802 // Search upwards through the inheritance hierarchy
805 if ( SearchEventTable((wxEventTable
&)*table
, event
) )
807 table
= table
->baseTable
;
811 // Try going down the event handler chain
812 if ( GetNextHandler() )
814 if ( GetNextHandler()->ProcessEvent(event
) )
819 // Carry on up the parent-child hierarchy, but only if event is a command
820 // event: it wouldn't make sense for a parent to receive a child's size
821 // event, for example
822 if ( m_isWindow
&& event
.IsCommandEvent() )
824 wxWindow
*win
= (wxWindow
*)this;
826 // honour the requests to stop propagation at this window: this is
827 // used by the dialogs, for example, to prevent processing the events
828 // from the dialog controls in the parent frame which rarely, if ever,
830 if ( !(win
->GetExtraStyle() & wxWS_EX_BLOCK_EVENTS
) )
832 wxWindow
*parent
= win
->GetParent();
833 if ( parent
&& !parent
->IsBeingDeleted() )
834 return parent
->GetEventHandler()->ProcessEvent(event
);
839 // Last try - application object.
840 if ( wxTheApp
&& (this != wxTheApp
) )
842 // Special case: don't pass wxEVT_IDLE to wxApp, since it'll always
843 // swallow it. wxEVT_IDLE is sent explicitly to wxApp so it will be
844 // processed appropriately via SearchEventTable.
845 if ( event
.GetEventType() != wxEVT_IDLE
)
847 if ( wxTheApp
->ProcessEvent(event
) )
855 bool wxEvtHandler::SearchEventTable(wxEventTable
& table
, wxEvent
& event
)
857 wxEventType eventType
= event
.GetEventType();
858 int eventId
= event
.GetId();
860 // BC++ doesn't like testing for m_fn without != 0
861 for ( int i
= 0; table
.entries
[i
].m_fn
!= 0; i
++ )
863 // the line using reference exposes a bug in gcc: although it _seems_
864 // to work, it leads to weird crashes later on during program
867 wxEventTableEntry entry
= table
.entries
[i
];
869 const wxEventTableEntry
& entry
= table
.entries
[i
];
872 // match only if the event type is the same and the id is either -1 in
873 // the event table (meaning "any") or the event id matches the id
874 // specified in the event table either exactly or by falling into
875 // range between first and last
876 if ( eventType
== entry
.m_eventType
)
878 int tableId1
= entry
.m_id
,
879 tableId2
= entry
.m_lastId
;
881 if ( (tableId1
== -1) ||
882 (tableId2
== -1 && eventId
== tableId1
) ||
884 (eventId
>= tableId1
&& eventId
<= tableId2
)) )
887 event
.m_callbackUserData
= entry
.m_callbackUserData
;
889 (this->*((wxEventFunction
) (entry
.m_fn
)))(event
);
891 return !event
.GetSkipped();
899 void wxEvtHandler::Connect( int id
, int lastId
,
901 wxObjectEventFunction func
,
904 #if WXWIN_COMPATIBILITY_EVENT_TYPES
905 wxEventTableEntry
*entry
= new wxEventTableEntry
;
906 entry
->m_eventType
= eventType
;
908 entry
->m_lastId
= lastId
;
910 entry
->m_callbackUserData
= userData
;
911 #else // !WXWIN_COMPATIBILITY_EVENT_TYPES
912 wxDynamicEventTableEntry
*entry
=
913 new wxDynamicEventTableEntry(eventType
, id
, lastId
, func
, userData
);
914 #endif // WXWIN_COMPATIBILITY_EVENT_TYPES/!WXWIN_COMPATIBILITY_EVENT_TYPES
916 if (!m_dynamicEvents
)
917 m_dynamicEvents
= new wxList
;
919 m_dynamicEvents
->Append( (wxObject
*) entry
);
922 bool wxEvtHandler::Disconnect( int id
, int lastId
, wxEventType eventType
,
923 wxObjectEventFunction func
,
926 if (!m_dynamicEvents
)
929 wxNode
*node
= m_dynamicEvents
->First();
932 #if WXWIN_COMPATIBILITY_EVENT_TYPES
933 wxEventTableEntry
*entry
= (wxEventTableEntry
*)node
->Data();
934 #else // !WXWIN_COMPATIBILITY_EVENT_TYPES
935 wxDynamicEventTableEntry
*entry
= (wxDynamicEventTableEntry
*)node
->Data();
936 #endif // WXWIN_COMPATIBILITY_EVENT_TYPES/!WXWIN_COMPATIBILITY_EVENT_TYPES
938 if ((entry
->m_id
== id
) &&
939 ((entry
->m_lastId
== lastId
) || (lastId
== -1)) &&
940 ((entry
->m_eventType
== eventType
) || (eventType
== wxEVT_NULL
)) &&
941 ((entry
->m_fn
== func
) || (func
== (wxObjectEventFunction
)NULL
)) &&
942 ((entry
->m_callbackUserData
== userData
) || (userData
== (wxObject
*)NULL
)))
944 if (entry
->m_callbackUserData
)
945 delete entry
->m_callbackUserData
;
946 m_dynamicEvents
->DeleteNode( node
);
955 bool wxEvtHandler::SearchDynamicEventTable( wxEvent
& event
)
957 wxCHECK_MSG( m_dynamicEvents
, FALSE
,
958 wxT("caller should check that we have dynamic events") );
960 int commandId
= event
.GetId();
962 wxNode
*node
= m_dynamicEvents
->First();
965 #if WXWIN_COMPATIBILITY_EVENT_TYPES
966 wxEventTableEntry
*entry
= (wxEventTableEntry
*)node
->Data();
967 #else // !WXWIN_COMPATIBILITY_EVENT_TYPES
968 wxDynamicEventTableEntry
*entry
= (wxDynamicEventTableEntry
*)node
->Data();
969 #endif // WXWIN_COMPATIBILITY_EVENT_TYPES/!WXWIN_COMPATIBILITY_EVENT_TYPES
973 // Match, if event spec says any id will do (id == -1)
974 if ( (event
.GetEventType() == entry
->m_eventType
) &&
975 (entry
->m_id
== -1 ||
976 (entry
->m_lastId
== -1 && commandId
== entry
->m_id
) ||
977 (entry
->m_lastId
!= -1 &&
978 (commandId
>= entry
->m_id
&& commandId
<= entry
->m_lastId
))) )
981 event
.m_callbackUserData
= entry
->m_callbackUserData
;
983 (this->*((wxEventFunction
) (entry
->m_fn
)))(event
);
985 if (event
.GetSkipped())
996 void wxEvtHandler::DoSetClientObject( wxClientData
*data
)
998 wxASSERT_MSG( m_clientDataType
!= wxClientData_Void
,
999 wxT("can't have both object and void client data") );
1001 if ( m_clientObject
)
1002 delete m_clientObject
;
1004 m_clientObject
= data
;
1005 m_clientDataType
= wxClientData_Object
;
1008 wxClientData
*wxEvtHandler::DoGetClientObject() const
1010 // it's not an error to call GetClientObject() on a window which doesn't
1011 // have client data at all - NULL will be returned
1012 wxASSERT_MSG( m_clientDataType
!= wxClientData_Void
,
1013 wxT("this window doesn't have object client data") );
1015 return m_clientObject
;
1018 void wxEvtHandler::DoSetClientData( void *data
)
1020 wxASSERT_MSG( m_clientDataType
!= wxClientData_Object
,
1021 wxT("can't have both object and void client data") );
1023 m_clientData
= data
;
1024 m_clientDataType
= wxClientData_Void
;
1027 void *wxEvtHandler::DoGetClientData() const
1029 // it's not an error to call GetClientData() on a window which doesn't have
1030 // client data at all - NULL will be returned
1031 wxASSERT_MSG( m_clientDataType
!= wxClientData_Object
,
1032 wxT("this window doesn't have void client data") );
1034 return m_clientData
;
1038 #if WXWIN_COMPATIBILITY
1039 bool wxEvtHandler::OnClose()
1041 if (GetNextHandler())
1042 return GetNextHandler()->OnClose();
1046 #endif // WXWIN_COMPATIBILITY
1050 // Find a window with the focus, that is also a descendant of the given window.
1051 // This is used to determine the window to initially send commands to.
1052 wxWindow
* wxFindFocusDescendant(wxWindow
* ancestor
)
1054 // Process events starting with the window with the focus, if any.
1055 wxWindow
* focusWin
= wxWindow::FindFocus();
1056 wxWindow
* win
= focusWin
;
1058 // Check if this is a descendant of this frame.
1059 // If not, win will be set to NULL.
1062 if (win
== ancestor
)
1065 win
= win
->GetParent();
1067 if (win
== (wxWindow
*) NULL
)
1068 focusWin
= (wxWindow
*) NULL
;