1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: SWIG interface for common event classes and event binders
7 // Created: 24-May-1998
9 // Copyright: (c) 2003 by Total Control Software
10 // Licence: wxWindows license
11 /////////////////////////////////////////////////////////////////////////////
16 //---------------------------------------------------------------------------
17 // Include some extra python code here
18 %pythoncode "_event_ex.py"
20 //---------------------------------------------------------------------------
23 // the predefined constants for the number of times we propagate event
24 // upwards window child-parent chain
25 enum Propagation_state
27 // don't propagate it at all
28 wxEVENT_PROPAGATE_NONE = 0,
30 // propagate it until it is processed
31 wxEVENT_PROPAGATE_MAX = INT_MAX
35 //---------------------------------------------------------------------------
38 wxEventType wxNewEventType();
41 %constant wxEventType wxEVT_NULL;
42 %constant wxEventType wxEVT_FIRST;
43 %constant wxEventType wxEVT_USER_FIRST;
45 %constant wxEventType wxEVT_COMMAND_BUTTON_CLICKED;
46 %constant wxEventType wxEVT_COMMAND_CHECKBOX_CLICKED;
47 %constant wxEventType wxEVT_COMMAND_CHOICE_SELECTED;
48 %constant wxEventType wxEVT_COMMAND_LISTBOX_SELECTED;
49 %constant wxEventType wxEVT_COMMAND_LISTBOX_DOUBLECLICKED;
50 %constant wxEventType wxEVT_COMMAND_CHECKLISTBOX_TOGGLED;
52 %constant wxEventType wxEVT_COMMAND_MENU_SELECTED;
53 %constant wxEventType wxEVT_COMMAND_TOOL_CLICKED;
54 %constant wxEventType wxEVT_COMMAND_SLIDER_UPDATED;
55 %constant wxEventType wxEVT_COMMAND_RADIOBOX_SELECTED;
56 %constant wxEventType wxEVT_COMMAND_RADIOBUTTON_SELECTED;
58 %constant wxEventType wxEVT_COMMAND_SCROLLBAR_UPDATED;
59 %constant wxEventType wxEVT_COMMAND_VLBOX_SELECTED;
60 %constant wxEventType wxEVT_COMMAND_COMBOBOX_SELECTED;
61 %constant wxEventType wxEVT_COMMAND_TOOL_RCLICKED;
62 %constant wxEventType wxEVT_COMMAND_TOOL_ENTER;
65 %constant wxEventType wxEVT_LEFT_DOWN;
66 %constant wxEventType wxEVT_LEFT_UP;
67 %constant wxEventType wxEVT_MIDDLE_DOWN;
68 %constant wxEventType wxEVT_MIDDLE_UP;
69 %constant wxEventType wxEVT_RIGHT_DOWN;
70 %constant wxEventType wxEVT_RIGHT_UP;
71 %constant wxEventType wxEVT_MOTION;
72 %constant wxEventType wxEVT_ENTER_WINDOW;
73 %constant wxEventType wxEVT_LEAVE_WINDOW;
74 %constant wxEventType wxEVT_LEFT_DCLICK;
75 %constant wxEventType wxEVT_MIDDLE_DCLICK;
76 %constant wxEventType wxEVT_RIGHT_DCLICK;
77 %constant wxEventType wxEVT_SET_FOCUS;
78 %constant wxEventType wxEVT_KILL_FOCUS;
79 %constant wxEventType wxEVT_CHILD_FOCUS;
80 %constant wxEventType wxEVT_MOUSEWHEEL;
82 // Non-client mouse events
83 %constant wxEventType wxEVT_NC_LEFT_DOWN;
84 %constant wxEventType wxEVT_NC_LEFT_UP;
85 %constant wxEventType wxEVT_NC_MIDDLE_DOWN;
86 %constant wxEventType wxEVT_NC_MIDDLE_UP;
87 %constant wxEventType wxEVT_NC_RIGHT_DOWN;
88 %constant wxEventType wxEVT_NC_RIGHT_UP;
89 %constant wxEventType wxEVT_NC_MOTION;
90 %constant wxEventType wxEVT_NC_ENTER_WINDOW;
91 %constant wxEventType wxEVT_NC_LEAVE_WINDOW;
92 %constant wxEventType wxEVT_NC_LEFT_DCLICK;
93 %constant wxEventType wxEVT_NC_MIDDLE_DCLICK;
94 %constant wxEventType wxEVT_NC_RIGHT_DCLICK;
96 // Character input event type
97 %constant wxEventType wxEVT_CHAR;
98 %constant wxEventType wxEVT_CHAR_HOOK;
99 %constant wxEventType wxEVT_NAVIGATION_KEY;
100 %constant wxEventType wxEVT_KEY_DOWN;
101 %constant wxEventType wxEVT_KEY_UP;
102 %constant wxEventType wxEVT_HOTKEY;
105 %constant wxEventType wxEVT_SET_CURSOR;
107 // wxScrollBar and wxSlider event identifiers
108 %constant wxEventType wxEVT_SCROLL_TOP;
109 %constant wxEventType wxEVT_SCROLL_BOTTOM;
110 %constant wxEventType wxEVT_SCROLL_LINEUP;
111 %constant wxEventType wxEVT_SCROLL_LINEDOWN;
112 %constant wxEventType wxEVT_SCROLL_PAGEUP;
113 %constant wxEventType wxEVT_SCROLL_PAGEDOWN;
114 %constant wxEventType wxEVT_SCROLL_THUMBTRACK;
115 %constant wxEventType wxEVT_SCROLL_THUMBRELEASE;
116 %constant wxEventType wxEVT_SCROLL_ENDSCROLL;
118 // Scroll events from wxWindow
119 %constant wxEventType wxEVT_SCROLLWIN_TOP;
120 %constant wxEventType wxEVT_SCROLLWIN_BOTTOM;
121 %constant wxEventType wxEVT_SCROLLWIN_LINEUP;
122 %constant wxEventType wxEVT_SCROLLWIN_LINEDOWN;
123 %constant wxEventType wxEVT_SCROLLWIN_PAGEUP;
124 %constant wxEventType wxEVT_SCROLLWIN_PAGEDOWN;
125 %constant wxEventType wxEVT_SCROLLWIN_THUMBTRACK;
126 %constant wxEventType wxEVT_SCROLLWIN_THUMBRELEASE;
129 %constant wxEventType wxEVT_SIZE;
130 %constant wxEventType wxEVT_MOVE;
131 %constant wxEventType wxEVT_CLOSE_WINDOW;
132 %constant wxEventType wxEVT_END_SESSION;
133 %constant wxEventType wxEVT_QUERY_END_SESSION;
134 %constant wxEventType wxEVT_ACTIVATE_APP;
135 %constant wxEventType wxEVT_POWER;
136 %constant wxEventType wxEVT_ACTIVATE;
137 %constant wxEventType wxEVT_CREATE;
138 %constant wxEventType wxEVT_DESTROY;
139 %constant wxEventType wxEVT_SHOW;
140 %constant wxEventType wxEVT_ICONIZE;
141 %constant wxEventType wxEVT_MAXIMIZE;
142 %constant wxEventType wxEVT_MOUSE_CAPTURE_CHANGED;
143 %constant wxEventType wxEVT_PAINT;
144 %constant wxEventType wxEVT_ERASE_BACKGROUND;
145 %constant wxEventType wxEVT_NC_PAINT;
146 %constant wxEventType wxEVT_PAINT_ICON;
147 %constant wxEventType wxEVT_MENU_OPEN;
148 %constant wxEventType wxEVT_MENU_CLOSE;
149 %constant wxEventType wxEVT_MENU_HIGHLIGHT;
151 %constant wxEventType wxEVT_CONTEXT_MENU;
152 %constant wxEventType wxEVT_SYS_COLOUR_CHANGED;
153 %constant wxEventType wxEVT_DISPLAY_CHANGED;
154 %constant wxEventType wxEVT_SETTING_CHANGED;
155 %constant wxEventType wxEVT_QUERY_NEW_PALETTE;
156 %constant wxEventType wxEVT_PALETTE_CHANGED;
157 %constant wxEventType wxEVT_DROP_FILES;
158 %constant wxEventType wxEVT_DRAW_ITEM;
159 %constant wxEventType wxEVT_MEASURE_ITEM;
160 %constant wxEventType wxEVT_COMPARE_ITEM;
161 %constant wxEventType wxEVT_INIT_DIALOG;
162 %constant wxEventType wxEVT_IDLE;
163 %constant wxEventType wxEVT_UPDATE_UI;
164 %constant wxEventType wxEVT_SIZING;
165 %constant wxEventType wxEVT_MOVING;
167 // Generic command events
168 // Note: a click is a higher-level event than button down/up
169 %constant wxEventType wxEVT_COMMAND_LEFT_CLICK;
170 %constant wxEventType wxEVT_COMMAND_LEFT_DCLICK;
171 %constant wxEventType wxEVT_COMMAND_RIGHT_CLICK;
172 %constant wxEventType wxEVT_COMMAND_RIGHT_DCLICK;
173 %constant wxEventType wxEVT_COMMAND_SET_FOCUS;
174 %constant wxEventType wxEVT_COMMAND_KILL_FOCUS;
175 %constant wxEventType wxEVT_COMMAND_ENTER;
181 %# Create some event binders
182 EVT_SIZE = wx.PyEventBinder( wxEVT_SIZE )
183 EVT_SIZING = wx.PyEventBinder( wxEVT_SIZING )
184 EVT_MOVE = wx.PyEventBinder( wxEVT_MOVE )
185 EVT_MOVING = wx.PyEventBinder( wxEVT_MOVING )
186 EVT_CLOSE = wx.PyEventBinder( wxEVT_CLOSE_WINDOW )
187 EVT_END_SESSION = wx.PyEventBinder( wxEVT_END_SESSION )
188 EVT_QUERY_END_SESSION = wx.PyEventBinder( wxEVT_QUERY_END_SESSION )
189 EVT_PAINT = wx.PyEventBinder( wxEVT_PAINT )
190 EVT_NC_PAINT = wx.PyEventBinder( wxEVT_NC_PAINT )
191 EVT_ERASE_BACKGROUND = wx.PyEventBinder( wxEVT_ERASE_BACKGROUND )
192 EVT_CHAR = wx.PyEventBinder( wxEVT_CHAR )
193 EVT_KEY_DOWN = wx.PyEventBinder( wxEVT_KEY_DOWN )
194 EVT_KEY_UP = wx.PyEventBinder( wxEVT_KEY_UP )
195 EVT_HOTKEY = wx.PyEventBinder( wxEVT_HOTKEY, 1)
196 EVT_CHAR_HOOK = wx.PyEventBinder( wxEVT_CHAR_HOOK )
197 EVT_MENU_OPEN = wx.PyEventBinder( wxEVT_MENU_OPEN )
198 EVT_MENU_CLOSE = wx.PyEventBinder( wxEVT_MENU_CLOSE )
199 EVT_MENU_HIGHLIGHT = wx.PyEventBinder( wxEVT_MENU_HIGHLIGHT, 1)
200 EVT_MENU_HIGHLIGHT_ALL = wx.PyEventBinder( wxEVT_MENU_HIGHLIGHT )
201 EVT_SET_FOCUS = wx.PyEventBinder( wxEVT_SET_FOCUS )
202 EVT_KILL_FOCUS = wx.PyEventBinder( wxEVT_KILL_FOCUS )
203 EVT_CHILD_FOCUS = wx.PyEventBinder( wxEVT_CHILD_FOCUS )
204 EVT_ACTIVATE = wx.PyEventBinder( wxEVT_ACTIVATE )
205 EVT_ACTIVATE_APP = wx.PyEventBinder( wxEVT_ACTIVATE_APP )
206 EVT_END_SESSION = wx.PyEventBinder( wxEVT_END_SESSION )
207 EVT_QUERY_END_SESSION = wx.PyEventBinder( wxEVT_QUERY_END_SESSION )
208 EVT_DROP_FILES = wx.PyEventBinder( wxEVT_DROP_FILES )
209 EVT_INIT_DIALOG = wx.PyEventBinder( wxEVT_INIT_DIALOG )
210 EVT_SYS_COLOUR_CHANGED = wx.PyEventBinder( wxEVT_SYS_COLOUR_CHANGED )
211 EVT_DISPLAY_CHANGED = wx.PyEventBinder( wxEVT_DISPLAY_CHANGED )
212 EVT_SHOW = wx.PyEventBinder( wxEVT_SHOW )
213 EVT_MAXIMIZE = wx.PyEventBinder( wxEVT_MAXIMIZE )
214 EVT_ICONIZE = wx.PyEventBinder( wxEVT_ICONIZE )
215 EVT_NAVIGATION_KEY = wx.PyEventBinder( wxEVT_NAVIGATION_KEY )
216 EVT_PALETTE_CHANGED = wx.PyEventBinder( wxEVT_PALETTE_CHANGED )
217 EVT_QUERY_NEW_PALETTE = wx.PyEventBinder( wxEVT_QUERY_NEW_PALETTE )
218 EVT_WINDOW_CREATE = wx.PyEventBinder( wxEVT_CREATE )
219 EVT_WINDOW_DESTROY = wx.PyEventBinder( wxEVT_DESTROY )
220 EVT_SET_CURSOR = wx.PyEventBinder( wxEVT_SET_CURSOR )
221 EVT_MOUSE_CAPTURE_CHANGED = wx.PyEventBinder( wxEVT_MOUSE_CAPTURE_CHANGED )
223 EVT_LEFT_DOWN = wx.PyEventBinder( wxEVT_LEFT_DOWN )
224 EVT_LEFT_UP = wx.PyEventBinder( wxEVT_LEFT_UP )
225 EVT_MIDDLE_DOWN = wx.PyEventBinder( wxEVT_MIDDLE_DOWN )
226 EVT_MIDDLE_UP = wx.PyEventBinder( wxEVT_MIDDLE_UP )
227 EVT_RIGHT_DOWN = wx.PyEventBinder( wxEVT_RIGHT_DOWN )
228 EVT_RIGHT_UP = wx.PyEventBinder( wxEVT_RIGHT_UP )
229 EVT_MOTION = wx.PyEventBinder( wxEVT_MOTION )
230 EVT_LEFT_DCLICK = wx.PyEventBinder( wxEVT_LEFT_DCLICK )
231 EVT_MIDDLE_DCLICK = wx.PyEventBinder( wxEVT_MIDDLE_DCLICK )
232 EVT_RIGHT_DCLICK = wx.PyEventBinder( wxEVT_RIGHT_DCLICK )
233 EVT_LEAVE_WINDOW = wx.PyEventBinder( wxEVT_LEAVE_WINDOW )
234 EVT_ENTER_WINDOW = wx.PyEventBinder( wxEVT_ENTER_WINDOW )
235 EVT_MOUSEWHEEL = wx.PyEventBinder( wxEVT_MOUSEWHEEL )
237 EVT_MOUSE_EVENTS = wx.PyEventBinder([ wxEVT_LEFT_DOWN,
253 %# Scrolling from wxWindow (sent to wxScrolledWindow)
254 EVT_SCROLLWIN = wx.PyEventBinder([ wxEVT_SCROLLWIN_TOP,
255 wxEVT_SCROLLWIN_BOTTOM,
256 wxEVT_SCROLLWIN_LINEUP,
257 wxEVT_SCROLLWIN_LINEDOWN,
258 wxEVT_SCROLLWIN_PAGEUP,
259 wxEVT_SCROLLWIN_PAGEDOWN,
260 wxEVT_SCROLLWIN_THUMBTRACK,
261 wxEVT_SCROLLWIN_THUMBRELEASE,
264 EVT_SCROLLWIN_TOP = wx.PyEventBinder( wxEVT_SCROLLWIN_TOP )
265 EVT_SCROLLWIN_BOTTOM = wx.PyEventBinder( wxEVT_SCROLLWIN_BOTTOM )
266 EVT_SCROLLWIN_LINEUP = wx.PyEventBinder( wxEVT_SCROLLWIN_LINEUP )
267 EVT_SCROLLWIN_LINEDOWN = wx.PyEventBinder( wxEVT_SCROLLWIN_LINEDOWN )
268 EVT_SCROLLWIN_PAGEUP = wx.PyEventBinder( wxEVT_SCROLLWIN_PAGEUP )
269 EVT_SCROLLWIN_PAGEDOWN = wx.PyEventBinder( wxEVT_SCROLLWIN_PAGEDOWN )
270 EVT_SCROLLWIN_THUMBTRACK = wx.PyEventBinder( wxEVT_SCROLLWIN_THUMBTRACK )
271 EVT_SCROLLWIN_THUMBRELEASE = wx.PyEventBinder( wxEVT_SCROLLWIN_THUMBRELEASE )
273 %# Scrolling from wxSlider and wxScrollBar
274 EVT_SCROLL = wx.PyEventBinder([ wxEVT_SCROLL_TOP,
277 wxEVT_SCROLL_LINEDOWN,
279 wxEVT_SCROLL_PAGEDOWN,
280 wxEVT_SCROLL_THUMBTRACK,
281 wxEVT_SCROLL_THUMBRELEASE,
282 wxEVT_SCROLL_ENDSCROLL,
285 EVT_SCROLL_TOP = wx.PyEventBinder( wxEVT_SCROLL_TOP )
286 EVT_SCROLL_BOTTOM = wx.PyEventBinder( wxEVT_SCROLL_BOTTOM )
287 EVT_SCROLL_LINEUP = wx.PyEventBinder( wxEVT_SCROLL_LINEUP )
288 EVT_SCROLL_LINEDOWN = wx.PyEventBinder( wxEVT_SCROLL_LINEDOWN )
289 EVT_SCROLL_PAGEUP = wx.PyEventBinder( wxEVT_SCROLL_PAGEUP )
290 EVT_SCROLL_PAGEDOWN = wx.PyEventBinder( wxEVT_SCROLL_PAGEDOWN )
291 EVT_SCROLL_THUMBTRACK = wx.PyEventBinder( wxEVT_SCROLL_THUMBTRACK )
292 EVT_SCROLL_THUMBRELEASE = wx.PyEventBinder( wxEVT_SCROLL_THUMBRELEASE )
293 EVT_SCROLL_ENDSCROLL = wx.PyEventBinder( wxEVT_SCROLL_ENDSCROLL )
295 %# Scrolling from wxSlider and wxScrollBar, with an id
296 EVT_COMMAND_SCROLL = wx.PyEventBinder([ wxEVT_SCROLL_TOP,
299 wxEVT_SCROLL_LINEDOWN,
301 wxEVT_SCROLL_PAGEDOWN,
302 wxEVT_SCROLL_THUMBTRACK,
303 wxEVT_SCROLL_THUMBRELEASE,
304 wxEVT_SCROLL_ENDSCROLL,
307 EVT_COMMAND_SCROLL_TOP = wx.PyEventBinder( wxEVT_SCROLL_TOP, 1)
308 EVT_COMMAND_SCROLL_BOTTOM = wx.PyEventBinder( wxEVT_SCROLL_BOTTOM, 1)
309 EVT_COMMAND_SCROLL_LINEUP = wx.PyEventBinder( wxEVT_SCROLL_LINEUP, 1)
310 EVT_COMMAND_SCROLL_LINEDOWN = wx.PyEventBinder( wxEVT_SCROLL_LINEDOWN, 1)
311 EVT_COMMAND_SCROLL_PAGEUP = wx.PyEventBinder( wxEVT_SCROLL_PAGEUP, 1)
312 EVT_COMMAND_SCROLL_PAGEDOWN = wx.PyEventBinder( wxEVT_SCROLL_PAGEDOWN, 1)
313 EVT_COMMAND_SCROLL_THUMBTRACK = wx.PyEventBinder( wxEVT_SCROLL_THUMBTRACK, 1)
314 EVT_COMMAND_SCROLL_THUMBRELEASE = wx.PyEventBinder( wxEVT_SCROLL_THUMBRELEASE, 1)
315 EVT_COMMAND_SCROLL_ENDSCROLL = wx.PyEventBinder( wxEVT_SCROLL_ENDSCROLL, 1)
317 EVT_BUTTON = wx.PyEventBinder( wxEVT_COMMAND_BUTTON_CLICKED, 1)
318 EVT_CHECKBOX = wx.PyEventBinder( wxEVT_COMMAND_CHECKBOX_CLICKED, 1)
319 EVT_CHOICE = wx.PyEventBinder( wxEVT_COMMAND_CHOICE_SELECTED, 1)
320 EVT_LISTBOX = wx.PyEventBinder( wxEVT_COMMAND_LISTBOX_SELECTED, 1)
321 EVT_LISTBOX_DCLICK = wx.PyEventBinder( wxEVT_COMMAND_LISTBOX_DOUBLECLICKED, 1)
322 EVT_MENU = wx.PyEventBinder( wxEVT_COMMAND_MENU_SELECTED, 1)
323 EVT_MENU_RANGE = wx.PyEventBinder( wxEVT_COMMAND_MENU_SELECTED, 2)
324 EVT_SLIDER = wx.PyEventBinder( wxEVT_COMMAND_SLIDER_UPDATED, 1)
325 EVT_RADIOBOX = wx.PyEventBinder( wxEVT_COMMAND_RADIOBOX_SELECTED, 1)
326 EVT_RADIOBUTTON = wx.PyEventBinder( wxEVT_COMMAND_RADIOBUTTON_SELECTED, 1)
328 EVT_SCROLLBAR = wx.PyEventBinder( wxEVT_COMMAND_SCROLLBAR_UPDATED, 1)
329 EVT_VLBOX = wx.PyEventBinder( wxEVT_COMMAND_VLBOX_SELECTED, 1)
330 EVT_COMBOBOX = wx.PyEventBinder( wxEVT_COMMAND_COMBOBOX_SELECTED, 1)
331 EVT_TOOL = wx.PyEventBinder( wxEVT_COMMAND_TOOL_CLICKED, 1)
332 EVT_TOOL_RANGE = wx.PyEventBinder( wxEVT_COMMAND_TOOL_CLICKED, 2)
333 EVT_TOOL_RCLICKED = wx.PyEventBinder( wxEVT_COMMAND_TOOL_RCLICKED, 1)
334 EVT_TOOL_RCLICKED_RANGE = wx.PyEventBinder( wxEVT_COMMAND_TOOL_RCLICKED, 2)
335 EVT_TOOL_ENTER = wx.PyEventBinder( wxEVT_COMMAND_TOOL_ENTER, 1)
336 EVT_CHECKLISTBOX = wx.PyEventBinder( wxEVT_COMMAND_CHECKLISTBOX_TOGGLED, 1)
339 EVT_COMMAND_LEFT_CLICK = wx.PyEventBinder( wxEVT_COMMAND_LEFT_CLICK, 1)
340 EVT_COMMAND_LEFT_DCLICK = wx.PyEventBinder( wxEVT_COMMAND_LEFT_DCLICK, 1)
341 EVT_COMMAND_RIGHT_CLICK = wx.PyEventBinder( wxEVT_COMMAND_RIGHT_CLICK, 1)
342 EVT_COMMAND_RIGHT_DCLICK = wx.PyEventBinder( wxEVT_COMMAND_RIGHT_DCLICK, 1)
343 EVT_COMMAND_SET_FOCUS = wx.PyEventBinder( wxEVT_COMMAND_SET_FOCUS, 1)
344 EVT_COMMAND_KILL_FOCUS = wx.PyEventBinder( wxEVT_COMMAND_KILL_FOCUS, 1)
345 EVT_COMMAND_ENTER = wx.PyEventBinder( wxEVT_COMMAND_ENTER, 1)
347 EVT_IDLE = wx.PyEventBinder( wxEVT_IDLE )
349 EVT_UPDATE_UI = wx.PyEventBinder( wxEVT_UPDATE_UI, 1)
350 EVT_UPDATE_UI_RANGE = wx.PyEventBinder( wxEVT_UPDATE_UI, 2)
352 EVT_CONTEXT_MENU = wx.PyEventBinder( wxEVT_CONTEXT_MENU )
357 //---------------------------------------------------------------------------
360 class wxEvent : public wxObject {
362 // wxEvent(int winid = 0, wxEventType commandType = wxEVT_NULL); // *** This class is now an ABC
365 void SetEventType(wxEventType typ);
366 wxEventType GetEventType() const;
367 wxObject *GetEventObject() const;
368 void SetEventObject(wxObject *obj);
369 long GetTimestamp() const;
370 void SetTimestamp(long ts = 0);
375 bool IsCommandEvent() const;
378 void , Skip(bool skip = true),
379 "Called by an event handler, it controls whether additional event
380 handlers bound to this event will be called after the current event
381 handler returns. Skip(false) (the default setting) will prevent
382 additional event handlers from being called and control will be
383 returned to the sender of the event immediately after the current
384 handler has finished. Skip(True) will cause the event processing
385 system to continue searching for a handler function for this event.
388 bool GetSkipped() const;
390 // Determine if this event should be propagating to the parent window.
391 bool ShouldPropagate() const;
393 // Stop an event from propagating to its parent window, returns the old
394 // propagation level value
395 int StopPropagation();
397 // Resume the event propagation by restoring the propagation level
398 // (returned by StopPropagation())
399 void ResumePropagation(int propagationLevel);
401 // this function is used to create a copy of the event polymorphically and
402 // all derived classes must implement it because otherwise wxPostEvent()
403 // for them wouldn't work (it needs to do a copy of the event)
404 virtual wxEvent *Clone() /* =0*/;
408 //---------------------------------------------------------------------------
411 // Helper class to temporarily change an event not to propagate.
412 class wxPropagationDisabler
415 wxPropagationDisabler(wxEvent& event);
416 ~wxPropagationDisabler();
420 // Another one to temporarily lower propagation level.
421 class wxPropagateOnce
424 wxPropagateOnce(wxEvent& event);
428 //---------------------------------------------------------------------------
431 class wxCommandEvent : public wxEvent
434 wxCommandEvent(wxEventType commandType = wxEVT_NULL, int winid = 0);
437 // // Set/Get client data from controls
438 // void SetClientData(void* clientData) { m_clientData = clientData; }
439 // void *GetClientData() const { return m_clientData; }
441 // // Set/Get client object from controls
442 // void SetClientObject(wxClientData* clientObject) { m_clientObject = clientObject; }
443 // void *GetClientObject() const { return m_clientObject; }
446 // Get listbox selection if single-choice
447 int GetSelection() const;
449 // Set/Get listbox/choice selection string
450 void SetString(const wxString& s);
451 wxString GetString() const;
453 // Get checkbox value
454 bool IsChecked() const;
455 %pythoncode { Checked = IsChecked }
457 // True if the listbox event was a selection.
458 bool IsSelection() const;
460 void SetExtraLong(long extraLong);
461 long GetExtraLong() const;
466 virtual wxEvent *Clone() const;
470 //---------------------------------------------------------------------------
473 // this class adds a possibility to react (from the user) code to a control
474 // notification: allow or veto the operation being reported.
475 class wxNotifyEvent : public wxCommandEvent
478 wxNotifyEvent(wxEventType commandType = wxEVT_NULL, int winid = 0);
480 // veto the operation (usually it's allowed by default)
483 // allow the operation if it was disabled by default
486 // for implementation code only: is the operation allowed?
491 //---------------------------------------------------------------------------
494 // Scroll event class, derived form wxCommandEvent. wxScrollEvents are
495 // sent by wxSlider and wxScrollBar.
496 class wxScrollEvent : public wxCommandEvent
499 wxScrollEvent(wxEventType commandType = wxEVT_NULL,
500 int winid = 0, int pos = 0, int orient = 0);
502 int GetOrientation() const;
503 int GetPosition() const;
504 void SetOrientation(int orient);
505 void SetPosition(int pos);
509 //---------------------------------------------------------------------------
512 // ScrollWin event class, derived fom wxEvent. wxScrollWinEvents
513 // are sent by wxWindow.
514 class wxScrollWinEvent : public wxEvent
517 wxScrollWinEvent(wxEventType commandType = wxEVT_NULL,
518 int pos = 0, int orient = 0);
520 int GetOrientation() const;
521 int GetPosition() const;
522 void SetOrientation(int orient);
523 void SetPosition(int pos);
526 //---------------------------------------------------------------------------
529 // the symbolic names for the mouse buttons
532 wxMOUSE_BTN_ANY = -1,
533 wxMOUSE_BTN_NONE = -1,
534 wxMOUSE_BTN_LEFT = 0,
535 wxMOUSE_BTN_MIDDLE = 1,
536 wxMOUSE_BTN_RIGHT = 2
541 class wxMouseEvent : public wxEvent
544 wxMouseEvent(wxEventType mouseType = wxEVT_NULL);
546 // Was it a button event? (*doesn't* mean: is any button *down*?)
547 bool IsButton() const;
549 // Was it a down event from this (or any) button?
550 bool ButtonDown(int but = wxMOUSE_BTN_ANY) const;
552 // Was it a dclick event from this (or any) button?
553 bool ButtonDClick(int but = wxMOUSE_BTN_ANY) const;
555 // Was it a up event from this (or any) button?
556 bool ButtonUp(int but = wxMOUSE_BTN_ANY) const;
558 // Was the given button changing state?
559 bool Button(int but) const;
561 // Was the given button in Down state?
562 bool ButtonIsDown(int but) const;
564 // Get the button which is changing state (wxMOUSE_BTN_NONE if none)
565 int GetButton() const;
567 // Find state of shift/control keys
568 bool ControlDown() const;
569 bool MetaDown() const;
570 bool AltDown() const;
571 bool ShiftDown() const;
574 bool , CmdDown() const,
575 "\"Cmd\" is a pseudo key which is the same as Control for PC and Unix
576 platforms but the special \"Apple\" (a.k.a as \"Command\") key on
577 Macs: it makes often sense to use it instead of, say, `ControlDown`
578 because Cmd key is used for the same thing under Mac as Ctrl
579 elsewhere. The Ctrl still exists, it's just not used for this
580 purpose. So for non-Mac platforms this is the same as `ControlDown`
581 and Macs this is the same as `MetaDown`.", "");
583 // Find which event was just generated
584 bool LeftDown() const;
585 bool MiddleDown() const;
586 bool RightDown() const;
589 bool MiddleUp() const;
590 bool RightUp() const;
592 bool LeftDClick() const;
593 bool MiddleDClick() const;
594 bool RightDClick() const;
596 // Find the current state of the mouse buttons (regardless
597 // of current event type)
602 // True if a button is down and the mouse is moving
603 bool Dragging() const;
605 // True if the mouse is moving, and no button is down
608 // True if the mouse is just entering the window
609 bool Entering() const;
611 // True if the mouse is just leaving the window
612 bool Leaving() const;
615 DocStr(GetPosition, // sets the docstring for both
616 "Returns the position of the mouse in window coordinates when the event
618 wxPoint GetPosition();
621 void, GetPosition(long *OUTPUT, long *OUTPUT),
622 "GetPositionTuple() -> (x,y)",
625 // Find the logical position of the event given the DC
626 wxPoint GetLogicalPosition(const wxDC& dc) const;
629 wxCoord GetX() const;
632 wxCoord GetY() const;
634 // Get wheel rotation, positive or negative indicates direction of
635 // rotation. Current devices all send an event when rotation is equal to
636 // +/-WheelDelta, but this allows for finer resolution devices to be
637 // created in the future. Because of this you shouldn't assume that one
638 // event is equal to 1 line or whatever, but you should be able to either
639 // do partial line scrolling or wait until +/-WheelDelta rotation values
640 // have been accumulated before scrolling.
641 int GetWheelRotation() const;
643 // Get wheel delta, normally 120. This is the threshold for action to be
644 // taken, and one such action (for example, scrolling one increment)
645 // should occur for each delta.
646 int GetWheelDelta() const;
648 // Returns the configured number of lines (or whatever) to be scrolled per
649 // wheel action. Defaults to one.
650 int GetLinesPerAction() const;
652 // Is the system set to do page scrolling?
653 bool IsPageScroll() const;
669 int m_linesPerAction;
672 //---------------------------------------------------------------------------
676 class wxSetCursorEvent : public wxEvent
679 wxSetCursorEvent(wxCoord x = 0, wxCoord y = 0);
681 wxCoord GetX() const;
682 wxCoord GetY() const;
684 void SetCursor(const wxCursor& cursor);
685 const wxCursor& GetCursor() const;
686 bool HasCursor() const;
689 //---------------------------------------------------------------------------
692 // Keyboard input event class
694 class wxKeyEvent : public wxEvent
697 wxKeyEvent(wxEventType keyType = wxEVT_NULL);
699 // Find state of shift/control keys
700 bool ControlDown() const;
701 bool MetaDown() const;
702 bool AltDown() const;
703 bool ShiftDown() const;
706 bool , CmdDown() const,
707 "\"Cmd\" is a pseudo key which is the same as Control for PC and Unix
708 platforms but the special \"Apple\" (a.k.a as \"Command\") key on
709 Macs: it makes often sense to use it instead of, say, `ControlDown`
710 because Cmd key is used for the same thing under Mac as Ctrl
711 elsewhere. The Ctrl still exists, it's just not used for this
712 purpose. So for non-Mac platforms this is the same as `ControlDown`
713 and Macs this is the same as `MetaDown`.", "");
717 // exclude MetaDown() from HasModifiers() because NumLock under X is often
718 // configured as mod2 modifier, yet the key events even when it is pressed
719 // should be processed normally, not like Ctrl- or Alt-key
720 bool HasModifiers() const;
722 // get the key code: an ASCII7 char or an element of wxKeyCode enum
723 int GetKeyCode() const;
724 %pythoncode { KeyCode = GetKeyCode }
727 int GetUnicodeKey() {
729 return self->GetUnicodeKey();
735 %pythoncode { GetUniChar = GetUnicodeKey }
738 // get the raw key code (platform-dependent)
739 wxUint32 GetRawKeyCode() const;
741 // get the raw key flags (platform-dependent)
742 wxUint32 GetRawKeyFlags() const;
745 DocStr(GetPosition, // sets the docstring for both
746 "Find the position of the event.", "");
747 wxPoint GetPosition();
750 void, GetPosition(long *OUTPUT, long *OUTPUT),
751 "GetPositionTuple() -> (x,y)",
755 wxCoord GetX() const;
758 wxCoord GetY() const;
771 // these fields contain the platform-specific information about
772 // key that was pressed
777 //---------------------------------------------------------------------------
781 class wxSizeEvent : public wxEvent
784 wxSizeEvent(const wxSize& sz=wxDefaultSize, int winid = 0);
786 wxSize GetSize() const;
787 wxRect GetRect() const;
788 void SetRect(wxRect rect);
790 void SetSize(wxSize size) {
797 wxRect m_rect; // Used for wxEVT_SIZING
801 //---------------------------------------------------------------------------
805 class wxMoveEvent : public wxEvent
808 wxMoveEvent(const wxPoint& pos=wxDefaultPosition, int winid = 0);
810 wxPoint GetPosition() const;
811 wxRect GetRect() const;
812 void SetRect(const wxRect& rect);
813 void SetPosition(const wxPoint& pos);
816 m_pos = property(GetPosition, SetPosition)
817 m_rect = property(GetRect, SetRect)
821 //---------------------------------------------------------------------------
825 class wxPaintEvent : public wxEvent
828 wxPaintEvent(int Id = 0);
832 class wxNcPaintEvent : public wxEvent
835 wxNcPaintEvent(int winid = 0);
838 //---------------------------------------------------------------------------
841 class wxEraseEvent : public wxEvent
844 wxEraseEvent(int Id = 0, wxDC *dc = (wxDC *) NULL);
850 //---------------------------------------------------------------------------
853 class wxFocusEvent : public wxEvent
856 wxFocusEvent(wxEventType type = wxEVT_NULL, int winid = 0);
858 // The window associated with this event is the window which had focus
859 // before for SET event and the window which will have focus for the KILL
860 // one. NB: it may be NULL in both cases!
861 wxWindow *GetWindow() const;
862 void SetWindow(wxWindow *win);
865 //---------------------------------------------------------------------------
868 // wxChildFocusEvent notifies the parent that a child has got the focus: unlike
869 // wxFocusEvent it is propagated upwards the window chain
870 class wxChildFocusEvent : public wxCommandEvent
873 wxChildFocusEvent(wxWindow *win = NULL);
875 wxWindow *GetWindow() const;
878 //---------------------------------------------------------------------------
881 class wxActivateEvent : public wxEvent
884 wxActivateEvent(wxEventType type = wxEVT_NULL, bool active = true, int Id = 0);
885 bool GetActive() const;
889 //---------------------------------------------------------------------------
892 class wxInitDialogEvent : public wxEvent
895 wxInitDialogEvent(int Id = 0);
899 //---------------------------------------------------------------------------
902 class wxMenuEvent : public wxEvent
905 wxMenuEvent(wxEventType type = wxEVT_NULL, int winid = 0, wxMenu* menu = NULL);
907 // only for wxEVT_MENU_HIGHLIGHT
908 int GetMenuId() const;
910 // only for wxEVT_MENU_OPEN/CLOSE
911 bool IsPopup() const;
913 // only for wxEVT_MENU_OPEN/CLOSE
914 wxMenu* GetMenu() const;
917 //---------------------------------------------------------------------------
920 // Window close or session close event class
921 class wxCloseEvent : public wxEvent
924 wxCloseEvent(wxEventType type = wxEVT_NULL, int winid = 0);
926 void SetLoggingOff(bool logOff);
927 bool GetLoggingOff() const;
929 void Veto(bool veto = true);
930 void SetCanVeto(bool canVeto);
932 bool CanVeto() const;
933 bool GetVeto() const;
937 //---------------------------------------------------------------------------
940 class wxShowEvent : public wxEvent
943 wxShowEvent(int winid = 0, bool show = false);
945 void SetShow(bool show);
946 bool GetShow() const;
951 //---------------------------------------------------------------------------
954 class wxIconizeEvent: public wxEvent
957 wxIconizeEvent(int id = 0, bool iconized = true);
962 //---------------------------------------------------------------------------
965 class wxMaximizeEvent: public wxEvent
968 wxMaximizeEvent(int id = 0);
971 //---------------------------------------------------------------------------
974 class wxDropFilesEvent: public wxEvent
977 wxPoint GetPosition();
978 int GetNumberOfFiles();
981 PyObject* GetFiles() {
982 int count = self->GetNumberOfFiles();
983 wxString* files = self->GetFiles();
984 PyObject* list = PyList_New(count);
987 PyErr_SetString(PyExc_MemoryError, "Can't allocate list of files!");
991 for (int i=0; i<count; i++) {
992 PyList_SetItem(list, i, wx2PyString(files[i]));
1001 //---------------------------------------------------------------------------
1005 // Whether to always send update events to windows, or
1006 // to only send update events to those with the
1007 // wxWS_EX_PROCESS_UI_UPDATES style.
1011 // Send UI update events to all windows
1012 wxUPDATE_UI_PROCESS_ALL,
1014 // Send UI update events to windows that have
1015 // the wxWS_EX_PROCESS_UI_UPDATES flag specified
1016 wxUPDATE_UI_PROCESS_SPECIFIED
1021 class wxUpdateUIEvent : public wxCommandEvent
1024 wxUpdateUIEvent(wxWindowID commandId = 0);
1026 bool GetChecked() const;
1027 bool GetEnabled() const;
1028 wxString GetText() const;
1029 bool GetSetText() const;
1030 bool GetSetChecked() const;
1031 bool GetSetEnabled() const;
1033 void Check(bool check);
1034 void Enable(bool enable);
1035 void SetText(const wxString& text);
1037 // Sets the interval between updates in milliseconds.
1038 // Set to -1 to disable updates, or to 0 to update as frequently as possible.
1039 static void SetUpdateInterval(long updateInterval);
1041 // Returns the current interval between updates in milliseconds
1042 static long GetUpdateInterval();
1044 // Can we update this window?
1045 static bool CanUpdate(wxWindow *win);
1047 // Reset the update time to provide a delay until the next
1048 // time we should update
1049 static void ResetUpdateTime();
1051 // Specify how wxWindows will send update events: to
1052 // all windows, or only to those which specify that they
1053 // will process the events.
1054 static void SetMode(wxUpdateUIMode mode);
1056 // Returns the UI update mode
1057 static wxUpdateUIMode GetMode();
1060 //---------------------------------------------------------------------------
1063 class wxSysColourChangedEvent: public wxEvent {
1065 wxSysColourChangedEvent();
1068 //---------------------------------------------------------------------------
1072 // wxEVT_MOUSE_CAPTURE_CHANGED
1073 // The window losing the capture receives this message
1074 // (even if it released the capture itself).
1075 class wxMouseCaptureChangedEvent : public wxEvent
1078 wxMouseCaptureChangedEvent(wxWindowID winid = 0, wxWindow* gainedCapture = NULL);
1080 wxWindow* GetCapturedWindow() const;
1083 //---------------------------------------------------------------------------
1086 class wxDisplayChangedEvent : public wxEvent
1089 wxDisplayChangedEvent();
1092 //---------------------------------------------------------------------------
1095 class wxPaletteChangedEvent : public wxEvent
1098 wxPaletteChangedEvent(wxWindowID id = 0);
1100 void SetChangedWindow(wxWindow* win);
1101 wxWindow* GetChangedWindow();
1105 //---------------------------------------------------------------------------
1109 // wxEVT_QUERY_NEW_PALETTE
1110 // Indicates the window is getting keyboard focus and should re-do its palette.
1111 class wxQueryNewPaletteEvent : public wxEvent
1114 wxQueryNewPaletteEvent(wxWindowID winid = 0);
1116 // App sets this if it changes the palette.
1117 void SetPaletteRealized(bool realized);
1118 bool GetPaletteRealized() const;
1121 //---------------------------------------------------------------------------
1125 // Event generated by dialog navigation keys
1126 // wxEVT_NAVIGATION_KEY
1128 class wxNavigationKeyEvent : public wxEvent
1131 wxNavigationKeyEvent();
1133 // direction: forward (True) or backward (False)
1134 bool GetDirection() const;
1135 void SetDirection(bool forward);
1137 // it may be a window change event (MDI, notebook pages...) or a control
1139 bool IsWindowChange() const;
1140 void SetWindowChange(bool ischange);
1142 // Set to true under MSW if the event was generated using the tab key.
1143 // This is required for proper navogation over radio buttons
1144 bool IsFromTab() const;
1145 void SetFromTab(bool bIs);
1147 void SetFlags(long flags);
1149 // the child which has the focus currently (may be NULL - use
1150 // wxWindow::FindFocus then)
1151 wxWindow* GetCurrentFocus() const;
1152 void SetCurrentFocus(wxWindow *win);
1163 //---------------------------------------------------------------------------
1166 // Window creation/destruction events: the first is sent as soon as window is
1167 // created (i.e. the underlying GUI object exists), but when the C++ object is
1168 // fully initialized (so virtual functions may be called). The second,
1169 // wxEVT_DESTROY, is sent right before the window is destroyed - again, it's
1170 // still safe to call virtual functions at this moment
1172 class wxWindowCreateEvent : public wxCommandEvent
1175 wxWindowCreateEvent(wxWindow *win = NULL);
1176 wxWindow *GetWindow() const;
1179 class wxWindowDestroyEvent : public wxCommandEvent
1182 wxWindowDestroyEvent(wxWindow *win = NULL);
1183 wxWindow *GetWindow() const;
1187 //---------------------------------------------------------------------------
1190 // A Context event is sent when the user right clicks on a window or
1191 // presses Shift-F10
1192 // NOTE : Under windows this is a repackaged WM_CONTETXMENU message
1193 // Under other systems it may have to be generated from a right click event
1198 class wxContextMenuEvent : public wxCommandEvent
1201 wxContextMenuEvent(wxEventType type = wxEVT_NULL,
1202 wxWindowID winid = 0,
1203 const wxPoint& pt = wxDefaultPosition);
1205 // Position of event (in screen coordinates)
1206 const wxPoint& GetPosition() const;
1207 void SetPosition(const wxPoint& pos);
1210 //---------------------------------------------------------------------------
1213 // Whether to always send idle events to windows, or
1214 // to only send update events to those with the
1215 // wxWS_EX_PROCESS_IDLE style.
1219 // Send idle events to all windows
1222 // Send idle events to windows that have
1223 // the wxWS_EX_PROCESS_IDLE flag specified
1224 wxIDLE_PROCESS_SPECIFIED
1228 class wxIdleEvent : public wxEvent
1233 void RequestMore(bool needMore = true);
1234 bool MoreRequested() const;
1236 // Specify how wxWindows will send idle events: to
1237 // all windows, or only to those which specify that they
1238 // will process the events.
1239 static void SetMode(wxIdleMode mode);
1241 // Returns the idle event mode
1242 static wxIdleMode GetMode();
1244 // Can we send an idle event?
1245 static bool CanSend(wxWindow* win);
1248 //---------------------------------------------------------------------------
1251 // These classes can be derived from in Python and passed through the event
1252 // system without loosing anything. They do this by keeping a reference to
1253 // themselves and some special case handling in wxPyCallback::EventThunker.
1255 class wxPyEvent : public wxEvent {
1257 %pythonAppend wxPyEvent "self.SetSelf(self)"
1258 wxPyEvent(int winid=0, wxEventType commandType = wxEVT_NULL );
1262 void SetSelf(PyObject* self);
1263 PyObject* GetSelf();
1267 class wxPyCommandEvent : public wxCommandEvent {
1269 %pythonAppend wxPyCommandEvent "self.SetSelf(self)"
1270 wxPyCommandEvent(wxEventType commandType = wxEVT_NULL, int id=0);
1271 ~wxPyCommandEvent();
1273 void SetSelf(PyObject* self);
1274 PyObject* GetSelf();
1279 //---------------------------------------------------------------------------
1282 class wxDateEvent : public wxCommandEvent
1285 wxDateEvent(wxWindow *win, const wxDateTime& dt, wxEventType type);
1287 const wxDateTime& GetDate() const;
1288 void SetDate(const wxDateTime &date);
1293 %constant wxEventType wxEVT_DATE_CHANGED;
1296 EVT_DATE_CHANGED = wx.PyEventBinder( wxEVT_DATE_CHANGED, 1 )
1300 //---------------------------------------------------------------------------