src/common/event.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        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 and Markus Holzem
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 // ============================================================================
  13 // declarations
  14 // ============================================================================
  15
  16 // ----------------------------------------------------------------------------
  17 // headers
  18 // ----------------------------------------------------------------------------
  19
  20 #ifdef __GNUG__
  21     #pragma implementation "event.h"
  22 #endif
  23
  24 // For compilers that support precompilation, includes "wx.h".
  25 #include "wx/wxprec.h"
  26
  27 #ifdef __BORLANDC__
  28     #pragma hdrstop
  29 #endif
  30
  31 #ifndef WX_PRECOMP
  32     #include "wx/defs.h"
  33     #include "wx/app.h"
  34     #include "wx/list.h"
  35
  36     #if wxUSE_GUI
  37         #include "wx/control.h"
  38         #include "wx/utils.h"
  39         #include "wx/dc.h"
  40     #endif // wxUSE_GUI
  41 #endif
  42
  43 #include "wx/event.h"
  44
  45 #if wxUSE_GUI
  46     #include "wx/validate.h"
  47 #endif // wxUSE_GUI
  48
  49 // ----------------------------------------------------------------------------
  50 // wxWin macros
  51 // ----------------------------------------------------------------------------
  52
  53 IMPLEMENT_DYNAMIC_CLASS(wxEvtHandler, wxObject)
  54 IMPLEMENT_ABSTRACT_CLASS(wxEvent, wxObject)
  55
  56 #if wxUSE_GUI
  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 #endif // wxUSE_GUI
  92
  93 const wxEventTable *wxEvtHandler::GetEventTable() const
  94     { return &wxEvtHandler::sm_eventTable; }
  95
  96 const wxEventTable wxEvtHandler::sm_eventTable =
  97     { (const wxEventTable *)NULL, &wxEvtHandler::sm_eventTableEntries[0] };
  98
  99 const wxEventTableEntry wxEvtHandler::sm_eventTableEntries[] =
 100     { DECLARE_EVENT_TABLE_ENTRY(wxEVT_NULL, 0, 0, (wxObjectEventFunction)NULL, NULL) };
 101
 102 // ----------------------------------------------------------------------------
 103 // global variables
 104 // ----------------------------------------------------------------------------
 105
 106 // To put pending event handlers
 107 wxList *wxPendingEvents = (wxList *)NULL;
 108
 109 #if wxUSE_THREADS
 110     // protects wxPendingEvents list
 111     wxCriticalSection *wxPendingEventsLocker = (wxCriticalSection *)NULL;
 112 #endif
 113
 114 #if !WXWIN_COMPATIBILITY_EVENT_TYPES
 115
 116 // common event types are defined here, other event types are defined by the
 117 // components which use them
 118
 119 DEFINE_EVENT_TYPE(wxEVT_NULL)
 120 DEFINE_EVENT_TYPE(wxEVT_COMMAND_BUTTON_CLICKED)
 121 DEFINE_EVENT_TYPE(wxEVT_COMMAND_CHECKBOX_CLICKED)
 122 DEFINE_EVENT_TYPE(wxEVT_COMMAND_CHOICE_SELECTED)
 123 DEFINE_EVENT_TYPE(wxEVT_COMMAND_LISTBOX_SELECTED)
 124 DEFINE_EVENT_TYPE(wxEVT_COMMAND_LISTBOX_DOUBLECLICKED)
 125 DEFINE_EVENT_TYPE(wxEVT_COMMAND_CHECKLISTBOX_TOGGLED)
 126 DEFINE_EVENT_TYPE(wxEVT_COMMAND_MENU_SELECTED)
 127 DEFINE_EVENT_TYPE(wxEVT_COMMAND_SLIDER_UPDATED)
 128 DEFINE_EVENT_TYPE(wxEVT_COMMAND_RADIOBOX_SELECTED)
 129 DEFINE_EVENT_TYPE(wxEVT_COMMAND_RADIOBUTTON_SELECTED)
 130 DEFINE_EVENT_TYPE(wxEVT_COMMAND_SCROLLBAR_UPDATED)
 131 DEFINE_EVENT_TYPE(wxEVT_COMMAND_VLBOX_SELECTED)
 132 DEFINE_EVENT_TYPE(wxEVT_COMMAND_COMBOBOX_SELECTED)
 133 DEFINE_EVENT_TYPE(wxEVT_COMMAND_TOOL_RCLICKED)
 134 DEFINE_EVENT_TYPE(wxEVT_COMMAND_TOOL_ENTER)
 135 DEFINE_EVENT_TYPE(wxEVT_COMMAND_SPINCTRL_UPDATED)
 136
 137 // Sockets and timers send events, too
 138 DEFINE_EVENT_TYPE(wxEVT_SOCKET)
 139 DEFINE_EVENT_TYPE(wxEVT_TIMER)
 140
 141 // Mouse event types
 142 DEFINE_EVENT_TYPE(wxEVT_LEFT_DOWN)
 143 DEFINE_EVENT_TYPE(wxEVT_LEFT_UP)
 144 DEFINE_EVENT_TYPE(wxEVT_MIDDLE_DOWN)
 145 DEFINE_EVENT_TYPE(wxEVT_MIDDLE_UP)
 146 DEFINE_EVENT_TYPE(wxEVT_RIGHT_DOWN)
 147 DEFINE_EVENT_TYPE(wxEVT_RIGHT_UP)
 148 DEFINE_EVENT_TYPE(wxEVT_MOTION)
 149 DEFINE_EVENT_TYPE(wxEVT_ENTER_WINDOW)
 150 DEFINE_EVENT_TYPE(wxEVT_LEAVE_WINDOW)
 151 DEFINE_EVENT_TYPE(wxEVT_LEFT_DCLICK)
 152 DEFINE_EVENT_TYPE(wxEVT_MIDDLE_DCLICK)
 153 DEFINE_EVENT_TYPE(wxEVT_RIGHT_DCLICK)
 154 DEFINE_EVENT_TYPE(wxEVT_SET_FOCUS)
 155 DEFINE_EVENT_TYPE(wxEVT_KILL_FOCUS)
 156 DEFINE_EVENT_TYPE(wxEVT_CHILD_FOCUS)
 157 DEFINE_EVENT_TYPE(wxEVT_MOUSEWHEEL)
 158
 159 // Non-client mouse events
 160 DEFINE_EVENT_TYPE(wxEVT_NC_LEFT_DOWN)
 161 DEFINE_EVENT_TYPE(wxEVT_NC_LEFT_UP)
 162 DEFINE_EVENT_TYPE(wxEVT_NC_MIDDLE_DOWN)
 163 DEFINE_EVENT_TYPE(wxEVT_NC_MIDDLE_UP)
 164 DEFINE_EVENT_TYPE(wxEVT_NC_RIGHT_DOWN)
 165 DEFINE_EVENT_TYPE(wxEVT_NC_RIGHT_UP)
 166 DEFINE_EVENT_TYPE(wxEVT_NC_MOTION)
 167 DEFINE_EVENT_TYPE(wxEVT_NC_ENTER_WINDOW)
 168 DEFINE_EVENT_TYPE(wxEVT_NC_LEAVE_WINDOW)
 169 DEFINE_EVENT_TYPE(wxEVT_NC_LEFT_DCLICK)
 170 DEFINE_EVENT_TYPE(wxEVT_NC_MIDDLE_DCLICK)
 171 DEFINE_EVENT_TYPE(wxEVT_NC_RIGHT_DCLICK)
 172
 173 // Character input event type
 174 DEFINE_EVENT_TYPE(wxEVT_CHAR)
 175 DEFINE_EVENT_TYPE(wxEVT_CHAR_HOOK)
 176 DEFINE_EVENT_TYPE(wxEVT_NAVIGATION_KEY)
 177 DEFINE_EVENT_TYPE(wxEVT_KEY_DOWN)
 178 DEFINE_EVENT_TYPE(wxEVT_KEY_UP)
 179
 180 // Set cursor event
 181 DEFINE_EVENT_TYPE(wxEVT_SET_CURSOR)
 182
 183 // wxScrollbar and wxSlider event identifiers
 184 DEFINE_EVENT_TYPE(wxEVT_SCROLL_TOP)
 185 DEFINE_EVENT_TYPE(wxEVT_SCROLL_BOTTOM)
 186 DEFINE_EVENT_TYPE(wxEVT_SCROLL_LINEUP)
 187 DEFINE_EVENT_TYPE(wxEVT_SCROLL_LINEDOWN)
 188 DEFINE_EVENT_TYPE(wxEVT_SCROLL_PAGEUP)
 189 DEFINE_EVENT_TYPE(wxEVT_SCROLL_PAGEDOWN)
 190 DEFINE_EVENT_TYPE(wxEVT_SCROLL_THUMBTRACK)
 191 DEFINE_EVENT_TYPE(wxEVT_SCROLL_THUMBRELEASE)
 192
 193 // Scroll events from wxWindow
 194 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_TOP)
 195 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_BOTTOM)
 196 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_LINEUP)
 197 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_LINEDOWN)
 198 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_PAGEUP)
 199 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_PAGEDOWN)
 200 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_THUMBTRACK)
 201 DEFINE_EVENT_TYPE(wxEVT_SCROLLWIN_THUMBRELEASE)
 202
 203 // System events
 204 DEFINE_EVENT_TYPE(wxEVT_SIZE)
 205 DEFINE_EVENT_TYPE(wxEVT_MOVE)
 206 DEFINE_EVENT_TYPE(wxEVT_CLOSE_WINDOW)
 207 DEFINE_EVENT_TYPE(wxEVT_END_SESSION)
 208 DEFINE_EVENT_TYPE(wxEVT_QUERY_END_SESSION)
 209 DEFINE_EVENT_TYPE(wxEVT_ACTIVATE_APP)
 210 DEFINE_EVENT_TYPE(wxEVT_POWER)
 211 DEFINE_EVENT_TYPE(wxEVT_ACTIVATE)
 212 DEFINE_EVENT_TYPE(wxEVT_CREATE)
 213 DEFINE_EVENT_TYPE(wxEVT_DESTROY)
 214 DEFINE_EVENT_TYPE(wxEVT_SHOW)
 215 DEFINE_EVENT_TYPE(wxEVT_ICONIZE)
 216 DEFINE_EVENT_TYPE(wxEVT_MAXIMIZE)
 217 DEFINE_EVENT_TYPE(wxEVT_MOUSE_CAPTURE_CHANGED)
 218 DEFINE_EVENT_TYPE(wxEVT_PAINT)
 219 DEFINE_EVENT_TYPE(wxEVT_ERASE_BACKGROUND)
 220 DEFINE_EVENT_TYPE(wxEVT_NC_PAINT)
 221 DEFINE_EVENT_TYPE(wxEVT_PAINT_ICON)
 222 DEFINE_EVENT_TYPE(wxEVT_MENU_CHAR)
 223 DEFINE_EVENT_TYPE(wxEVT_MENU_INIT)
 224 DEFINE_EVENT_TYPE(wxEVT_MENU_HIGHLIGHT)
 225 DEFINE_EVENT_TYPE(wxEVT_POPUP_MENU_INIT)
 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)
 243
 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)
 253
 254 // Help events
 255 DEFINE_EVENT_TYPE(wxEVT_HELP)
 256 DEFINE_EVENT_TYPE(wxEVT_DETAILED_HELP)
 257
 258 #endif // !WXWIN_COMPATIBILITY_EVENT_TYPES
 259
 260 // ============================================================================
 261 // implementation
 262 // ============================================================================
 263
 264 // ----------------------------------------------------------------------------
 265 // event initialization
 266 // ----------------------------------------------------------------------------
 267
 268 int wxNewEventType()
 269 {
 270     // MT-FIXME
 271     static int s_lastUsedEventType = wxEVT_FIRST;
 272
 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
 277     //
 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
 282
 283     return s_lastUsedEventType++;
 284 }
 285
 286 // ----------------------------------------------------------------------------
 287 // wxEvent
 288 // ----------------------------------------------------------------------------
 289
 290 /*
 291  * General wxWindows events, covering
 292  * all interesting things that might happen (button clicking, resizing,
 293  * setting text in widgets, etc.).
 294  *
 295  * For each completely new event type, derive a new event class.
 296  *
 297  */
 298
 299 wxEvent::wxEvent(int theId, wxEventType commandType )
 300 {
 301     m_eventType = commandType;
 302     m_eventObject = (wxObject *) NULL;
 303     m_timeStamp = 0;
 304     m_id = theId;
 305     m_skipped = FALSE;
 306     m_callbackUserData = (wxObject *) NULL;
 307     m_isCommandEvent = FALSE;
 308 }
 309
 310 wxEvent::wxEvent(const wxEvent &src)
 311 {
 312     m_eventType = src.m_eventType;
 313     m_eventObject = src.m_eventObject;
 314     m_timeStamp = src.m_timeStamp;
 315     m_id = src.m_id;
 316     m_skipped = src.m_skipped;
 317     m_callbackUserData = src.m_callbackUserData;
 318     m_isCommandEvent = src.m_isCommandEvent;
 319 }
 320
 321 #if wxUSE_GUI
 322
 323 /*
 324  * Command events
 325  *
 326  */
 327
 328 wxCommandEvent::wxCommandEvent(wxEventType commandType, int theId)
 329   : wxEvent( theId, commandType )
 330 {
 331     m_clientData = (char *) NULL;
 332     m_clientObject = (wxClientData *) NULL;
 333     m_extraLong = 0;
 334     m_commandInt = 0;
 335     m_commandString = wxEmptyString;
 336     m_isCommandEvent = TRUE;
 337 }
 338
 339 /*
 340  * Scroll events
 341  */
 342
 343 wxScrollEvent::wxScrollEvent(wxEventType commandType,
 344                              int id,
 345                              int pos,
 346                              int orient)
 347              : wxCommandEvent(commandType, id)
 348 {
 349     m_extraLong = orient;
 350     m_commandInt = pos;
 351 }
 352
 353 /*
 354  * ScrollWin events
 355  */
 356
 357 wxScrollWinEvent::wxScrollWinEvent(wxEventType commandType,
 358                                    int pos,
 359                                    int orient)
 360 {
 361     m_eventType = commandType;
 362     m_extraLong = orient;
 363     m_commandInt = pos;
 364 }
 365
 366 /*
 367  * Mouse events
 368  *
 369  */
 370
 371 wxMouseEvent::wxMouseEvent(wxEventType commandType)
 372 {
 373     m_eventType = commandType;
 374     m_metaDown = FALSE;
 375     m_altDown = FALSE;
 376     m_controlDown = FALSE;
 377     m_shiftDown = FALSE;
 378     m_leftDown = FALSE;
 379     m_rightDown = FALSE;
 380     m_middleDown = FALSE;
 381     m_x = 0;
 382     m_y = 0;
 383     m_wheelRotation = 0;
 384     m_wheelDelta = 0;
 385     m_linesPerAction = 0;
 386 }
 387
 388 // True if was a button dclick event (1 = left, 2 = middle, 3 = right)
 389 // or any button dclick event (but = -1)
 390 bool wxMouseEvent::ButtonDClick(int but) const
 391 {
 392     switch (but)
 393     {
 394         case -1:
 395             return (LeftDClick() || MiddleDClick() || RightDClick());
 396         case 1:
 397             return LeftDClick();
 398         case 2:
 399             return MiddleDClick();
 400         case 3:
 401             return RightDClick();
 402         default:
 403             wxFAIL_MSG(wxT("invalid parameter in wxMouseEvent::ButtonDClick"));
 404     }
 405
 406     return FALSE;
 407 }
 408
 409 // True if was a button down event (1 = left, 2 = middle, 3 = right)
 410 // or any button down event (but = -1)
 411 bool wxMouseEvent::ButtonDown(int but) const
 412 {
 413     switch (but)
 414     {
 415         case -1:
 416             return (LeftDown() || MiddleDown() || RightDown());
 417         case 1:
 418             return LeftDown();
 419         case 2:
 420             return MiddleDown();
 421         case 3:
 422             return RightDown();
 423         default:
 424             wxFAIL_MSG(wxT("invalid parameter in wxMouseEvent::ButtonDown"));
 425     }
 426
 427     return FALSE;
 428 }
 429
 430 // True if was a button up event (1 = left, 2 = middle, 3 = right)
 431 // or any button up event (but = -1)
 432 bool wxMouseEvent::ButtonUp(int but) const
 433 {
 434     switch (but)
 435     {
 436         case -1:
 437             return (LeftUp() || MiddleUp() || RightUp());
 438         case 1:
 439             return LeftUp();
 440         case 2:
 441             return MiddleUp();
 442         case 3:
 443             return RightUp();
 444         default:
 445             wxFAIL_MSG(wxT("invalid parameter in wxMouseEvent::ButtonUp"));
 446     }
 447
 448     return FALSE;
 449 }
 450
 451 // True if the given button is currently changing state
 452 bool wxMouseEvent::Button(int but) const
 453 {
 454     switch (but)
 455     {
 456         case -1:
 457             return (ButtonUp(-1) || ButtonDown(-1) || ButtonDClick(-1));
 458         case 1:
 459             return (LeftDown() || LeftUp() || LeftDClick());
 460         case 2:
 461             return (MiddleDown() || MiddleUp() || MiddleDClick());
 462         case 3:
 463             return (RightDown() || RightUp() || RightDClick());
 464         default:
 465             wxFAIL_MSG(wxT("invalid parameter in wxMouseEvent::Button"));
 466     }
 467
 468     return FALSE;
 469 }
 470
 471 bool wxMouseEvent::ButtonIsDown(int but) const
 472 {
 473     switch (but)
 474     {
 475         case -1:
 476             return (LeftIsDown() || MiddleIsDown() || RightIsDown());
 477         case 1:
 478             return LeftIsDown();
 479         case 2:
 480             return MiddleIsDown();
 481         case 3:
 482             return RightIsDown();
 483         default:
 484             wxFAIL_MSG(wxT("invalid parameter in wxMouseEvent::ButtonIsDown"));
 485     }
 486
 487     return FALSE;
 488 }
 489
 490 int wxMouseEvent::GetButton() const
 491 {
 492     for ( int i = 1; i <= 3; i++ )
 493     {
 494         if ( Button(i) )
 495         {
 496             return i;
 497         }
 498     }
 499
 500     return -1;
 501 }
 502
 503 // Find the logical position of the event given the DC
 504 wxPoint wxMouseEvent::GetLogicalPosition(const wxDC& dc) const
 505 {
 506     wxPoint pt(dc.DeviceToLogicalX(m_x), dc.DeviceToLogicalY(m_y));
 507     return pt;
 508 }
 509
 510
 511 /*
 512  * Keyboard event
 513  *
 514  */
 515
 516 wxKeyEvent::wxKeyEvent(wxEventType type)
 517 {
 518     m_eventType = type;
 519     m_shiftDown = FALSE;
 520     m_controlDown = FALSE;
 521     m_metaDown = FALSE;
 522     m_altDown = FALSE;
 523     m_keyCode = 0;
 524     m_scanCode = 0;
 525 }
 526
 527
 528 wxWindowCreateEvent::wxWindowCreateEvent(wxWindow *win)
 529 {
 530     SetEventType(wxEVT_CREATE);
 531     SetEventObject(win);
 532 }
 533
 534 wxWindowDestroyEvent::wxWindowDestroyEvent(wxWindow *win)
 535 {
 536     SetEventType(wxEVT_DESTROY);
 537     SetEventObject(win);
 538 }
 539
 540 wxChildFocusEvent::wxChildFocusEvent(wxWindow *win)
 541                  : wxCommandEvent(wxEVT_CHILD_FOCUS)
 542 {
 543     SetEventObject(win);
 544 }
 545
 546 #endif // wxUSE_GUI
 547
 548 // ----------------------------------------------------------------------------
 549 // wxEvtHandler
 550 // ----------------------------------------------------------------------------
 551
 552 /*
 553  * Event handler
 554  */
 555
 556 wxEvtHandler::wxEvtHandler()
 557 {
 558     m_nextHandler = (wxEvtHandler *) NULL;
 559     m_previousHandler = (wxEvtHandler *) NULL;
 560     m_enabled = TRUE;
 561     m_dynamicEvents = (wxList *) NULL;
 562     m_isWindow = FALSE;
 563     m_pendingEvents = (wxList *) NULL;
 564 #if wxUSE_THREADS
 565 #  if !defined(__VISAGECPP__)
 566     m_eventsLocker = new wxCriticalSection;
 567 #  endif
 568 #endif
 569     // no client data (yet)
 570     m_clientData = NULL;
 571     m_clientDataType = wxClientData_None;
 572 }
 573
 574 wxEvtHandler::~wxEvtHandler()
 575 {
 576     // Takes itself out of the list of handlers
 577     if (m_previousHandler)
 578         m_previousHandler->m_nextHandler = m_nextHandler;
 579
 580     if (m_nextHandler)
 581         m_nextHandler->m_previousHandler = m_previousHandler;
 582
 583     if (m_dynamicEvents)
 584     {
 585         wxNode *node = m_dynamicEvents->First();
 586         while (node)
 587         {
 588 #if WXWIN_COMPATIBILITY_EVENT_TYPES
 589             wxEventTableEntry *entry = (wxEventTableEntry*)node->Data();
 590 #else // !WXWIN_COMPATIBILITY_EVENT_TYPES
 591             wxDynamicEventTableEntry *entry = (wxDynamicEventTableEntry*)node->Data();
 592 #endif // WXWIN_COMPATIBILITY_EVENT_TYPES/!WXWIN_COMPATIBILITY_EVENT_TYPES
 593
 594             if (entry->m_callbackUserData)
 595                 delete entry->m_callbackUserData;
 596             delete entry;
 597             node = node->Next();
 598         }
 599         delete m_dynamicEvents;
 600     };
 601
 602     delete m_pendingEvents;
 603
 604 #if wxUSE_THREADS
 605 #  if !defined(__VISAGECPP__)
 606     delete m_eventsLocker;
 607 #  endif
 608 #endif
 609
 610     // we only delete object data, not untyped
 611     if ( m_clientDataType == wxClientData_Object )
 612         delete m_clientObject;
 613 }
 614
 615 #if wxUSE_THREADS
 616
 617 bool wxEvtHandler::ProcessThreadEvent(wxEvent& event)
 618 {
 619     // check that we are really in a child thread
 620     wxASSERT_MSG( !wxThread::IsMain(),
 621                   wxT("use ProcessEvent() in main thread") );
 622
 623     AddPendingEvent(event);
 624
 625     return TRUE;
 626 }
 627
 628 #endif // wxUSE_THREADS
 629
 630 void wxEvtHandler::AddPendingEvent(wxEvent& event)
 631 {
 632     // 1) Add event to list of pending events of this event handler
 633
 634     wxEvent *eventCopy = event.Clone();
 635
 636     // we must be able to copy the events here so the event class must
 637     // implement Clone() properly instead of just providing a NULL stab for it
 638     wxCHECK_RET( eventCopy,
 639                  _T("events of this type aren't supposed to be posted") );
 640
 641 #if defined(__VISAGECPP__)
 642     wxENTER_CRIT_SECT( m_eventsLocker);
 643 #else
 644     wxENTER_CRIT_SECT( *m_eventsLocker);
 645 #endif
 646
 647     if ( !m_pendingEvents )
 648       m_pendingEvents = new wxList;
 649
 650     m_pendingEvents->Append(eventCopy);
 651
 652 #if defined(__VISAGECPP__)
 653     wxLEAVE_CRIT_SECT( m_eventsLocker);
 654 #else
 655     wxLEAVE_CRIT_SECT( *m_eventsLocker);
 656 #endif
 657
 658     // 2) Add this event handler to list of event handlers that
 659     //    have pending events.
 660
 661     wxENTER_CRIT_SECT(*wxPendingEventsLocker);
 662
 663     if ( !wxPendingEvents )
 664         wxPendingEvents = new wxList;
 665     wxPendingEvents->Append(this);
 666
 667     wxLEAVE_CRIT_SECT(*wxPendingEventsLocker);
 668
 669     // 3) Inform the system that new pending events are somwehere,
 670     //    and that these should be processed in idle time.
 671     wxWakeUpIdle();
 672 }
 673
 674 void wxEvtHandler::ProcessPendingEvents()
 675 {
 676 #if defined(__VISAGECPP__)
 677     wxENTER_CRIT_SECT( m_eventsLocker);
 678 #else
 679     wxENTER_CRIT_SECT( *m_eventsLocker);
 680 #endif
 681
 682     wxNode *node = m_pendingEvents->First();
 683     while ( node )
 684     {
 685         wxEvent *event = (wxEvent *)node->Data();
 686         delete node;
 687
 688         // In ProcessEvent, new events might get added and
 689         // we can safely leave the crtical section here.
 690 #if defined(__VISAGECPP__)
 691         wxLEAVE_CRIT_SECT( m_eventsLocker);
 692 #else
 693         wxLEAVE_CRIT_SECT( *m_eventsLocker);
 694 #endif
 695         ProcessEvent(*event);
 696         delete event;
 697 #if defined(__VISAGECPP__)
 698         wxENTER_CRIT_SECT( m_eventsLocker);
 699 #else
 700         wxENTER_CRIT_SECT( *m_eventsLocker);
 701 #endif
 702
 703         node = m_pendingEvents->First();
 704     }
 705
 706 #if defined(__VISAGECPP__)
 707     wxLEAVE_CRIT_SECT( m_eventsLocker);
 708 #else
 709     wxLEAVE_CRIT_SECT( *m_eventsLocker);
 710 #endif
 711 }
 712
 713 /*
 714  * Event table stuff
 715  */
 716
 717 bool wxEvtHandler::ProcessEvent(wxEvent& event)
 718 {
 719 #if wxUSE_GUI
 720
 721     // We have to use the actual window or processing events from
 722     // wxWindowNative destructor won't work (we don't see the wxWindow class)
 723 #ifdef __WXDEBUG__
 724     // check that our flag corresponds to reality
 725     wxClassInfo* info = NULL;
 726 #ifdef __WXUNIVERSAL__
 727 #  if defined(__WXMSW__)
 728     info = CLASSINFO(wxWindowMSW);
 729 #  elif defined(__WXGTK__)
 730     info = CLASSINFO(wxWindowGTK);
 731 #  elif defined(__WXMGL__)
 732     info = CLASSINFO(wxWindowMGL);
 733 #  elif defined(__WXPM__)
 734     info = CLASSINFO(wxWindowOS2);
 735 #  elif defined(__WXMAC__)
 736     info = CLASSINFO(wxWindowMac);
 737 #  elif defined(__WXMOTIF__)
 738     info = CLASSINFO(wxWindowMotif);
 739 #  endif
 740 #else
 741     info = CLASSINFO(wxWindow);
 742 #endif
 743
 744     wxASSERT_MSG( m_isWindow == IsKindOf(info),
 745                   wxString(GetClassInfo()->GetClassName()) + _T(" should [not] be a window but it is [not]") );
 746 #endif
 747
 748 #endif // wxUSE_GUI
 749
 750     // An event handler can be enabled or disabled
 751     if ( GetEvtHandlerEnabled() )
 752     {
 753
 754 #if 0
 755 /*
 756         What is this? When using GUI threads, a non main
 757         threads can send an event and process it itself.
 758         This breaks GTK's GUI threads, so please explain.
 759 */
 760
 761         // Check whether we are in a child thread.
 762         if ( !wxThread::IsMain() )
 763           return ProcessThreadEvent(event);
 764 #endif
 765
 766         // Handle per-instance dynamic event tables first
 767         if ( m_dynamicEvents && SearchDynamicEventTable(event) )
 768             return TRUE;
 769
 770         // Then static per-class event tables
 771         const wxEventTable *table = GetEventTable();
 772
 773 #if wxUSE_GUI && wxUSE_VALIDATORS
 774         // Try the associated validator first, if this is a window.
 775         // Problem: if the event handler of the window has been replaced,
 776         // this wxEvtHandler may no longer be a window.
 777         // Therefore validators won't be processed if the handler
 778         // has been replaced with SetEventHandler.
 779         // THIS CAN BE CURED if PushEventHandler is used instead of
 780         // SetEventHandler, and then processing will be passed down the
 781         // chain of event handlers.
 782         if (m_isWindow)
 783         {
 784             wxWindow *win = (wxWindow *)this;
 785
 786             // Can only use the validator of the window which
 787             // is receiving the event
 788             if ( win == event.GetEventObject() )
 789             {
 790                 wxValidator *validator = win->GetValidator();
 791                 if ( validator && validator->ProcessEvent(event) )
 792                 {
 793                     return TRUE;
 794                 }
 795             }
 796         }
 797 #endif
 798
 799         // Search upwards through the inheritance hierarchy
 800         while (table)
 801         {
 802             if ( SearchEventTable((wxEventTable&)*table, event) )
 803                 return TRUE;
 804             table = table->baseTable;
 805         }
 806     }
 807
 808     // Try going down the event handler chain
 809     if ( GetNextHandler() )
 810     {
 811         if ( GetNextHandler()->ProcessEvent(event) )
 812             return TRUE;
 813     }
 814
 815 #if wxUSE_GUI
 816     // Carry on up the parent-child hierarchy, but only if event is a command
 817     // event: it wouldn't make sense for a parent to receive a child's size
 818     // event, for example
 819     if ( m_isWindow && event.IsCommandEvent() )
 820     {
 821         wxWindow *win = (wxWindow *)this;
 822
 823         // honour the requests to stop propagation at this window: this is
 824         // used by the dialogs, for example, to prevent processing the events
 825         // from the dialog controls in the parent frame which rarely, if ever,
 826         // makes sense
 827         if ( !(win->GetExtraStyle() & wxWS_EX_BLOCK_EVENTS) )
 828         {
 829             wxWindow *parent = win->GetParent();
 830             if ( parent && !parent->IsBeingDeleted() )
 831                 return parent->GetEventHandler()->ProcessEvent(event);
 832         }
 833     }
 834 #endif // wxUSE_GUI
 835
 836     // Last try - application object.
 837     if ( wxTheApp && (this != wxTheApp) )
 838     {
 839         // Special case: don't pass wxEVT_IDLE to wxApp, since it'll always
 840         // swallow it. wxEVT_IDLE is sent explicitly to wxApp so it will be
 841         // processed appropriately via SearchEventTable.
 842         if ( event.GetEventType() != wxEVT_IDLE )
 843         {
 844             if ( wxTheApp->ProcessEvent(event) )
 845                 return TRUE;
 846         }
 847     }
 848
 849     return FALSE;
 850 }
 851
 852 bool wxEvtHandler::SearchEventTable(wxEventTable& table, wxEvent& event)
 853 {
 854     wxEventType eventType = event.GetEventType();
 855     int eventId = event.GetId();
 856
 857     // BC++ doesn't like testing for m_fn without != 0
 858     for ( int i = 0; table.entries[i].m_fn != 0; i++ )
 859     {
 860         // the line using reference exposes a bug in gcc: although it _seems_
 861         // to work, it leads to weird crashes later on during program
 862         // execution
 863 #ifdef __GNUG__
 864         wxEventTableEntry entry = table.entries[i];
 865 #else
 866         const wxEventTableEntry& entry = table.entries[i];
 867 #endif
 868
 869         // match only if the event type is the same and the id is either -1 in
 870         // the event table (meaning "any") or the event id matches the id
 871         // specified in the event table either exactly or by falling into
 872         // range between first and last
 873         if ( eventType == entry.m_eventType )
 874         {
 875             int tableId1 = entry.m_id,
 876                 tableId2 = entry.m_lastId;
 877
 878             if ( (tableId1 == -1) ||
 879                  (tableId2 == -1 && eventId == tableId1) ||
 880                  (tableId2 != -1 &&
 881                     (eventId >= tableId1 && eventId <= tableId2)) )
 882             {
 883                 event.Skip(FALSE);
 884                 event.m_callbackUserData = entry.m_callbackUserData;
 885
 886                 (this->*((wxEventFunction) (entry.m_fn)))(event);
 887
 888                 return !event.GetSkipped();
 889             }
 890         }
 891     }
 892
 893     return FALSE;
 894 }
 895
 896 void wxEvtHandler::Connect( int id, int lastId,
 897                             int eventType,
 898                             wxObjectEventFunction func,
 899                             wxObject *userData )
 900 {
 901 #if WXWIN_COMPATIBILITY_EVENT_TYPES
 902     wxEventTableEntry *entry = new wxEventTableEntry;
 903     entry->m_eventType = eventType;
 904     entry->m_id = id;
 905     entry->m_lastId = lastId;
 906     entry->m_fn = func;
 907     entry->m_callbackUserData = userData;
 908 #else // !WXWIN_COMPATIBILITY_EVENT_TYPES
 909     wxDynamicEventTableEntry *entry =
 910         new wxDynamicEventTableEntry(eventType, id, lastId, func, userData);
 911 #endif // WXWIN_COMPATIBILITY_EVENT_TYPES/!WXWIN_COMPATIBILITY_EVENT_TYPES
 912
 913     if (!m_dynamicEvents)
 914         m_dynamicEvents = new wxList;
 915
 916     m_dynamicEvents->Append( (wxObject*) entry );
 917 }
 918
 919 bool wxEvtHandler::Disconnect( int id, int lastId, wxEventType eventType,
 920                   wxObjectEventFunction func,
 921                   wxObject *userData )
 922 {
 923     if (!m_dynamicEvents)
 924         return FALSE;
 925
 926     wxNode *node = m_dynamicEvents->First();
 927     while (node)
 928     {
 929 #if WXWIN_COMPATIBILITY_EVENT_TYPES
 930             wxEventTableEntry *entry = (wxEventTableEntry*)node->Data();
 931 #else // !WXWIN_COMPATIBILITY_EVENT_TYPES
 932             wxDynamicEventTableEntry *entry = (wxDynamicEventTableEntry*)node->Data();
 933 #endif // WXWIN_COMPATIBILITY_EVENT_TYPES/!WXWIN_COMPATIBILITY_EVENT_TYPES
 934
 935         if ((entry->m_id == id) &&
 936             ((entry->m_lastId == lastId) || (lastId == -1)) &&
 937             ((entry->m_eventType == eventType) || (eventType == wxEVT_NULL)) &&
 938             ((entry->m_fn == func) || (func == (wxObjectEventFunction)NULL)) &&
 939             ((entry->m_callbackUserData == userData) || (userData == (wxObject*)NULL)))
 940         {
 941             if (entry->m_callbackUserData)
 942                 delete entry->m_callbackUserData;
 943             m_dynamicEvents->DeleteNode( node );
 944             delete entry;
 945             return TRUE;
 946         }
 947         node = node->Next();
 948     }
 949     return FALSE;
 950 }
 951
 952 bool wxEvtHandler::SearchDynamicEventTable( wxEvent& event )
 953 {
 954     wxCHECK_MSG( m_dynamicEvents, FALSE,
 955                  wxT("caller should check that we have dynamic events") );
 956
 957     int commandId = event.GetId();
 958
 959     wxNode *node = m_dynamicEvents->First();
 960     while (node)
 961     {
 962 #if WXWIN_COMPATIBILITY_EVENT_TYPES
 963             wxEventTableEntry *entry = (wxEventTableEntry*)node->Data();
 964 #else // !WXWIN_COMPATIBILITY_EVENT_TYPES
 965             wxDynamicEventTableEntry *entry = (wxDynamicEventTableEntry*)node->Data();
 966 #endif // WXWIN_COMPATIBILITY_EVENT_TYPES/!WXWIN_COMPATIBILITY_EVENT_TYPES
 967
 968         if (entry->m_fn)
 969         {
 970             // Match, if event spec says any id will do (id == -1)
 971             if ( (event.GetEventType() == entry->m_eventType) &&
 972                  (entry->m_id == -1 ||
 973                   (entry->m_lastId == -1 && commandId == entry->m_id) ||
 974                   (entry->m_lastId != -1 &&
 975                   (commandId >= entry->m_id && commandId <= entry->m_lastId))) )
 976             {
 977                 event.Skip(FALSE);
 978                 event.m_callbackUserData = entry->m_callbackUserData;
 979
 980                 (this->*((wxEventFunction) (entry->m_fn)))(event);
 981
 982                 if (event.GetSkipped())
 983                     return FALSE;
 984                 else
 985                     return TRUE;
 986             }
 987         }
 988         node = node->Next();
 989     }
 990     return FALSE;
 991 };
 992
 993 void wxEvtHandler::DoSetClientObject( wxClientData *data )
 994 {
 995     wxASSERT_MSG( m_clientDataType != wxClientData_Void,
 996                   wxT("can't have both object and void client data") );
 997
 998     if ( m_clientObject )
 999         delete m_clientObject;
1000
1001     m_clientObject = data;
1002     m_clientDataType = wxClientData_Object;
1003 }
1004
1005 wxClientData *wxEvtHandler::DoGetClientObject() const
1006 {
1007     // it's not an error to call GetClientObject() on a window which doesn't
1008     // have client data at all - NULL will be returned
1009     wxASSERT_MSG( m_clientDataType != wxClientData_Void,
1010                   wxT("this window doesn't have object client data") );
1011
1012     return m_clientObject;
1013 }
1014
1015 void wxEvtHandler::DoSetClientData( void *data )
1016 {
1017     wxASSERT_MSG( m_clientDataType != wxClientData_Object,
1018                   wxT("can't have both object and void client data") );
1019
1020     m_clientData = data;
1021     m_clientDataType = wxClientData_Void;
1022 }
1023
1024 void *wxEvtHandler::DoGetClientData() const
1025 {
1026     // it's not an error to call GetClientData() on a window which doesn't have
1027     // client data at all - NULL will be returned
1028     wxASSERT_MSG( m_clientDataType != wxClientData_Object,
1029                   wxT("this window doesn't have void client data") );
1030
1031     return m_clientData;
1032 }
1033
1034
1035 #if WXWIN_COMPATIBILITY
1036 bool wxEvtHandler::OnClose()
1037 {
1038     if (GetNextHandler())
1039         return GetNextHandler()->OnClose();
1040     else
1041         return FALSE;
1042 }
1043 #endif // WXWIN_COMPATIBILITY
1044
1045 #if wxUSE_GUI
1046
1047 // Find a window with the focus, that is also a descendant of the given window.
1048 // This is used to determine the window to initially send commands to.
1049 wxWindow* wxFindFocusDescendant(wxWindow* ancestor)
1050 {
1051     // Process events starting with the window with the focus, if any.
1052     wxWindow* focusWin = wxWindow::FindFocus();
1053     wxWindow* win = focusWin;
1054
1055     // Check if this is a descendant of this frame.
1056     // If not, win will be set to NULL.
1057     while (win)
1058     {
1059         if (win == ancestor)
1060             break;
1061         else
1062             win = win->GetParent();
1063     }
1064     if (win == (wxWindow*) NULL)
1065         focusWin = (wxWindow*) NULL;
1066
1067     return focusWin;
1068 }
1069
1070 #endif // wxUSE_GUI