]> git.saurik.com Git - wxWidgets.git/blobdiff - include/wx/event.h
Many bug fixes for display code:
[wxWidgets.git] / include / wx / event.h
index 900014b7d460fbd46d96d31e64b295a38a824c50..033cff7998ec1ab2a08c7a969ad7987414d50268 100644 (file)
@@ -44,6 +44,218 @@ class WXDLLEXPORT wxList;
 
 typedef int wxEventType;
 
 
 typedef int wxEventType;
 
+#if defined(__VISAGECPP__) && __IBMCPP__ >= 400
+// must define these static for VA or else you get multiply defined symbols everywhere
+extern const wxEventType wxEVT_NULL;
+extern const wxEventType wxEVT_FIRST;
+
+extern const wxEventType wxEVT_COMMAND_BUTTON_CLICKED;
+extern const wxEventType wxEVT_COMMAND_CHECKBOX_CLICKED;
+extern const wxEventType wxEVT_COMMAND_CHOICE_SELECTED;
+extern const wxEventType wxEVT_COMMAND_LISTBOX_SELECTED;
+extern const wxEventType wxEVT_COMMAND_LISTBOX_DOUBLECLICKED;
+extern const wxEventType wxEVT_COMMAND_CHECKLISTBOX_TOGGLED;
+extern const wxEventType wxEVT_COMMAND_TEXT_UPDATED;
+extern const wxEventType wxEVT_COMMAND_TEXT_ENTER;
+extern const wxEventType wxEVT_COMMAND_MENU_SELECTED;
+extern const wxEventType wxEVT_COMMAND_TOOL_CLICKED;
+extern const wxEventType wxEVT_COMMAND_SLIDER_UPDATED;
+extern const wxEventType wxEVT_COMMAND_RADIOBOX_SELECTED;
+extern const wxEventType wxEVT_COMMAND_RADIOBUTTON_SELECTED;
+extern const wxEventType wxEVT_COMMAND_SCROLLBAR_UPDATED;
+extern const wxEventType wxEVT_COMMAND_VLBOX_SELECTED;
+extern const wxEventType wxEVT_COMMAND_COMBOBOX_SELECTED;
+extern const wxEventType wxEVT_COMMAND_TOOL_RCLICKED;
+extern const wxEventType wxEVT_COMMAND_TOOL_ENTER;
+extern const wxEventType wxEVT_COMMAND_SPINCTRL_UPDATED;
+
+/* Sockets send events, too */
+extern const wxEventType wxEVT_SOCKET;
+
+/* Mouse event types */
+extern const wxEventType wxEVT_LEFT_DOWN;
+extern const wxEventType wxEVT_LEFT_UP;
+extern const wxEventType wxEVT_MIDDLE_DOWN;
+extern const wxEventType wxEVT_MIDDLE_UP;
+extern const wxEventType wxEVT_RIGHT_DOWN;
+extern const wxEventType wxEVT_RIGHT_UP;
+extern const wxEventType wxEVT_MOTION;
+extern const wxEventType wxEVT_ENTER_WINDOW;
+extern const wxEventType wxEVT_LEAVE_WINDOW;
+extern const wxEventType wxEVT_LEFT_DCLICK;
+extern const wxEventType wxEVT_MIDDLE_DCLICK;
+extern const wxEventType wxEVT_RIGHT_DCLICK;
+extern const wxEventType wxEVT_SET_FOCUS;
+extern const wxEventType wxEVT_KILL_FOCUS;
+
+ /* Non-client mouse events */
+extern const wxEventType wxEVT_NC_LEFT_DOWN;
+extern const wxEventType wxEVT_NC_LEFT_UP;
+extern const wxEventType wxEVT_NC_MIDDLE_DOWN;
+extern const wxEventType wxEVT_NC_MIDDLE_UP;
+extern const wxEventType wxEVT_NC_RIGHT_DOWN;
+extern const wxEventType wxEVT_NC_RIGHT_UP;
+extern const wxEventType wxEVT_NC_MOTION;
+extern const wxEventType wxEVT_NC_ENTER_WINDOW;
+extern const wxEventType wxEVT_NC_LEAVE_WINDOW;
+extern const wxEventType wxEVT_NC_LEFT_DCLICK;
+extern const wxEventType wxEVT_NC_MIDDLE_DCLICK;
+extern const wxEventType wxEVT_NC_RIGHT_DCLICK;
+
+/* Character input event type  */
+extern const wxEventType wxEVT_CHAR;
+extern const wxEventType wxEVT_CHAR_HOOK;
+extern const wxEventType wxEVT_NAVIGATION_KEY;
+extern const wxEventType wxEVT_KEY_DOWN;
+extern const wxEventType wxEVT_KEY_UP;
+
+ /*
+  * wxScrollbar and wxSlider event identifiers
+  */
+extern const wxEventType wxEVT_SCROLL_TOP;
+extern const wxEventType wxEVT_SCROLL_BOTTOM;
+extern const wxEventType wxEVT_SCROLL_LINEUP;
+extern const wxEventType wxEVT_SCROLL_LINEDOWN;
+extern const wxEventType wxEVT_SCROLL_PAGEUP;
+extern const wxEventType wxEVT_SCROLL_PAGEDOWN;
+extern const wxEventType wxEVT_SCROLL_THUMBTRACK;
+
+ /*
+  * Scroll events from wxWindow
+  */
+extern const wxEventType wxEVT_SCROLLWIN_TOP;
+extern const wxEventType wxEVT_SCROLLWIN_BOTTOM;
+extern const wxEventType wxEVT_SCROLLWIN_LINEUP;
+extern const wxEventType wxEVT_SCROLLWIN_LINEDOWN;
+extern const wxEventType wxEVT_SCROLLWIN_PAGEUP;
+extern const wxEventType wxEVT_SCROLLWIN_PAGEDOWN;
+extern const wxEventType wxEVT_SCROLLWIN_THUMBTRACK;
+
+ /*
+  * System events
+  */
+extern const wxEventType wxEVT_SIZE;
+extern const wxEventType wxEVT_MOVE;
+extern const wxEventType wxEVT_CLOSE_WINDOW;
+extern const wxEventType wxEVT_END_SESSION;
+extern const wxEventType wxEVT_QUERY_END_SESSION;
+extern const wxEventType wxEVT_ACTIVATE_APP;
+extern const wxEventType wxEVT_POWER;
+extern const wxEventType wxEVT_ACTIVATE;
+extern const wxEventType wxEVT_CREATE;
+extern const wxEventType wxEVT_DESTROY;
+extern const wxEventType wxEVT_SHOW;
+extern const wxEventType wxEVT_ICONIZE;
+extern const wxEventType wxEVT_MAXIMIZE;
+extern const wxEventType wxEVT_MOUSE_CAPTURE_CHANGED;
+extern const wxEventType wxEVT_PAINT;
+extern const wxEventType wxEVT_ERASE_BACKGROUND;
+extern const wxEventType wxEVT_NC_PAINT;
+extern const wxEventType wxEVT_PAINT_ICON;
+extern const wxEventType wxEVT_MENU_CHAR;
+extern const wxEventType wxEVT_MENU_INIT;
+extern const wxEventType wxEVT_MENU_HIGHLIGHT;
+extern const wxEventType wxEVT_POPUP_MENU_INIT;
+extern const wxEventType wxEVT_CONTEXT_MENU;
+extern const wxEventType wxEVT_SYS_COLOUR_CHANGED;
+extern const wxEventType wxEVT_SETTING_CHANGED;
+extern const wxEventType wxEVT_QUERY_NEW_PALETTE;
+extern const wxEventType wxEVT_PALETTE_CHANGED;
+extern const wxEventType wxEVT_JOY_BUTTON_DOWN;
+extern const wxEventType wxEVT_JOY_BUTTON_UP;
+extern const wxEventType wxEVT_JOY_MOVE;
+extern const wxEventType wxEVT_JOY_ZMOVE;
+extern const wxEventType wxEVT_DROP_FILES;
+extern const wxEventType wxEVT_DRAW_ITEM;
+extern const wxEventType wxEVT_MEASURE_ITEM;
+extern const wxEventType wxEVT_COMPARE_ITEM;
+extern const wxEventType wxEVT_INIT_DIALOG;
+extern const wxEventType wxEVT_IDLE;
+extern const wxEventType wxEVT_UPDATE_UI;
+
+ /* System misc. */
+extern const wxEventType wxEVT_END_PROCESS;
+
+ /* Dial up events */
+extern const wxEventType wxEVT_DIALUP_CONNECTED;
+extern const wxEventType wxEVT_DIALUP_DISCONNECTED;
+
+ /* Generic command events */
+ /* Note: a click is a higher-level event than button down/up */
+extern const wxEventType wxEVT_COMMAND_LEFT_CLICK;
+extern const wxEventType wxEVT_COMMAND_LEFT_DCLICK;
+extern const wxEventType wxEVT_COMMAND_RIGHT_CLICK;
+extern const wxEventType wxEVT_COMMAND_RIGHT_DCLICK;
+extern const wxEventType wxEVT_COMMAND_SET_FOCUS;
+extern const wxEventType wxEVT_COMMAND_KILL_FOCUS;
+extern const wxEventType wxEVT_COMMAND_ENTER;
+
+ /* Tree control event types */
+extern const wxEventType wxEVT_COMMAND_TREE_BEGIN_DRAG;
+extern const wxEventType wxEVT_COMMAND_TREE_BEGIN_RDRAG;
+extern const wxEventType wxEVT_COMMAND_TREE_BEGIN_LABEL_EDIT;
+extern const wxEventType wxEVT_COMMAND_TREE_END_LABEL_EDIT;
+extern const wxEventType wxEVT_COMMAND_TREE_DELETE_ITEM;
+extern const wxEventType wxEVT_COMMAND_TREE_GET_INFO;
+extern const wxEventType wxEVT_COMMAND_TREE_SET_INFO;
+extern const wxEventType wxEVT_COMMAND_TREE_ITEM_EXPANDED;
+extern const wxEventType wxEVT_COMMAND_TREE_ITEM_EXPANDING;
+extern const wxEventType wxEVT_COMMAND_TREE_ITEM_COLLAPSED;
+extern const wxEventType wxEVT_COMMAND_TREE_ITEM_COLLAPSING;
+extern const wxEventType wxEVT_COMMAND_TREE_SEL_CHANGED;
+extern const wxEventType wxEVT_COMMAND_TREE_SEL_CHANGING;
+extern const wxEventType wxEVT_COMMAND_TREE_KEY_DOWN;
+extern const wxEventType wxEVT_COMMAND_TREE_ITEM_ACTIVATED;
+extern const wxEventType wxEVT_COMMAND_TREE_ITEM_RIGHT_CLICK;
+extern const wxEventType wxEVT_COMMAND_TREE_ITEM_MIDDLE_CLICK;
+
+ /* List control event types */
+extern const wxEventType wxEVT_COMMAND_LIST_BEGIN_DRAG;
+extern const wxEventType wxEVT_COMMAND_LIST_BEGIN_RDRAG;
+extern const wxEventType wxEVT_COMMAND_LIST_BEGIN_LABEL_EDIT;
+extern const wxEventType wxEVT_COMMAND_LIST_END_LABEL_EDIT;
+extern const wxEventType wxEVT_COMMAND_LIST_DELETE_ITEM;
+extern const wxEventType wxEVT_COMMAND_LIST_DELETE_ALL_ITEMS;
+extern const wxEventType wxEVT_COMMAND_LIST_GET_INFO;
+extern const wxEventType wxEVT_COMMAND_LIST_SET_INFO;
+extern const wxEventType wxEVT_COMMAND_LIST_ITEM_SELECTED;
+extern const wxEventType wxEVT_COMMAND_LIST_ITEM_DESELECTED;
+extern const wxEventType wxEVT_COMMAND_LIST_KEY_DOWN;
+extern const wxEventType wxEVT_COMMAND_LIST_INSERT_ITEM;
+extern const wxEventType wxEVT_COMMAND_LIST_COL_CLICK;
+extern const wxEventType wxEVT_COMMAND_LIST_ITEM_RIGHT_CLICK;
+extern const wxEventType wxEVT_COMMAND_LIST_ITEM_MIDDLE_CLICK;
+extern const wxEventType wxEVT_COMMAND_LIST_ITEM_ACTIVATED;
+
+ /* Tab and notebook control event types */
+extern const wxEventType wxEVT_COMMAND_TAB_SEL_CHANGED;
+extern const wxEventType wxEVT_COMMAND_TAB_SEL_CHANGING;
+extern const wxEventType wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGED;
+extern const wxEventType wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGING;
+
+/* Splitter events */
+extern const wxEventType wxEVT_COMMAND_SPLITTER_SASH_POS_CHANGED;
+extern const wxEventType wxEVT_COMMAND_SPLITTER_SASH_POS_CHANGING;
+extern const wxEventType wxEVT_COMMAND_SPLITTER_DOUBLECLICKED;
+extern const wxEventType wxEVT_COMMAND_SPLITTER_UNSPLIT;
+
+/* Wizard events */
+extern const wxEventType wxEVT_WIZARD_PAGE_CHANGED;
+extern const wxEventType wxEVT_WIZARD_PAGE_CHANGING;
+extern const wxEventType wxEVT_WIZARD_CANCEL;
+
+/* Calendar events */
+extern const wxEventType wxEVT_CALENDAR_SEL_CHANGED;
+extern const wxEventType wxEVT_CALENDAR_DAY_CHANGED;
+extern const wxEventType wxEVT_CALENDAR_MONTH_CHANGED;
+extern const wxEventType wxEVT_CALENDAR_YEAR_CHANGED;
+extern const wxEventType wxEVT_CALENDAR_DOUBLECLICKED;
+extern const wxEventType wxEVT_CALENDAR_WEEKDAY_CLICKED;
+
+extern const wxEventType wxEVT_USER_FIRST;
+
+#else // everybody else
+
 const wxEventType wxEVT_NULL = 0;
 const wxEventType wxEVT_FIRST = 10000;
 
 const wxEventType wxEVT_NULL = 0;
 const wxEventType wxEVT_FIRST = 10000;
 
@@ -250,7 +462,17 @@ const wxEventType wxEVT_WIZARD_PAGE_CHANGED = wxEVT_FIRST + 900;
 const wxEventType wxEVT_WIZARD_PAGE_CHANGING = wxEVT_FIRST + 901;
 const wxEventType wxEVT_WIZARD_CANCEL = wxEVT_FIRST + 902;
 
 const wxEventType wxEVT_WIZARD_PAGE_CHANGING = wxEVT_FIRST + 901;
 const wxEventType wxEVT_WIZARD_CANCEL = wxEVT_FIRST + 902;
 
-const wxEventType wxEVT_USER_FIRST =                        wxEVT_FIRST + 2000;
+/* Calendar events */
+const wxEventType wxEVT_CALENDAR_SEL_CHANGED = wxEVT_FIRST + 950;
+const wxEventType wxEVT_CALENDAR_DAY_CHANGED = wxEVT_FIRST + 951;
+const wxEventType wxEVT_CALENDAR_MONTH_CHANGED = wxEVT_FIRST + 952;
+const wxEventType wxEVT_CALENDAR_YEAR_CHANGED = wxEVT_FIRST + 953;
+const wxEventType wxEVT_CALENDAR_DOUBLECLICKED = wxEVT_FIRST + 954;
+const wxEventType wxEVT_CALENDAR_WEEKDAY_CLICKED = wxEVT_FIRST + 955;
+
+const wxEventType wxEVT_USER_FIRST = wxEVT_FIRST + 2000;
+
+#endif // for VisualAge C++ V4.0
 
 /* Compatibility */
 
 
 /* Compatibility */
 
@@ -436,6 +658,10 @@ public:
     // for implementation code only: is the operation allowed?
     bool IsAllowed() const { return m_bAllow; }
 
     // for implementation code only: is the operation allowed?
     bool IsAllowed() const { return m_bAllow; }
 
+    // probably useless: CopyObject() is used for deferred event
+    // handling but wxNotifyEvent must be processed immediately
+    void CopyObject(wxObject& obj) const;
+
 private:
     bool m_bAllow;
 
 private:
     bool m_bAllow;
 
@@ -470,8 +696,14 @@ public:
 
     int GetOrientation() const { return (int) m_extraLong ; }
     int GetPosition() const { return m_commandInt ; }
 
     int GetOrientation() const { return (int) m_extraLong ; }
     int GetPosition() const { return m_commandInt ; }
+    bool IsScrolling() const { return m_isScrolling; }
     void SetOrientation(int orient) { m_extraLong = (long) orient; }
     void SetPosition(int pos) { m_commandInt = pos; }
     void SetOrientation(int orient) { m_extraLong = (long) orient; }
     void SetPosition(int pos) { m_commandInt = pos; }
+    void SetScrolling(bool isScrolling) { m_isScrolling = isScrolling; }
+
+    void CopyObject(wxObject& obj) const;
+public:
+    bool m_isScrolling;
 };
 
 // ScrollWin event class, derived fom wxEvent. wxScrollWinEvents
 };
 
 // ScrollWin event class, derived fom wxEvent. wxScrollWinEvents
@@ -501,13 +733,16 @@ public:
 
     int GetOrientation() const { return (int) m_extraLong ; }
     int GetPosition() const { return m_commandInt ; }
 
     int GetOrientation() const { return (int) m_extraLong ; }
     int GetPosition() const { return m_commandInt ; }
+    bool IsScrolling() const { return m_isScrolling; }
     void SetOrientation(int orient) { m_extraLong = (long) orient; }
     void SetPosition(int pos) { m_commandInt = pos; }
     void SetOrientation(int orient) { m_extraLong = (long) orient; }
     void SetPosition(int pos) { m_commandInt = pos; }
+    void SetScrolling(bool isScrolling) { m_isScrolling = isScrolling; }
 
     void CopyObject(wxObject& object_dest) const;
 public:
     int               m_commandInt;    // Additional information
     long              m_extraLong;
 
     void CopyObject(wxObject& object_dest) const;
 public:
     int               m_commandInt;    // Additional information
     long              m_extraLong;
+    bool              m_isScrolling;
 };
 
 // Mouse event class
 };
 
 // Mouse event class
@@ -1227,27 +1462,56 @@ protected:
  Event generated by dialog navigation keys
  wxEVT_NAVIGATION_KEY
  */
  Event generated by dialog navigation keys
  wxEVT_NAVIGATION_KEY
  */
-// must derive from command event to be propagated to the parent
-class WXDLLEXPORT wxNavigationKeyEvent : public wxCommandEvent
+// NB: don't derive from command event to avoid being propagated to the parent
+class WXDLLEXPORT wxNavigationKeyEvent : public wxEvent
 {
 {
-    DECLARE_DYNAMIC_CLASS(wxNavigationKeyEvent)
-
 public:
 public:
-    wxNavigationKeyEvent() : wxCommandEvent(wxEVT_NAVIGATION_KEY) { }
+    wxNavigationKeyEvent()
+    {
+        SetEventType(wxEVT_NAVIGATION_KEY);
+
+        m_flags = IsForward | Propagate;    // defaults are for TAB
+        m_focus = (wxWindow *)NULL;
+    }
 
     // direction: forward (true) or backward (false)
 
     // direction: forward (true) or backward (false)
-    bool GetDirection() const        { return m_commandInt == 1; }
-    void SetDirection(bool bForward) { m_commandInt = bForward;  }
+    bool GetDirection() const
+        { return (m_flags & IsForward) != 0; }
+    void SetDirection(bool bForward)
+        { if ( bForward ) m_flags |= IsForward; else m_flags &= ~IsForward; }
 
     // it may be a window change event (MDI, notebook pages...) or a control
     // change event
 
     // it may be a window change event (MDI, notebook pages...) or a control
     // change event
-    bool IsWindowChange() const    { return m_extraLong == 1; }
-    void SetWindowChange(bool bIs) { m_extraLong = bIs; }
+    bool IsWindowChange() const
+        { return (m_flags & WinChange) != 0; }
+    void SetWindowChange(bool bIs)
+        { if ( bIs ) m_flags |= WinChange; else m_flags &= ~WinChange; }
+
+    // some navigation events are meant to be propagated upwards (Windows
+    // convention is to do this for TAB events) while others should always
+    // cycle inside the panel/radiobox/whatever we're current inside
+    bool ShouldPropagate() const
+        { return (m_flags & Propagate) != 0; }
+    void SetPropagate(bool bDoIt)
+        { if ( bDoIt ) m_flags |= Propagate; else m_flags &= ~Propagate; }
 
     // the child which has the focus currently (may be NULL - use
     // wxWindow::FindFocus then)
 
     // the child which has the focus currently (may be NULL - use
     // wxWindow::FindFocus then)
-    wxWindow* GetCurrentFocus() const { return (wxWindow *)m_clientData; }
-    void SetCurrentFocus(wxWindow *win) { m_clientData = (void *)win; }
+    wxWindow* GetCurrentFocus() const { return m_focus; }
+    void SetCurrentFocus(wxWindow *win) { m_focus = win; }
+
+private:
+    enum
+    {
+        IsForward = 0x0001,
+        WinChange = 0x0002,
+        Propagate = 0x0004
+    };
+
+    long m_flags;
+    wxWindow *m_focus;
+
+    DECLARE_DYNAMIC_CLASS(wxNavigationKeyEvent)
 };
 
 // Window creation/destruction events: the first is sent as soon as window is
 };
 
 // Window creation/destruction events: the first is sent as soon as window is
@@ -1650,7 +1914,6 @@ const wxEventTableEntry theClass::sm_eventTableEntries[] = { \
 #define EVT_TOOL_RCLICKED_RANGE(id1, id2, fn) { wxEVT_COMMAND_TOOL_RCLICKED, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
 #define EVT_TOOL_ENTER(id, fn) { wxEVT_COMMAND_TOOL_ENTER, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
 #define EVT_CHECKLISTBOX(id, fn) { wxEVT_COMMAND_CHECKLISTBOX_TOGGLED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
 #define EVT_TOOL_RCLICKED_RANGE(id1, id2, fn) { wxEVT_COMMAND_TOOL_RCLICKED, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
 #define EVT_TOOL_ENTER(id, fn) { wxEVT_COMMAND_TOOL_ENTER, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
 #define EVT_CHECKLISTBOX(id, fn) { wxEVT_COMMAND_CHECKLISTBOX_TOGGLED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
-#define EVT_SPINCTRL(id, fn) { wxEVT_COMMAND_SPINCTRL_UPDATED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
 
 // Generic command events
 #define EVT_COMMAND_LEFT_CLICK(id, fn) { wxEVT_COMMAND_LEFT_CLICK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },
 
 // Generic command events
 #define EVT_COMMAND_LEFT_CLICK(id, fn) { wxEVT_COMMAND_LEFT_CLICK, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL },