src/common/event.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/common/event.cpp
   3 // Purpose:     Event classes
   4 // Author:      Julian Smart
   5 // Modified by:
   6 // Created:     01/02/97
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Julian Smart
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 // ============================================================================
  13 // declarations
  14 // ============================================================================
  15
  16 // ----------------------------------------------------------------------------
  17 // headers
  18 // ----------------------------------------------------------------------------
  19
  20 // For compilers that support precompilation, includes "wx.h".
  21 #include "wx/wxprec.h"
  22
  23 #ifdef __BORLANDC__
  24     #pragma hdrstop
  25 #endif
  26
  27 #include "wx/event.h"
  28
  29 #ifndef WX_PRECOMP
  30     #include "wx/list.h"
  31     #include "wx/app.h"
  32     #include "wx/utils.h"
  33     #include "wx/stopwatch.h"
  34
  35     #if wxUSE_GUI
  36         #include "wx/control.h"
  37         #include "wx/dc.h"
  38         #include "wx/textctrl.h"
  39         #include "wx/validate.h"
  40     #endif // wxUSE_GUI
  41 #endif
  42
  43 #include "wx/module.h"
  44
  45 // ----------------------------------------------------------------------------
  46 // wxWin macros
  47 // ----------------------------------------------------------------------------
  48
  49 #if wxUSE_BASE
  50     IMPLEMENT_DYNAMIC_CLASS(wxEvtHandler, wxObject)
  51     IMPLEMENT_ABSTRACT_CLASS(wxEvent, wxObject)
  52 #endif // wxUSE_BASE
  53
  54 #if wxUSE_GUI
  55     IMPLEMENT_DYNAMIC_CLASS(wxIdleEvent, wxEvent)
  56     IMPLEMENT_DYNAMIC_CLASS(wxCommandEvent, wxEvent)
  57     IMPLEMENT_DYNAMIC_CLASS(wxNotifyEvent, wxCommandEvent)
  58     IMPLEMENT_DYNAMIC_CLASS(wxScrollEvent, wxCommandEvent)
  59     IMPLEMENT_DYNAMIC_CLASS(wxScrollWinEvent, wxEvent)
  60     IMPLEMENT_DYNAMIC_CLASS(wxMouseEvent, wxEvent)
  61     IMPLEMENT_DYNAMIC_CLASS(wxKeyEvent, wxEvent)
  62     IMPLEMENT_DYNAMIC_CLASS(wxSizeEvent, wxEvent)
  63     IMPLEMENT_DYNAMIC_CLASS(wxPaintEvent, wxEvent)
  64     IMPLEMENT_DYNAMIC_CLASS(wxNcPaintEvent, wxEvent)
  65     IMPLEMENT_DYNAMIC_CLASS(wxEraseEvent, wxEvent)
  66     IMPLEMENT_DYNAMIC_CLASS(wxMoveEvent, wxEvent)
  67     IMPLEMENT_DYNAMIC_CLASS(wxFocusEvent, wxEvent)
  68     IMPLEMENT_DYNAMIC_CLASS(wxChildFocusEvent, wxCommandEvent)
  69     IMPLEMENT_DYNAMIC_CLASS(wxCloseEvent, wxEvent)
  70     IMPLEMENT_DYNAMIC_CLASS(wxShowEvent, wxEvent)
  71     IMPLEMENT_DYNAMIC_CLASS(wxMaximizeEvent, wxEvent)
  72     IMPLEMENT_DYNAMIC_CLASS(wxIconizeEvent, wxEvent)
  73     IMPLEMENT_DYNAMIC_CLASS(wxMenuEvent, wxEvent)
  74     IMPLEMENT_DYNAMIC_CLASS(wxJoystickEvent, wxEvent)
  75     IMPLEMENT_DYNAMIC_CLASS(wxDropFilesEvent, wxEvent)
  76     IMPLEMENT_DYNAMIC_CLASS(wxActivateEvent, wxEvent)
  77     IMPLEMENT_DYNAMIC_CLASS(wxInitDialogEvent, wxEvent)
  78     IMPLEMENT_DYNAMIC_CLASS(wxSetCursorEvent, wxEvent)
  79     IMPLEMENT_DYNAMIC_CLASS(wxSysColourChangedEvent, wxEvent)
  80     IMPLEMENT_DYNAMIC_CLASS(wxDisplayChangedEvent, wxEvent)
  81     IMPLEMENT_DYNAMIC_CLASS(wxUpdateUIEvent, wxCommandEvent)
  82     IMPLEMENT_DYNAMIC_CLASS(wxNavigationKeyEvent, wxEvent)
  83     IMPLEMENT_DYNAMIC_CLASS(wxPaletteChangedEvent, wxEvent)
  84     IMPLEMENT_DYNAMIC_CLASS(wxQueryNewPaletteEvent, wxEvent)
  85     IMPLEMENT_DYNAMIC_CLASS(wxWindowCreateEvent, wxEvent)
  86     IMPLEMENT_DYNAMIC_CLASS(wxWindowDestroyEvent, wxEvent)
  87     IMPLEMENT_DYNAMIC_CLASS(wxHelpEvent, wxCommandEvent)
  88     IMPLEMENT_DYNAMIC_CLASS(wxContextMenuEvent, wxCommandEvent)
  89     IMPLEMENT_DYNAMIC_CLASS(wxMouseCaptureChangedEvent, wxEvent)
  90     IMPLEMENT_DYNAMIC_CLASS(wxMouseCaptureLostEvent, wxEvent)
  91     IMPLEMENT_DYNAMIC_CLASS(wxClipboardTextEvent, wxCommandEvent)
  92 #endif // wxUSE_GUI
  93
  94 #if wxUSE_BASE
  95
  96 const wxEventTable *wxEvtHandler::GetEventTable() const
  97     { return &wxEvtHandler::sm_eventTable; }
  98
  99 const wxEventTable wxEvtHandler::sm_eventTable =
 100     { (const wxEventTable *)NULL, &wxEvtHandler::sm_eventTableEntries[0] };
 101
 102 wxEventHashTable &wxEvtHandler::GetEventHashTable() const
 103     { return wxEvtHandler::sm_eventHashTable; }
 104
 105 wxEventHashTable wxEvtHandler::sm_eventHashTable(wxEvtHandler::sm_eventTable);
 106
 107 const wxEventTableEntry wxEvtHandler::sm_eventTableEntries[] =
 108     { DECLARE_EVENT_TABLE_ENTRY(wxEVT_NULL, 0, 0, (wxObjectEventFunction)NULL, NULL) };
 109
 110
 111 #ifdef __WXDEBUG__
 112 // Clear up event hash table contents or we can get problems
 113 // when C++ is cleaning up the static object
 114 class wxEventTableEntryModule: public wxModule
 115 {
 116 DECLARE_DYNAMIC_CLASS(wxEventTableEntryModule)
 117 public:
 118     wxEventTableEntryModule() {}
 119     bool OnInit() { return true; }
 120     void OnExit()
 121     {
 122         wxEventHashTable::ClearAll();
 123     }
 124 };
 125 IMPLEMENT_DYNAMIC_CLASS(wxEventTableEntryModule, wxModule)
 126 #endif
 127
 128 // ----------------------------------------------------------------------------
 129 // global variables
 130 // ----------------------------------------------------------------------------
 131
 132 // To put pending event handlers
 133 wxList *wxPendingEvents = (wxList *)NULL;
 134
 135 #if wxUSE_THREADS
 136     // protects wxPendingEvents list
 137     wxCriticalSection *wxPendingEventsLocker = (wxCriticalSection *)NULL;
 138 #endif
 139
 140 #if !WXWIN_COMPATIBILITY_EVENT_TYPES
 141
 142 // common event types are defined here, other event types are defined by the
 143 // components which use them
 144
 145 const wxEventType wxEVT_FIRST = 10000;
 146 const wxEventType wxEVT_USER_FIRST = wxEVT_FIRST + 2000;
 147
 148 DEFINE_EVENT_TYPE(wxEVT_NULL)
 149 DEFINE_EVENT_TYPE(wxEVT_IDLE)
 150 DEFINE_EVENT_TYPE(wxEVT_SOCKET)
 151
 152 #endif // !WXWIN_COMPATIBILITY_EVENT_TYPES
 153
 154 #endif // wxUSE_BASE
 155
 156 #if wxUSE_GUI
 157
 158 #if !WXWIN_COMPATIBILITY_EVENT_TYPES
 159
 160 DEFINE_EVENT_TYPE(wxEVT_COMMAND_BUTTON_CLICKED)
 161 DEFINE_EVENT_TYPE(wxEVT_COMMAND_CHECKBOX_CLICKED)
 162 DEFINE_EVENT_TYPE(wxEVT_COMMAND_CHOICE_SELECTED)
 163 DEFINE_EVENT_TYPE(wxEVT_COMMAND_LISTBOX_SELECTED)
 164 DEFINE_EVENT_TYPE(wxEVT_COMMAND_LISTBOX_DOUBLECLICKED)
 165 DEFINE_EVENT_TYPE(wxEVT_COMMAND_CHECKLISTBOX_TOGGLED)
 166 DEFINE_EVENT_TYPE(wxEVT_COMMAND_MENU_SELECTED)
 167 DEFINE_EVENT_TYPE(wxEVT_COMMAND_SLIDER_UPDATED)
 168 DEFINE_EVENT_TYPE(wxEVT_COMMAND_RADIOBOX_SELECTED)
 169 DEFINE_EVENT_TYPE(wxEVT_COMMAND_RADIOBUTTON_SELECTED)
 170 DEFINE_EVENT_TYPE(wxEVT_COMMAND_SCROLLBAR_UPDATED)
 171 DEFINE_EVENT_TYPE(wxEVT_COMMAND_VLBOX_SELECTED)
 172 DEFINE_EVENT_TYPE(wxEVT_COMMAND_COMBOBOX_SELECTED)
 173 DEFINE_EVENT_TYPE(wxEVT_COMMAND_TOOL_RCLICKED)
 174 DEFINE_EVENT_TYPE(wxEVT_COMMAND_TOOL_ENTER)
 175 DEFINE_EVENT_TYPE(wxEVT_COMMAND_SPINCTRL_UPDATED)
 176
 177 // Sockets and timers send events, too
 178 DEFINE_EVENT_TYPE(wxEVT_TIMER)
 179
 180 // Mouse event types
 181 DEFINE_EVENT_TYPE(wxEVT_LEFT_DOWN)
 182 DEFINE_EVENT_TYPE(wxEVT_LEFT_UP)
 183 DEFINE_EVENT_TYPE(wxEVT_MIDDLE_DOWN)
 184 DEFINE_EVENT_TYPE(wxEVT_MIDDLE_UP)
 185 DEFINE_EVENT_TYPE(wxEVT_RIGHT_DOWN)
 186 DEFINE_EVENT_TYPE(wxEVT_RIGHT_UP)
 187 DEFINE_EVENT_TYPE(wxEVT_MOTION)
 188 DEFINE_EVENT_TYPE(wxEVT_ENTER_WINDOW)
 189 DEFINE_EVENT_TYPE(wxEVT_LEAVE_WINDOW)
 190 DEFINE_EVENT_TYPE(wxEVT_LEFT_DCLICK)
 191 DEFINE_EVENT_TYPE(wxEVT_MIDDLE_DCLICK)
 192 DEFINE_EVENT_TYPE(wxEVT_RIGHT_DCLICK)
 193 DEFINE_EVENT_TYPE(wxEVT_SET_FOCUS)
 194 DEFINE_EVENT_TYPE(wxEVT_KILL_FOCUS)
 195 DEFINE_EVENT_TYPE(wxEVT_CHILD_FOCUS)
 196 DEFINE_EVENT_TYPE(wxEVT_MOUSEWHEEL)
 197
 198 // Non-client mouse events
 199 DEFINE_EVENT_TYPE(wxEVT_NC_LEFT_DOWN)
 200 DEFINE_EVENT_TYPE(wxEVT_NC_LEFT_UP)
 201 DEFINE_EVENT_TYPE(wxEVT_NC_MIDDLE_DOWN)
 202 DEFINE_EVENT_TYPE(wxEVT_NC_MIDDLE_UP)
 203 DEFINE_EVENT_TYPE(wxEVT_NC_RIGHT_DOWN)
 204 DEFINE_EVENT_TYPE(wxEVT_NC_RIGHT_UP)
 205 DEFINE_EVENT_TYPE(wxEVT_NC_MOTION)
 206 DEFINE_EVENT_TYPE(wxEVT_NC_ENTER_WINDOW)
 207 DEFINE_EVENT_TYPE(wxEVT_NC_LEAVE_WINDOW)
 208 DEFINE_EVENT_TYPE(wxEVT_NC_LEFT_DCLICK)
 209 DEFINE_EVENT_TYPE(wxEVT_NC_MIDDLE_DCLICK)
 210 DEFINE_EVENT_TYPE(wxEVT_NC_RIGHT_DCLICK)
 211
 212 // Character input event type
 213 DEFINE_EVENT_TYPE(wxEVT_CHAR)
 214 DEFINE_EVENT_TYPE(wxEVT_CHAR_HOOK)
 215 DEFINE_EVENT_TYPE(wxEVT_NAVIGATION_KEY)
 216 DEFINE_EVENT_TYPE(wxEVT_KEY_DOWN)
 217 DEFINE_EVENT_TYPE(wxEVT_KEY_UP)
 218 #if wxUSE_HOTKEY
 219 DEFINE_EVENT_TYPE(wxEVT_HOTKEY)
 220 #endif
 221
 222 // Set cursor event
 223 DEFINE_EVENT_TYPE(wxEVT_SET_CURSOR)
 224
 225 // wxScrollbar and wxSlider event identifiers
 226 DEFINE_EVENT_TYPE(wxEVT_SCROLL_TOP)
 227 DEFINE_EVENT_TYPE(wxEVT_SCROLL_BOTTOM)
 228 DEFINE_EVENT_TYPE(wxEVT_SCROLL_LINEUP)
 229 DEFINE_EVENT_TYPE(wxEVT_SCROLL_LINEDOWN)
 230 DEFINE_EVENT_TYPE(wxEVT_SCROLL_PAGEUP)
 231 DEFINE_EVENT_TYPE(wxEVT_SCROLL_PAGEDOWN)
 232 DEFINE_EVENT_TYPE(wxEVT_SCROLL_THUMBTRACK)
 233 DEFINE_EVENT_TYPE(wxEVT_SCROLL_THUMBRELEASE)
 234 DEFINE_EVENT_TYPE(wxEVT_SCROLL_CHANGED)
 235
 236 // Scroll events from wxWindow
 237 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_TOP)
 238 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_BOTTOM)
 239 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_LINEUP)
 240 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_LINEDOWN)
 241 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_PAGEUP)
 242 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_PAGEDOWN)
 243 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_THUMBTRACK)
 244 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_THUMBRELEASE)
 245
 246 // System events
 247 DEFINE_EVENT_TYPE(wxEVT_SIZE)
 248 DEFINE_EVENT_TYPE(wxEVT_SIZING)
 249 DEFINE_EVENT_TYPE(wxEVT_MOVE)
 250 DEFINE_EVENT_TYPE(wxEVT_MOVING)
 251 DEFINE_EVENT_TYPE(wxEVT_CLOSE_WINDOW)
 252 DEFINE_EVENT_TYPE(wxEVT_END_SESSION)
 253 DEFINE_EVENT_TYPE(wxEVT_QUERY_END_SESSION)
 254 DEFINE_EVENT_TYPE(wxEVT_HIBERNATE)
 255 DEFINE_EVENT_TYPE(wxEVT_ACTIVATE_APP)
 256 DEFINE_EVENT_TYPE(wxEVT_POWER)
 257 DEFINE_EVENT_TYPE(wxEVT_ACTIVATE)
 258 DEFINE_EVENT_TYPE(wxEVT_CREATE)
 259 DEFINE_EVENT_TYPE(wxEVT_DESTROY)
 260 DEFINE_EVENT_TYPE(wxEVT_SHOW)
 261 DEFINE_EVENT_TYPE(wxEVT_ICONIZE)
 262 DEFINE_EVENT_TYPE(wxEVT_MAXIMIZE)
 263 DEFINE_EVENT_TYPE(wxEVT_MOUSE_CAPTURE_CHANGED)
 264 DEFINE_EVENT_TYPE(wxEVT_MOUSE_CAPTURE_LOST)
 265 DEFINE_EVENT_TYPE(wxEVT_PAINT)
 266 DEFINE_EVENT_TYPE(wxEVT_ERASE_BACKGROUND)
 267 DEFINE_EVENT_TYPE(wxEVT_NC_PAINT)
 268 DEFINE_EVENT_TYPE(wxEVT_PAINT_ICON)
 269 DEFINE_EVENT_TYPE(wxEVT_MENU_OPEN)
 270 DEFINE_EVENT_TYPE(wxEVT_MENU_CLOSE)
 271 DEFINE_EVENT_TYPE(wxEVT_MENU_HIGHLIGHT)
 272 DEFINE_EVENT_TYPE(wxEVT_CONTEXT_MENU)
 273 DEFINE_EVENT_TYPE(wxEVT_SYS_COLOUR_CHANGED)
 274 DEFINE_EVENT_TYPE(wxEVT_DISPLAY_CHANGED)
 275 DEFINE_EVENT_TYPE(wxEVT_SETTING_CHANGED)
 276 DEFINE_EVENT_TYPE(wxEVT_QUERY_NEW_PALETTE)
 277 DEFINE_EVENT_TYPE(wxEVT_PALETTE_CHANGED)
 278 DEFINE_EVENT_TYPE(wxEVT_JOY_BUTTON_DOWN)
 279 DEFINE_EVENT_TYPE(wxEVT_JOY_BUTTON_UP)
 280 DEFINE_EVENT_TYPE(wxEVT_JOY_MOVE)
 281 DEFINE_EVENT_TYPE(wxEVT_JOY_ZMOVE)
 282 DEFINE_EVENT_TYPE(wxEVT_DROP_FILES)
 283 DEFINE_EVENT_TYPE(wxEVT_DRAW_ITEM)
 284 DEFINE_EVENT_TYPE(wxEVT_MEASURE_ITEM)
 285 DEFINE_EVENT_TYPE(wxEVT_COMPARE_ITEM)
 286 DEFINE_EVENT_TYPE(wxEVT_INIT_DIALOG)
 287 DEFINE_EVENT_TYPE(wxEVT_UPDATE_UI)
 288
 289 // Clipboard events
 290 DEFINE_EVENT_TYPE(wxEVT_COMMAND_TEXT_COPY)
 291 DEFINE_EVENT_TYPE(wxEVT_COMMAND_TEXT_CUT)
 292 DEFINE_EVENT_TYPE(wxEVT_COMMAND_TEXT_PASTE)
 293
 294 // Generic command events
 295 // Note: a click is a higher-level event than button down/up
 296 DEFINE_EVENT_TYPE(wxEVT_COMMAND_LEFT_CLICK)
 297 DEFINE_EVENT_TYPE(wxEVT_COMMAND_LEFT_DCLICK)
 298 DEFINE_EVENT_TYPE(wxEVT_COMMAND_RIGHT_CLICK)
 299 DEFINE_EVENT_TYPE(wxEVT_COMMAND_RIGHT_DCLICK)
 300 DEFINE_EVENT_TYPE(wxEVT_COMMAND_SET_FOCUS)
 301 DEFINE_EVENT_TYPE(wxEVT_COMMAND_KILL_FOCUS)
 302 DEFINE_EVENT_TYPE(wxEVT_COMMAND_ENTER)
 303
 304 // Help events
 305 DEFINE_EVENT_TYPE(wxEVT_HELP)
 306 DEFINE_EVENT_TYPE(wxEVT_DETAILED_HELP)
 307
 308 #endif // !WXWIN_COMPATIBILITY_EVENT_TYPES
 309
 310 #endif // wxUSE_GUI
 311
 312 #if wxUSE_BASE
 313
 314 // ============================================================================
 315 // implementation
 316 // ============================================================================
 317
 318 // ----------------------------------------------------------------------------
 319 // event initialization
 320 // ----------------------------------------------------------------------------
 321
 322 int wxNewEventType()
 323 {
 324     // MT-FIXME
 325     static int s_lastUsedEventType = wxEVT_FIRST;
 326
 327     return s_lastUsedEventType++;
 328 }
 329
 330 // ----------------------------------------------------------------------------
 331 // wxEvent
 332 // ----------------------------------------------------------------------------
 333
 334 /*
 335  * General wxWidgets events, covering
 336  * all interesting things that might happen (button clicking, resizing,
 337  * setting text in widgets, etc.).
 338  *
 339  * For each completely new event type, derive a new event class.
 340  *
 341  */
 342
 343 wxEvent::wxEvent(int theId, wxEventType commandType )
 344 {
 345     m_eventType = commandType;
 346     m_eventObject = (wxObject *) NULL;
 347     m_timeStamp = 0;
 348     m_id = theId;
 349     m_skipped = false;
 350     m_callbackUserData = (wxObject *) NULL;
 351     m_isCommandEvent = false;
 352     m_propagationLevel = wxEVENT_PROPAGATE_NONE;
 353 }
 354
 355 wxEvent::wxEvent(const wxEvent &src)
 356     : wxObject()
 357     , m_eventObject(src.m_eventObject)
 358     , m_eventType(src.m_eventType)
 359     , m_timeStamp(src.m_timeStamp)
 360     , m_id(src.m_id)
 361     , m_callbackUserData(src.m_callbackUserData)
 362     , m_propagationLevel(src.m_propagationLevel)
 363     , m_skipped(src.m_skipped)
 364     , m_isCommandEvent(src.m_isCommandEvent)
 365 {
 366 }
 367
 368 #endif // wxUSE_BASE
 369
 370 #if wxUSE_GUI
 371
 372 /*
 373  * Command events
 374  *
 375  */
 376
 377 #ifdef __VISUALC__
 378     // 'this' : used in base member initializer list (for m_commandString)
 379     #pragma warning(disable:4355)
 380 #endif
 381
 382 wxCommandEvent::wxCommandEvent(wxEventType commandType, int theId)
 383               : wxEvent(theId, commandType)
 384 #if WXWIN_COMPATIBILITY_2_4
 385               , m_commandString(this)
 386 #endif
 387 {
 388     m_clientData = (char *) NULL;
 389     m_clientObject = (wxClientData *) NULL;
 390     m_extraLong = 0;
 391     m_commandInt = 0;
 392     m_isCommandEvent = true;
 393
 394     // the command events are propagated upwards by default
 395     m_propagationLevel = wxEVENT_PROPAGATE_MAX;
 396 }
 397
 398 #ifdef __VISUALC__
 399     #pragma warning(default:4355)
 400 #endif
 401
 402 wxString wxCommandEvent::GetString() const
 403 {
 404     if(m_eventType != wxEVT_COMMAND_TEXT_UPDATED || !m_eventObject)
 405         return m_cmdString;
 406     else
 407     {
 408 #if wxUSE_TEXTCTRL
 409         wxTextCtrl *txt = wxDynamicCast(m_eventObject, wxTextCtrl);
 410         if(txt)
 411             return txt->GetValue();
 412         else
 413 #endif // wxUSE_TEXTCTRL
 414             return m_cmdString;
 415     }
 416 }
 417
 418 /*
 419  * UI update events
 420  */
 421
 422 #if wxUSE_LONGLONG
 423 wxLongLong wxUpdateUIEvent::sm_lastUpdate = 0;
 424 #endif
 425
 426 long wxUpdateUIEvent::sm_updateInterval = 0;
 427
 428 wxUpdateUIMode wxUpdateUIEvent::sm_updateMode = wxUPDATE_UI_PROCESS_ALL;
 429
 430 // Can we update?
 431 bool wxUpdateUIEvent::CanUpdate(wxWindowBase *win)
 432 {
 433     // Don't update if we've switched global updating off
 434     // and this window doesn't support updates.
 435     if (win &&
 436        (GetMode() == wxUPDATE_UI_PROCESS_SPECIFIED &&
 437        ((win->GetExtraStyle() & wxWS_EX_PROCESS_UI_UPDATES) == 0)))
 438         return false;
 439
 440     if (sm_updateInterval == -1)
 441         return false;
 442
 443     if (sm_updateInterval == 0)
 444         return true;
 445
 446 #if wxUSE_STOPWATCH && wxUSE_LONGLONG
 447     wxLongLong now = wxGetLocalTimeMillis();
 448     if (now > (sm_lastUpdate + sm_updateInterval))
 449     {
 450         return true;
 451     }
 452
 453     return false;
 454 #else
 455     // If we don't have wxStopWatch or wxLongLong, we
 456     // should err on the safe side and update now anyway.
 457     return true;
 458 #endif
 459 }
 460
 461 // Reset the update time to provide a delay until the next
 462 // time we should update
 463 void wxUpdateUIEvent::ResetUpdateTime()
 464 {
 465 #if wxUSE_STOPWATCH && wxUSE_LONGLONG
 466     if (sm_updateInterval > 0)
 467     {
 468         wxLongLong now = wxGetLocalTimeMillis();
 469         if (now > (sm_lastUpdate + sm_updateInterval))
 470         {
 471             sm_lastUpdate = now;
 472         }
 473     }
 474 #endif
 475 }
 476
 477 /*
 478  * Idle events
 479  */
 480
 481 wxIdleMode wxIdleEvent::sm_idleMode = wxIDLE_PROCESS_ALL;
 482
 483 // Can we send an idle event?
 484 bool wxIdleEvent::CanSend(wxWindow* win)
 485 {
 486     // Don't update if we've switched global updating off
 487     // and this window doesn't support updates.
 488     if (win &&
 489        (GetMode() == wxIDLE_PROCESS_SPECIFIED &&
 490        ((win->GetExtraStyle() & wxWS_EX_PROCESS_IDLE) == 0)))
 491         return false;
 492
 493     return true;
 494 }
 495
 496 /*
 497  * Scroll events
 498  */
 499
 500 wxScrollEvent::wxScrollEvent(wxEventType commandType,
 501                              int id,
 502                              int pos,
 503                              int orient)
 504     : wxCommandEvent(commandType, id)
 505 {
 506     m_extraLong = orient;
 507     m_commandInt = pos;
 508 }
 509
 510 /*
 511  * ScrollWin events
 512  */
 513
 514 wxScrollWinEvent::wxScrollWinEvent(wxEventType commandType,
 515                                    int pos,
 516                                    int orient)
 517 {
 518     m_eventType = commandType;
 519     m_extraLong = orient;
 520     m_commandInt = pos;
 521 }
 522
 523 /*
 524  * Mouse events
 525  *
 526  */
 527
 528 wxMouseEvent::wxMouseEvent(wxEventType commandType)
 529 {
 530     m_eventType = commandType;
 531     m_metaDown = false;
 532     m_altDown = false;
 533     m_controlDown = false;
 534     m_shiftDown = false;
 535     m_leftDown = false;
 536     m_rightDown = false;
 537     m_middleDown = false;
 538     m_x = 0;
 539     m_y = 0;
 540     m_wheelRotation = 0;
 541     m_wheelDelta = 0;
 542     m_linesPerAction = 0;
 543 }
 544
 545 void wxMouseEvent::Assign(const wxMouseEvent& event)
 546 {
 547     m_eventType = event.m_eventType;
 548
 549     m_x = event.m_x;
 550     m_y = event.m_y;
 551
 552     m_leftDown = event.m_leftDown;
 553     m_middleDown = event.m_middleDown;
 554     m_rightDown = event.m_rightDown;
 555
 556     m_controlDown = event.m_controlDown;
 557     m_shiftDown = event.m_shiftDown;
 558     m_altDown = event.m_altDown;
 559     m_metaDown = event.m_metaDown;
 560
 561     m_wheelRotation = event.m_wheelRotation;
 562     m_wheelDelta = event.m_wheelDelta;
 563     m_linesPerAction = event.m_linesPerAction;
 564 }
 565
 566 // return true if was a button dclick event
 567 bool wxMouseEvent::ButtonDClick(int but) const
 568 {
 569     switch (but)
 570     {
 571         default:
 572             wxFAIL_MSG(wxT("invalid parameter in wxMouseEvent::ButtonDClick"));
 573             // fall through
 574
 575         case wxMOUSE_BTN_ANY:
 576             return (LeftDClick() || MiddleDClick() || RightDClick());
 577
 578         case wxMOUSE_BTN_LEFT:
 579             return LeftDClick();
 580
 581         case wxMOUSE_BTN_MIDDLE:
 582             return MiddleDClick();
 583
 584         case wxMOUSE_BTN_RIGHT:
 585             return RightDClick();
 586     }
 587 }
 588
 589 // return true if was a button down event
 590 bool wxMouseEvent::ButtonDown(int but) const
 591 {
 592     switch (but)
 593     {
 594         default:
 595             wxFAIL_MSG(wxT("invalid parameter in wxMouseEvent::ButtonDown"));
 596             // fall through
 597
 598         case wxMOUSE_BTN_ANY:
 599             return (LeftDown() || MiddleDown() || RightDown());
 600
 601         case wxMOUSE_BTN_LEFT:
 602             return LeftDown();
 603
 604         case wxMOUSE_BTN_MIDDLE:
 605             return MiddleDown();
 606
 607         case wxMOUSE_BTN_RIGHT:
 608             return RightDown();
 609     }
 610 }
 611
 612 // return true if was a button up event
 613 bool wxMouseEvent::ButtonUp(int but) const
 614 {
 615     switch (but)
 616     {
 617         default:
 618             wxFAIL_MSG(wxT("invalid parameter in wxMouseEvent::ButtonUp"));
 619             // fall through
 620
 621         case wxMOUSE_BTN_ANY:
 622             return (LeftUp() || MiddleUp() || RightUp());
 623
 624         case wxMOUSE_BTN_LEFT:
 625             return LeftUp();
 626
 627         case wxMOUSE_BTN_MIDDLE:
 628             return MiddleUp();
 629
 630         case wxMOUSE_BTN_RIGHT:
 631             return RightUp();
 632     }
 633 }
 634
 635 // return true if the given button is currently changing state
 636 bool wxMouseEvent::Button(int but) const
 637 {
 638     switch (but)
 639     {
 640         default:
 641             wxFAIL_MSG(wxT("invalid parameter in wxMouseEvent::Button"));
 642             // fall through
 643
 644         case wxMOUSE_BTN_ANY:
 645             return ButtonUp(wxMOUSE_BTN_ANY) ||
 646                     ButtonDown(wxMOUSE_BTN_ANY) ||
 647                         ButtonDClick(wxMOUSE_BTN_ANY);
 648
 649         case wxMOUSE_BTN_LEFT:
 650             return LeftDown() || LeftUp() || LeftDClick();
 651
 652         case wxMOUSE_BTN_MIDDLE:
 653             return MiddleDown() || MiddleUp() || MiddleDClick();
 654
 655         case wxMOUSE_BTN_RIGHT:
 656             return RightDown() || RightUp() || RightDClick();
 657     }
 658 }
 659
 660 bool wxMouseEvent::ButtonIsDown(int but) const
 661 {
 662     switch (but)
 663     {
 664         default:
 665             wxFAIL_MSG(wxT("invalid parameter in wxMouseEvent::ButtonIsDown"));
 666             // fall through
 667
 668         case wxMOUSE_BTN_ANY:
 669             return LeftIsDown() || MiddleIsDown() || RightIsDown();
 670
 671         case wxMOUSE_BTN_LEFT:
 672             return LeftIsDown();
 673
 674         case wxMOUSE_BTN_MIDDLE:
 675             return MiddleIsDown();
 676
 677         case wxMOUSE_BTN_RIGHT:
 678             return RightIsDown();
 679     }
 680 }
 681
 682 int wxMouseEvent::GetButton() const
 683 {
 684     for ( int i = 1; i <= 3; i++ )
 685     {
 686         if ( Button(i) )
 687         {
 688             return i;
 689         }
 690     }
 691
 692     return wxMOUSE_BTN_NONE;
 693 }
 694
 695 // Find the logical position of the event given the DC
 696 wxPoint wxMouseEvent::GetLogicalPosition(const wxDC& dc) const
 697 {
 698     wxPoint pt(dc.DeviceToLogicalX(m_x), dc.DeviceToLogicalY(m_y));
 699     return pt;
 700 }
 701
 702
 703 /*
 704  * Keyboard event
 705  *
 706  */
 707
 708 wxKeyEvent::wxKeyEvent(wxEventType type)
 709 {
 710     m_eventType = type;
 711     m_shiftDown = false;
 712     m_controlDown = false;
 713     m_metaDown = false;
 714     m_altDown = false;
 715     m_keyCode = 0;
 716     m_scanCode = 0;
 717 #if wxUSE_UNICODE
 718     m_uniChar = 0;
 719 #endif
 720 }
 721
 722 wxKeyEvent::wxKeyEvent(const wxKeyEvent& evt)
 723     : wxEvent(evt)
 724 {
 725     m_x = evt.m_x;
 726     m_y = evt.m_y;
 727
 728     m_keyCode = evt.m_keyCode;
 729
 730     m_controlDown = evt.m_controlDown;
 731     m_shiftDown = evt.m_shiftDown;
 732     m_altDown = evt.m_altDown;
 733     m_metaDown = evt.m_metaDown;
 734     m_scanCode = evt.m_scanCode;
 735     m_rawCode = evt.m_rawCode;
 736     m_rawFlags = evt.m_rawFlags;
 737
 738 #if wxUSE_UNICODE
 739     m_uniChar = evt.m_uniChar;
 740 #endif
 741 }
 742
 743 #if WXWIN_COMPATIBILITY_2_6
 744 long wxKeyEvent::KeyCode() const
 745 {
 746     return m_keyCode;
 747 }
 748 #endif // WXWIN_COMPATIBILITY_2_6
 749
 750 wxWindowCreateEvent::wxWindowCreateEvent(wxWindow *win)
 751 {
 752     SetEventType(wxEVT_CREATE);
 753     SetEventObject(win);
 754 }
 755
 756 wxWindowDestroyEvent::wxWindowDestroyEvent(wxWindow *win)
 757 {
 758     SetEventType(wxEVT_DESTROY);
 759     SetEventObject(win);
 760 }
 761
 762 wxChildFocusEvent::wxChildFocusEvent(wxWindow *win)
 763                  : wxCommandEvent(wxEVT_CHILD_FOCUS)
 764 {
 765     SetEventObject(win);
 766 }
 767
 768 // ----------------------------------------------------------------------------
 769 // wxHelpEvent
 770 // ----------------------------------------------------------------------------
 771
 772 /* static */
 773 wxHelpEvent::Origin wxHelpEvent::GuessOrigin(Origin origin)
 774 {
 775     if ( origin == Origin_Unknown )
 776     {
 777         // assume that the event comes from the help button if it's not from
 778         // keyboard and that pressing F1 always results in the help event
 779         origin = wxGetKeyState(WXK_F1) ? Origin_Keyboard : Origin_HelpButton;
 780     }
 781
 782     return origin;
 783 }
 784
 785 #endif // wxUSE_GUI
 786
 787
 788 #if wxUSE_BASE
 789
 790 // ----------------------------------------------------------------------------
 791 // wxEventHashTable
 792 // ----------------------------------------------------------------------------
 793
 794 static const int EVENT_TYPE_TABLE_INIT_SIZE = 31; // Not too big not too small...
 795
 796 wxEventHashTable* wxEventHashTable::sm_first = NULL;
 797
 798 wxEventHashTable::wxEventHashTable(const wxEventTable &table)
 799                 : m_table(table),
 800                   m_rebuildHash(true)
 801 {
 802     AllocEventTypeTable(EVENT_TYPE_TABLE_INIT_SIZE);
 803
 804     m_next = sm_first;
 805     if (m_next)
 806         m_next->m_previous = this;
 807     sm_first = this;
 808 }
 809
 810 wxEventHashTable::~wxEventHashTable()
 811 {
 812     if (m_next)
 813         m_next->m_previous = m_previous;
 814     if (m_previous)
 815         m_previous->m_next = m_next;
 816     if (sm_first == this)
 817         sm_first = m_next;
 818
 819     Clear();
 820 }
 821
 822 void wxEventHashTable::Clear()
 823 {
 824     size_t i;
 825     for(i = 0; i < m_size; i++)
 826     {
 827         EventTypeTablePointer  eTTnode = m_eventTypeTable[i];
 828         if (eTTnode)
 829         {
 830             delete eTTnode;
 831         }
 832     }
 833
 834     // Necessary in order to not invoke the
 835     // overloaded delete operator when statics are cleaned up
 836     if (m_eventTypeTable)
 837         delete[] m_eventTypeTable;
 838
 839     m_eventTypeTable = NULL;
 840     m_size = 0;
 841 }
 842
 843 // Clear all tables
 844 void wxEventHashTable::ClearAll()
 845 {
 846     wxEventHashTable* table = sm_first;
 847     while (table)
 848     {
 849         table->Clear();
 850         table = table->m_next;
 851     }
 852 }
 853
 854 bool wxEventHashTable::HandleEvent(wxEvent &event, wxEvtHandler *self)
 855 {
 856     if (m_rebuildHash)
 857     {
 858         InitHashTable();
 859         m_rebuildHash = false;
 860     }
 861
 862     if (!m_eventTypeTable)
 863         return false;
 864
 865     // Find all entries for the given event type.
 866     wxEventType eventType = event.GetEventType();
 867     const EventTypeTablePointer eTTnode = m_eventTypeTable[eventType % m_size];
 868     if (eTTnode && eTTnode->eventType == eventType)
 869     {
 870         // Now start the search for an event handler
 871         // that can handle an event with the given ID.
 872         const wxEventTableEntryPointerArray&
 873             eventEntryTable = eTTnode->eventEntryTable;
 874
 875         const size_t count = eventEntryTable.GetCount();
 876         for (size_t n = 0; n < count; n++)
 877         {
 878             if ( wxEvtHandler::
 879                     ProcessEventIfMatches(*eventEntryTable[n], self, event) )
 880             {
 881                 return true;
 882             }
 883         }
 884     }
 885
 886     return false;
 887 }
 888
 889 void wxEventHashTable::InitHashTable()
 890 {
 891     // Loop over the event tables and all its base tables.
 892     const wxEventTable *table = &m_table;
 893     while (table)
 894     {
 895         // Retrieve all valid event handler entries
 896         const wxEventTableEntry *entry = table->entries;
 897         while (entry->m_fn != 0)
 898         {
 899             // Add the event entry in the Hash.
 900             AddEntry(*entry);
 901
 902             entry++;
 903         }
 904
 905         table = table->baseTable;
 906     }
 907
 908     // Lets free some memory.
 909     size_t i;
 910     for(i = 0; i < m_size; i++)
 911     {
 912         EventTypeTablePointer  eTTnode = m_eventTypeTable[i];
 913         if (eTTnode)
 914         {
 915             eTTnode->eventEntryTable.Shrink();
 916         }
 917     }
 918 }
 919
 920 void wxEventHashTable::AddEntry(const wxEventTableEntry &entry)
 921 {
 922     // This might happen 'accidentally' as the app is exiting
 923     if (!m_eventTypeTable)
 924         return;
 925
 926     EventTypeTablePointer *peTTnode = &m_eventTypeTable[entry.m_eventType % m_size];
 927     EventTypeTablePointer  eTTnode = *peTTnode;
 928
 929     if (eTTnode)
 930     {
 931         if (eTTnode->eventType != entry.m_eventType)
 932         {
 933             // Resize the table!
 934             GrowEventTypeTable();
 935             // Try again to add it.
 936             AddEntry(entry);
 937             return;
 938         }
 939     }
 940     else
 941     {
 942         eTTnode = new EventTypeTable;
 943         eTTnode->eventType = entry.m_eventType;
 944         *peTTnode = eTTnode;
 945     }
 946
 947     // Fill all hash entries between entry.m_id and entry.m_lastId...
 948     eTTnode->eventEntryTable.Add(&entry);
 949 }
 950
 951 void wxEventHashTable::AllocEventTypeTable(size_t size)
 952 {
 953     m_eventTypeTable = new EventTypeTablePointer[size];
 954     memset((void *)m_eventTypeTable, 0, sizeof(EventTypeTablePointer)*size);
 955     m_size = size;
 956 }
 957
 958 void wxEventHashTable::GrowEventTypeTable()
 959 {
 960     size_t oldSize = m_size;
 961     EventTypeTablePointer *oldEventTypeTable = m_eventTypeTable;
 962
 963     // TODO: Search the most optimal grow sequence
 964     AllocEventTypeTable(/* GetNextPrime(oldSize) */oldSize*2+1);
 965
 966     for ( size_t i = 0; i < oldSize; /* */ )
 967     {
 968         EventTypeTablePointer  eTToldNode = oldEventTypeTable[i];
 969         if (eTToldNode)
 970         {
 971             EventTypeTablePointer *peTTnode = &m_eventTypeTable[eTToldNode->eventType % m_size];
 972             EventTypeTablePointer  eTTnode = *peTTnode;
 973
 974             // Check for collision, we don't want any.
 975             if (eTTnode)
 976             {
 977                 GrowEventTypeTable();
 978                 continue; // Don't increment the counter,
 979                           // as we still need to add this element.
 980             }
 981             else
 982             {
 983                 // Get the old value and put it in the new table.
 984                 *peTTnode = oldEventTypeTable[i];
 985             }
 986         }
 987
 988         i++;
 989     }
 990
 991     delete[] oldEventTypeTable;
 992 }
 993
 994
 995 // ----------------------------------------------------------------------------
 996 // wxEvtHandler
 997 // ----------------------------------------------------------------------------
 998
 999 /*
1000  * Event handler
1001  */
1002
1003 wxEvtHandler::wxEvtHandler()
1004 {
1005     m_nextHandler = (wxEvtHandler *) NULL;
1006     m_previousHandler = (wxEvtHandler *) NULL;
1007     m_enabled = true;
1008     m_dynamicEvents = (wxList *) NULL;
1009     m_pendingEvents = (wxList *) NULL;
1010 #if wxUSE_THREADS
1011 #  if !defined(__VISAGECPP__)
1012     m_eventsLocker = new wxCriticalSection;
1013 #  endif
1014 #endif
1015     // no client data (yet)
1016     m_clientData = NULL;
1017     m_clientDataType = wxClientData_None;
1018 }
1019
1020 wxEvtHandler::~wxEvtHandler()
1021 {
1022     // Takes itself out of the list of handlers
1023     if (m_previousHandler)
1024         m_previousHandler->m_nextHandler = m_nextHandler;
1025
1026     if (m_nextHandler)
1027         m_nextHandler->m_previousHandler = m_previousHandler;
1028
1029     if (m_dynamicEvents)
1030     {
1031         wxList::iterator it = m_dynamicEvents->begin(),
1032                          en = m_dynamicEvents->end();
1033         for (;it != en; ++it)
1034         {
1035 #if WXWIN_COMPATIBILITY_EVENT_TYPES
1036             wxEventTableEntry *entry = (wxEventTableEntry*)*it;
1037 #else // !WXWIN_COMPATIBILITY_EVENT_TYPES
1038             wxDynamicEventTableEntry *entry = (wxDynamicEventTableEntry*)*it;
1039 #endif // WXWIN_COMPATIBILITY_EVENT_TYPES/!WXWIN_COMPATIBILITY_EVENT_TYPES
1040
1041             if (entry->m_callbackUserData)
1042                 delete entry->m_callbackUserData;
1043             delete entry;
1044         }
1045         delete m_dynamicEvents;
1046     };
1047
1048     if (m_pendingEvents)
1049         m_pendingEvents->DeleteContents(true);
1050     delete m_pendingEvents;
1051
1052 #if wxUSE_THREADS
1053 #  if !defined(__VISAGECPP__)
1054     delete m_eventsLocker;
1055 #  endif
1056
1057     // Remove us from wxPendingEvents if necessary.
1058     if(wxPendingEventsLocker)
1059         wxENTER_CRIT_SECT(*wxPendingEventsLocker);
1060     if ( wxPendingEvents )
1061     {
1062         // Delete all occurences of this from the list of pending events
1063         while (wxPendingEvents->DeleteObject(this)) { } // Do nothing
1064     }
1065     if(wxPendingEventsLocker)
1066         wxLEAVE_CRIT_SECT(*wxPendingEventsLocker);
1067 #endif
1068
1069     // we only delete object data, not untyped
1070     if ( m_clientDataType == wxClientData_Object )
1071         delete m_clientObject;
1072 }
1073
1074 #if wxUSE_THREADS
1075
1076 bool wxEvtHandler::ProcessThreadEvent(wxEvent& event)
1077 {
1078     // check that we are really in a child thread
1079     wxASSERT_MSG( !wxThread::IsMain(),
1080                   wxT("use ProcessEvent() in main thread") );
1081
1082     AddPendingEvent(event);
1083
1084     return true;
1085 }
1086
1087 void wxEvtHandler::ClearEventLocker()
1088 {
1089 #if !defined(__VISAGECPP__)
1090     delete m_eventsLocker;
1091     m_eventsLocker = NULL;
1092 #endif
1093 }
1094
1095 #endif // wxUSE_THREADS
1096
1097 void wxEvtHandler::AddPendingEvent(wxEvent& event)
1098 {
1099     // 1) Add event to list of pending events of this event handler
1100
1101     wxEvent *eventCopy = event.Clone();
1102
1103     // we must be able to copy the events here so the event class must
1104     // implement Clone() properly instead of just providing a NULL stab for it
1105     wxCHECK_RET( eventCopy,
1106                  _T("events of this type aren't supposed to be posted") );
1107
1108     wxENTER_CRIT_SECT( Lock() );
1109
1110     if ( !m_pendingEvents )
1111       m_pendingEvents = new wxList;
1112
1113     m_pendingEvents->Append(eventCopy);
1114
1115     wxLEAVE_CRIT_SECT( Lock() );
1116
1117     // 2) Add this event handler to list of event handlers that
1118     //    have pending events.
1119
1120     wxENTER_CRIT_SECT(*wxPendingEventsLocker);
1121
1122     if ( !wxPendingEvents )
1123         wxPendingEvents = new wxList;
1124     wxPendingEvents->Append(this);
1125
1126     wxLEAVE_CRIT_SECT(*wxPendingEventsLocker);
1127
1128     // 3) Inform the system that new pending events are somewhere,
1129     //    and that these should be processed in idle time.
1130     wxWakeUpIdle();
1131 }
1132
1133 void wxEvtHandler::ProcessPendingEvents()
1134 {
1135     // this method is only called by wxApp if this handler does have pending
1136     // events
1137     wxCHECK_RET( m_pendingEvents,
1138                  wxT("Please call wxApp::ProcessPendingEvents() instead") );
1139
1140     wxENTER_CRIT_SECT( Lock() );
1141
1142     // we leave the loop once we have processed all events that were present at
1143     // the start of ProcessPendingEvents because otherwise we could get into
1144     // infinite loop if the pending event handler execution resulted in another
1145     // event being posted
1146     size_t n = m_pendingEvents->size();
1147     for ( wxList::compatibility_iterator node = m_pendingEvents->GetFirst();
1148           node;
1149           node = m_pendingEvents->GetFirst() )
1150     {
1151         wxEvent *event = (wxEvent *)node->GetData();
1152
1153         // It's importan we remove event from list before processing it.
1154         // Else a nested event loop, for example from a modal dialog, might
1155         // process the same event again.
1156         m_pendingEvents->Erase(node);
1157
1158         wxLEAVE_CRIT_SECT( Lock() );
1159
1160         ProcessEvent(*event);
1161         delete event;
1162
1163         wxENTER_CRIT_SECT( Lock() );
1164
1165         if ( --n == 0 )
1166             break;
1167     }
1168
1169     wxLEAVE_CRIT_SECT( Lock() );
1170 }
1171
1172 /*
1173  * Event table stuff
1174  */
1175 /* static */ bool
1176 wxEvtHandler::ProcessEventIfMatches(const wxEventTableEntryBase& entry,
1177                                     wxEvtHandler *handler,
1178                                     wxEvent& event)
1179 {
1180     int tableId1 = entry.m_id,
1181         tableId2 = entry.m_lastId;
1182
1183     // match only if the event type is the same and the id is either -1 in
1184     // the event table (meaning "any") or the event id matches the id
1185     // specified in the event table either exactly or by falling into
1186     // range between first and last
1187     if ((tableId1 == wxID_ANY) ||
1188         (tableId2 == wxID_ANY && tableId1 == event.GetId()) ||
1189         (tableId2 != wxID_ANY &&
1190          (event.GetId() >= tableId1 && event.GetId() <= tableId2)))
1191     {
1192         event.Skip(false);
1193         event.m_callbackUserData = entry.m_callbackUserData;
1194
1195 #if wxUSE_EXCEPTIONS
1196         if ( wxTheApp )
1197         {
1198             // call the handler via wxApp method which allows the user to catch
1199             // any exceptions which may be thrown by any handler in the program
1200             // in one place
1201             wxTheApp->HandleEvent(handler, (wxEventFunction)entry.m_fn, event);
1202         }
1203         else
1204 #endif // wxUSE_EXCEPTIONS
1205         {
1206             // no need for an extra virtual function call
1207             (handler->*((wxEventFunction) (entry.m_fn)))(event);
1208         }
1209
1210         if (!event.GetSkipped())
1211             return true;
1212     }
1213
1214     return false;
1215 }
1216
1217 bool wxEvtHandler::TryParent(wxEvent& event)
1218 {
1219     if ( wxTheApp && (this != wxTheApp) )
1220     {
1221         // Special case: don't pass wxEVT_IDLE to wxApp, since it'll always
1222         // swallow it. wxEVT_IDLE is sent explicitly to wxApp so it will be
1223         // processed appropriately via SearchEventTable.
1224         if ( event.GetEventType() != wxEVT_IDLE )
1225         {
1226             if ( wxTheApp->ProcessEvent(event) )
1227                 return true;
1228         }
1229     }
1230
1231     return false;
1232 }
1233
1234 bool wxEvtHandler::ProcessEvent(wxEvent& event)
1235 {
1236     // allow the application to hook into event processing
1237     if ( wxTheApp )
1238     {
1239         int rc = wxTheApp->FilterEvent(event);
1240         if ( rc != -1 )
1241         {
1242             wxASSERT_MSG( rc == 1 || rc == 0,
1243                           _T("unexpected wxApp::FilterEvent return value") );
1244
1245             return rc != 0;
1246         }
1247         //else: proceed normally
1248     }
1249
1250     // An event handler can be enabled or disabled
1251     if ( GetEvtHandlerEnabled() )
1252     {
1253         // if we have a validator, it has higher priority than our own event
1254         // table
1255         if ( TryValidator(event) )
1256             return true;
1257
1258         // Handle per-instance dynamic event tables first
1259         if ( m_dynamicEvents && SearchDynamicEventTable(event) )
1260             return true;
1261
1262         // Then static per-class event tables
1263         if ( GetEventHashTable().HandleEvent(event, this) )
1264             return true;
1265     }
1266
1267     // Try going down the event handler chain
1268     if ( GetNextHandler() )
1269     {
1270         if ( GetNextHandler()->ProcessEvent(event) )
1271             return true;
1272     }
1273
1274     // Finally propagate the event upwards the window chain and/or to the
1275     // application object as necessary
1276     return TryParent(event);
1277 }
1278
1279
1280 bool wxEvtHandler::SearchEventTable(wxEventTable& table, wxEvent& event)
1281 {
1282     const wxEventType eventType = event.GetEventType();
1283     for ( int i = 0; table.entries[i].m_fn != 0; i++ )
1284     {
1285         const wxEventTableEntry& entry = table.entries[i];
1286         if ( eventType == entry.m_eventType )
1287         {
1288             if ( ProcessEventIfMatches(entry, this, event) )
1289                 return true;
1290         }
1291     }
1292
1293     return false;
1294 }
1295
1296 void wxEvtHandler::Connect( int id, int lastId,
1297                             int eventType,
1298                             wxObjectEventFunction func,
1299                             wxObject *userData,
1300                             wxEvtHandler* eventSink )
1301 {
1302 #if WXWIN_COMPATIBILITY_EVENT_TYPES
1303     wxEventTableEntry *entry = new wxEventTableEntry;
1304     entry->m_eventType = eventType;
1305     entry->m_id = id;
1306     entry->m_lastId = lastId;
1307     entry->m_fn = func;
1308     entry->m_callbackUserData = userData;
1309 #else // !WXWIN_COMPATIBILITY_EVENT_TYPES
1310     wxDynamicEventTableEntry *entry =
1311         new wxDynamicEventTableEntry(eventType, id, lastId, func, userData, eventSink);
1312 #endif // WXWIN_COMPATIBILITY_EVENT_TYPES/!WXWIN_COMPATIBILITY_EVENT_TYPES
1313
1314     if (!m_dynamicEvents)
1315         m_dynamicEvents = new wxList;
1316
1317     // Insert at the front of the list so most recent additions are found first
1318     m_dynamicEvents->Insert( (wxObject*) entry );
1319 }
1320
1321 bool wxEvtHandler::Disconnect( int id, int lastId, wxEventType eventType,
1322                   wxObjectEventFunction func,
1323                   wxObject *userData,
1324                   wxEvtHandler* eventSink )
1325 {
1326     if (!m_dynamicEvents)
1327         return false;
1328
1329     wxList::compatibility_iterator node = m_dynamicEvents->GetFirst();
1330     while (node)
1331     {
1332 #if WXWIN_COMPATIBILITY_EVENT_TYPES
1333             wxEventTableEntry *entry = (wxEventTableEntry*)node->GetData();
1334 #else // !WXWIN_COMPATIBILITY_EVENT_TYPES
1335             wxDynamicEventTableEntry *entry = (wxDynamicEventTableEntry*)node->GetData();
1336 #endif // WXWIN_COMPATIBILITY_EVENT_TYPES/!WXWIN_COMPATIBILITY_EVENT_TYPES
1337
1338         if ((entry->m_id == id) &&
1339             ((entry->m_lastId == lastId) || (lastId == wxID_ANY)) &&
1340             ((entry->m_eventType == eventType) || (eventType == wxEVT_NULL)) &&
1341             ((entry->m_fn == func) || (func == (wxObjectEventFunction)NULL)) &&
1342             ((entry->m_eventSink == eventSink) || (eventSink == (wxEvtHandler*)NULL)) &&
1343             ((entry->m_callbackUserData == userData) || (userData == (wxObject*)NULL)))
1344         {
1345             if (entry->m_callbackUserData)
1346                 delete entry->m_callbackUserData;
1347             m_dynamicEvents->Erase( node );
1348             delete entry;
1349             return true;
1350         }
1351         node = node->GetNext();
1352     }
1353     return false;
1354 }
1355
1356 bool wxEvtHandler::SearchDynamicEventTable( wxEvent& event )
1357 {
1358     wxCHECK_MSG( m_dynamicEvents, false,
1359                  wxT("caller should check that we have dynamic events") );
1360
1361     wxList::compatibility_iterator node = m_dynamicEvents->GetFirst();
1362     while (node)
1363     {
1364 #if WXWIN_COMPATIBILITY_EVENT_TYPES
1365         wxEventTableEntry *entry = (wxEventTableEntry*)node->GetData();
1366 #else // !WXWIN_COMPATIBILITY_EVENT_TYPES
1367         wxDynamicEventTableEntry *entry = (wxDynamicEventTableEntry*)node->GetData();
1368 #endif // WXWIN_COMPATIBILITY_EVENT_TYPES/!WXWIN_COMPATIBILITY_EVENT_TYPES
1369
1370         // get next node before (maybe) calling the event handler as it could
1371         // call Disconnect() invalidating the current node
1372         node = node->GetNext();
1373
1374         if ((event.GetEventType() == entry->m_eventType) && (entry->m_fn != 0))
1375         {
1376             wxEvtHandler *handler =
1377 #if !WXWIN_COMPATIBILITY_EVENT_TYPES
1378                                     entry->m_eventSink ? entry->m_eventSink
1379                                                        :
1380 #endif
1381                                                          this;
1382
1383             if ( ProcessEventIfMatches(*entry, handler, event) )
1384             {
1385                 return true;
1386             }
1387         }
1388     }
1389
1390     return false;
1391 }
1392
1393 void wxEvtHandler::DoSetClientObject( wxClientData *data )
1394 {
1395     wxASSERT_MSG( m_clientDataType != wxClientData_Void,
1396                   wxT("can't have both object and void client data") );
1397
1398     if ( m_clientObject )
1399         delete m_clientObject;
1400
1401     m_clientObject = data;
1402     m_clientDataType = wxClientData_Object;
1403 }
1404
1405 wxClientData *wxEvtHandler::DoGetClientObject() const
1406 {
1407     // it's not an error to call GetClientObject() on a window which doesn't
1408     // have client data at all - NULL will be returned
1409     wxASSERT_MSG( m_clientDataType != wxClientData_Void,
1410                   wxT("this window doesn't have object client data") );
1411
1412     return m_clientObject;
1413 }
1414
1415 void wxEvtHandler::DoSetClientData( void *data )
1416 {
1417     wxASSERT_MSG( m_clientDataType != wxClientData_Object,
1418                   wxT("can't have both object and void client data") );
1419
1420     m_clientData = data;
1421     m_clientDataType = wxClientData_Void;
1422 }
1423
1424 void *wxEvtHandler::DoGetClientData() const
1425 {
1426     // it's not an error to call GetClientData() on a window which doesn't have
1427     // client data at all - NULL will be returned
1428     wxASSERT_MSG( m_clientDataType != wxClientData_Object,
1429                   wxT("this window doesn't have void client data") );
1430
1431     return m_clientData;
1432 }
1433
1434 #endif // wxUSE_BASE
1435
1436 #if wxUSE_GUI
1437
1438 // Find a window with the focus, that is also a descendant of the given window.
1439 // This is used to determine the window to initially send commands to.
1440 wxWindow* wxFindFocusDescendant(wxWindow* ancestor)
1441 {
1442     // Process events starting with the window with the focus, if any.
1443     wxWindow* focusWin = wxWindow::FindFocus();
1444     wxWindow* win = focusWin;
1445
1446     // Check if this is a descendant of this frame.
1447     // If not, win will be set to NULL.
1448     while (win)
1449     {
1450         if (win == ancestor)
1451             break;
1452         else
1453             win = win->GetParent();
1454     }
1455     if (win == (wxWindow*) NULL)
1456         focusWin = (wxWindow*) NULL;
1457
1458     return focusWin;
1459 }
1460
1461 #endif // wxUSE_GUI