]> git.saurik.com Git - wxWidgets.git/blame_incremental - wxPython/src/_extras.py
Already had wxEVT_MOUSE_CAPTURE_CHANGED, don't need it twice
[wxWidgets.git] / wxPython / src / _extras.py
... / ...
CommitLineData
1#----------------------------------------------------------------------------
2# Name: _extra.py
3# Purpose: This file is appended to the shadow class file generated
4# by SWIG. We add some unSWIGable things here.
5#
6# Author: Robin Dunn
7#
8# Created: 6/30/97
9# Copyright: (c) 1998 by Total Control Software
10# Licence: wxWindows license
11#----------------------------------------------------------------------------
12
13import sys
14
15#----------------------------------------------------------------------
16# This gives this module's dictionary to the C++ extension code...
17
18_wxSetDictionary(vars())
19
20
21#----------------------------------------------------------------------
22#----------------------------------------------------------------------
23# Helper function to link python methods to wxWindows virtual
24# functions by name.
25
26def _checkForCallback(obj, name, event, theID=-1):
27 try: cb = getattr(obj, name)
28 except: pass
29 else: obj.Connect(theID, -1, event, cb)
30
31
32#----------------------------------------------------------------------
33#----------------------------------------------------------------------
34# functions that look and act like the C++ Macros of the same name
35
36
37# Miscellaneous
38def EVT_SIZE(win, func):
39 win.Connect(-1, -1, wxEVT_SIZE, func)
40
41def EVT_MOVE(win, func):
42 win.Connect(-1, -1, wxEVT_MOVE, func)
43
44def EVT_CLOSE(win, func):
45 win.Connect(-1, -1, wxEVT_CLOSE_WINDOW, func)
46
47def EVT_PAINT(win, func):
48 win.Connect(-1, -1, wxEVT_PAINT, func)
49
50def EVT_ERASE_BACKGROUND(win, func):
51 win.Connect(-1, -1, wxEVT_ERASE_BACKGROUND, func)
52
53def EVT_CHAR(win, func):
54 win.Connect(-1, -1, wxEVT_CHAR, func)
55
56def EVT_CHAR_HOOK(win, func):
57 win.Connect(-1, -1, wxEVT_CHAR_HOOK, func)
58
59def EVT_KEY_DOWN(win, func):
60 win.Connect(-1, -1, wxEVT_KEY_DOWN, func)
61
62def EVT_KEY_UP(win, func):
63 win.Connect(-1, -1, wxEVT_KEY_UP, func)
64
65def EVT_MENU_OPEN(win, func):
66 win.Connect(-1, -1, wxEVT_MENU_OPEN, func)
67
68def EVT_MENU_CLOSE(win, func):
69 win.Connect(-1, -1, wxEVT_MENU_CLOSE, func)
70
71def EVT_MENU_HIGHLIGHT(win, id, func):
72 win.Connect(id, -1, wxEVT_MENU_HIGHLIGHT, func)
73
74def EVT_MENU_HIGHLIGHT_ALL(win, func):
75 win.Connect(-1, -1, wxEVT_MENU_HIGHLIGHT, func)
76
77def EVT_SET_FOCUS(win, func):
78 win.Connect(-1, -1, wxEVT_SET_FOCUS, func)
79
80def EVT_KILL_FOCUS(win, func):
81 win.Connect(-1, -1, wxEVT_KILL_FOCUS, func)
82
83def EVT_CHILD_FOCUS(win, func):
84 win.Connect(-1, -1, wxEVT_CHILD_FOCUS, func)
85
86def EVT_ACTIVATE(win, func):
87 win.Connect(-1, -1, wxEVT_ACTIVATE, func)
88
89def EVT_ACTIVATE_APP(win, func):
90 win.Connect(-1, -1, wxEVT_ACTIVATE_APP, func)
91
92def EVT_END_SESSION(win, func):
93 win.Connect(-1, -1, wxEVT_END_SESSION, func)
94
95def EVT_QUERY_END_SESSION(win, func):
96 win.Connect(-1, -1, wxEVT_QUERY_END_SESSION, func)
97
98def EVT_DROP_FILES(win, func):
99 win.Connect(-1, -1, wxEVT_DROP_FILES, func)
100
101def EVT_INIT_DIALOG(win, func):
102 win.Connect(-1, -1, wxEVT_INIT_DIALOG, func)
103
104def EVT_SYS_COLOUR_CHANGED(win, func):
105 win.Connect(-1, -1, wxEVT_SYS_COLOUR_CHANGED, func)
106
107def EVT_DISPLAY_CHANGED(win, func):
108 win.Connect(-1, -1, wxEVT_DISPLAY_CHANGED, func)
109
110def EVT_SHOW(win, func):
111 win.Connect(-1, -1, wxEVT_SHOW, func)
112
113def EVT_MAXIMIZE(win, func):
114 win.Connect(-1, -1, wxEVT_MAXIMIZE, func)
115
116def EVT_ICONIZE(win, func):
117 win.Connect(-1, -1, wxEVT_ICONIZE, func)
118
119def EVT_NAVIGATION_KEY(win, func):
120 win.Connect(-1, -1, wxEVT_NAVIGATION_KEY, func)
121
122def EVT_PALETTE_CHANGED(win, func):
123 win.Connect(-1, -1, wxEVT_PALETTE_CHANGED, func)
124
125def EVT_QUERY_NEW_PALETTE(win, func):
126 win.Connect(-1, -1, wxEVT_QUERY_NEW_PALETTE, func)
127
128def EVT_WINDOW_CREATE(win, func):
129 win.Connect(-1, -1, wxEVT_CREATE, func)
130
131def EVT_WINDOW_DESTROY(win, func):
132 win.Connect(-1, -1, wxEVT_DESTROY, func)
133
134
135
136def EVT_IDLE(win, func):
137 win.Connect(-1, -1, wxEVT_IDLE, func)
138
139def EVT_UPDATE_UI(win, id, func):
140 win.Connect(id, -1, wxEVT_UPDATE_UI, func)
141
142def EVT_UPDATE_UI_RANGE(win, id, id2, func):
143 win.Connect(id, id2, wxEVT_UPDATE_UI, func)
144
145
146# Mouse Events
147def EVT_LEFT_DOWN(win, func):
148 win.Connect(-1, -1, wxEVT_LEFT_DOWN, func)
149
150def EVT_LEFT_UP(win, func):
151 win.Connect(-1, -1, wxEVT_LEFT_UP, func)
152
153def EVT_MIDDLE_DOWN(win, func):
154 win.Connect(-1, -1, wxEVT_MIDDLE_DOWN, func)
155
156def EVT_MIDDLE_UP(win, func):
157 win.Connect(-1, -1, wxEVT_MIDDLE_UP, func)
158
159def EVT_RIGHT_DOWN(win, func):
160 win.Connect(-1, -1, wxEVT_RIGHT_DOWN, func)
161
162def EVT_RIGHT_UP(win, func):
163 win.Connect(-1, -1, wxEVT_RIGHT_UP, func)
164
165def EVT_MOTION(win, func):
166 win.Connect(-1, -1, wxEVT_MOTION, func)
167
168def EVT_LEFT_DCLICK(win, func):
169 win.Connect(-1, -1, wxEVT_LEFT_DCLICK, func)
170
171def EVT_MIDDLE_DCLICK(win, func):
172 win.Connect(-1, -1, wxEVT_MIDDLE_DCLICK, func)
173
174def EVT_RIGHT_DCLICK(win, func):
175 win.Connect(-1, -1, wxEVT_RIGHT_DCLICK, func)
176
177def EVT_LEAVE_WINDOW(win, func):
178 win.Connect(-1, -1, wxEVT_LEAVE_WINDOW, func)
179
180def EVT_ENTER_WINDOW(win, func):
181 win.Connect(-1, -1, wxEVT_ENTER_WINDOW, func)
182
183def EVT_MOUSEWHEEL(win, func):
184 win.Connect(-1, -1, wxEVT_MOUSEWHEEL, func)
185
186# all mouse events
187def EVT_MOUSE_EVENTS(win, func):
188 win.Connect(-1, -1, wxEVT_LEFT_DOWN, func)
189 win.Connect(-1, -1, wxEVT_LEFT_UP, func)
190 win.Connect(-1, -1, wxEVT_MIDDLE_DOWN, func)
191 win.Connect(-1, -1, wxEVT_MIDDLE_UP, func)
192 win.Connect(-1, -1, wxEVT_RIGHT_DOWN, func)
193 win.Connect(-1, -1, wxEVT_RIGHT_UP, func)
194 win.Connect(-1, -1, wxEVT_MOTION, func)
195 win.Connect(-1, -1, wxEVT_LEFT_DCLICK, func)
196 win.Connect(-1, -1, wxEVT_MIDDLE_DCLICK, func)
197 win.Connect(-1, -1, wxEVT_RIGHT_DCLICK, func)
198 win.Connect(-1, -1, wxEVT_LEAVE_WINDOW, func)
199 win.Connect(-1, -1, wxEVT_ENTER_WINDOW, func)
200
201def EVT_MOUSE_CAPTURE_CHANGED(win, func):
202 win.Connect(-1, -1, wxEVT_MOUSE_CAPTURE_CHANGED, func)
203
204# EVT_COMMAND
205def EVT_COMMAND(win, id, cmd, func):
206 win.Connect(id, -1, cmd, func)
207
208def EVT_COMMAND_RANGE(win, id1, id2, cmd, func):
209 win.Connect(id1, id2, cmd, func)
210
211
212# Scrolling
213def EVT_SCROLL(win, func):
214 win.Connect(-1, -1, wxEVT_SCROLL_TOP, func)
215 win.Connect(-1, -1, wxEVT_SCROLL_BOTTOM, func)
216 win.Connect(-1, -1, wxEVT_SCROLL_LINEUP, func)
217 win.Connect(-1, -1, wxEVT_SCROLL_LINEDOWN, func)
218 win.Connect(-1, -1, wxEVT_SCROLL_PAGEUP, func)
219 win.Connect(-1, -1, wxEVT_SCROLL_PAGEDOWN, func)
220 win.Connect(-1, -1, wxEVT_SCROLL_THUMBTRACK,func)
221 win.Connect(-1, -1, wxEVT_SCROLL_THUMBRELEASE,func)
222
223def EVT_SCROLL_TOP(win, func):
224 win.Connect(-1, -1, wxEVT_SCROLL_TOP, func)
225
226def EVT_SCROLL_BOTTOM(win, func):
227 win.Connect(-1, -1, wxEVT_SCROLL_BOTTOM, func)
228
229def EVT_SCROLL_LINEUP(win, func):
230 win.Connect(-1, -1, wxEVT_SCROLL_LINEUP, func)
231
232def EVT_SCROLL_LINEDOWN(win, func):
233 win.Connect(-1, -1, wxEVT_SCROLL_LINEDOWN, func)
234
235def EVT_SCROLL_PAGEUP(win, func):
236 win.Connect(-1, -1, wxEVT_SCROLL_PAGEUP, func)
237
238def EVT_SCROLL_PAGEDOWN(win, func):
239 win.Connect(-1, -1, wxEVT_SCROLL_PAGEDOWN, func)
240
241def EVT_SCROLL_THUMBTRACK(win, func):
242 win.Connect(-1, -1, wxEVT_SCROLL_THUMBTRACK, func)
243
244def EVT_SCROLL_THUMBRELEASE(win, func):
245 win.Connect(-1, -1, wxEVT_SCROLL_THUMBRELEASE, func)
246
247
248
249# Scrolling, with an id
250def EVT_COMMAND_SCROLL(win, id, func):
251 win.Connect(id, -1, wxEVT_SCROLL_TOP, func)
252 win.Connect(id, -1, wxEVT_SCROLL_BOTTOM, func)
253 win.Connect(id, -1, wxEVT_SCROLL_LINEUP, func)
254 win.Connect(id, -1, wxEVT_SCROLL_LINEDOWN, func)
255 win.Connect(id, -1, wxEVT_SCROLL_PAGEUP, func)
256 win.Connect(id, -1, wxEVT_SCROLL_PAGEDOWN, func)
257 win.Connect(id, -1, wxEVT_SCROLL_THUMBTRACK,func)
258 win.Connect(id, -1, wxEVT_SCROLL_THUMBRELEASE,func)
259
260def EVT_COMMAND_SCROLL_TOP(win, id, func):
261 win.Connect(id, -1, wxEVT_SCROLL_TOP, func)
262
263def EVT_COMMAND_SCROLL_BOTTOM(win, id, func):
264 win.Connect(id, -1, wxEVT_SCROLL_BOTTOM, func)
265
266def EVT_COMMAND_SCROLL_LINEUP(win, id, func):
267 win.Connect(id, -1, wxEVT_SCROLL_LINEUP, func)
268
269def EVT_COMMAND_SCROLL_LINEDOWN(win, id, func):
270 win.Connect(id, -1, wxEVT_SCROLL_LINEDOWN, func)
271
272def EVT_COMMAND_SCROLL_PAGEUP(win, id, func):
273 win.Connect(id, -1, wxEVT_SCROLL_PAGEUP, func)
274
275def EVT_COMMAND_SCROLL_PAGEDOWN(win, id, func):
276 win.Connect(id, -1, wxEVT_SCROLL_PAGEDOWN, func)
277
278def EVT_COMMAND_SCROLL_THUMBTRACK(win, id, func):
279 win.Connect(id, -1, wxEVT_SCROLL_THUMBTRACK, func)
280
281def EVT_COMMAND_SCROLL_THUMBRELEASE(win, id, func):
282 win.Connect(id, -1, wxEVT_SCROLL_THUMBRELEASE, func)
283
284#---
285def EVT_SCROLLWIN(win, func):
286 win.Connect(-1, -1, wxEVT_SCROLLWIN_TOP, func)
287 win.Connect(-1, -1, wxEVT_SCROLLWIN_BOTTOM, func)
288 win.Connect(-1, -1, wxEVT_SCROLLWIN_LINEUP, func)
289 win.Connect(-1, -1, wxEVT_SCROLLWIN_LINEDOWN, func)
290 win.Connect(-1, -1, wxEVT_SCROLLWIN_PAGEUP, func)
291 win.Connect(-1, -1, wxEVT_SCROLLWIN_PAGEDOWN, func)
292 win.Connect(-1, -1, wxEVT_SCROLLWIN_THUMBTRACK, func)
293 win.Connect(-1, -1, wxEVT_SCROLLWIN_THUMBRELEASE,func)
294
295def EVT_SCROLLWIN_TOP(win, func):
296 win.Connect(-1, -1, wxEVT_SCROLLWIN_TOP, func)
297
298def EVT_SCROLLWIN_BOTTOM(win, func):
299 win.Connect(-1, -1, wxEVT_SCROLLWIN_BOTTOM, func)
300
301def EVT_SCROLLWIN_LINEUP(win, func):
302 win.Connect(-1, -1, wxEVT_SCROLLWIN_LINEUP, func)
303
304def EVT_SCROLLWIN_LINEDOWN(win, func):
305 win.Connect(-1, -1, wxEVT_SCROLLWIN_LINEDOWN, func)
306
307def EVT_SCROLLWIN_PAGEUP(win, func):
308 win.Connect(-1, -1, wxEVT_SCROLLWIN_PAGEUP, func)
309
310def EVT_SCROLLWIN_PAGEDOWN(win, func):
311 win.Connect(-1, -1, wxEVT_SCROLLWIN_PAGEDOWN, func)
312
313def EVT_SCROLLWIN_THUMBTRACK(win, func):
314 win.Connect(-1, -1, wxEVT_SCROLLWIN_THUMBTRACK, func)
315
316def EVT_SCROLLWIN_THUMBRELEASE(win, func):
317 win.Connect(-1, -1, wxEVT_SCROLLWIN_THUMBRELEASE, func)
318
319
320
321# Scrolling, with an id
322def EVT_COMMAND_SCROLLWIN(win, id, func):
323 win.Connect(id, -1, wxEVT_SCROLLWIN_TOP, func)
324 win.Connect(id, -1, wxEVT_SCROLLWIN_BOTTOM, func)
325 win.Connect(id, -1, wxEVT_SCROLLWIN_LINEUP, func)
326 win.Connect(id, -1, wxEVT_SCROLLWIN_LINEDOWN, func)
327 win.Connect(id, -1, wxEVT_SCROLLWIN_PAGEUP, func)
328 win.Connect(id, -1, wxEVT_SCROLLWIN_PAGEDOWN, func)
329 win.Connect(id, -1, wxEVT_SCROLLWIN_THUMBTRACK, func)
330 win.Connect(id, -1, wxEVT_SCROLLWIN_THUMBRELEASE,func)
331
332def EVT_COMMAND_SCROLLWIN_TOP(win, id, func):
333 win.Connect(id, -1, wxEVT_SCROLLWIN_TOP, func)
334
335def EVT_COMMAND_SCROLLWIN_BOTTOM(win, id, func):
336 win.Connect(id, -1, wxEVT_SCROLLWIN_BOTTOM, func)
337
338def EVT_COMMAND_SCROLLWIN_LINEUP(win, id, func):
339 win.Connect(id, -1, wxEVT_SCROLLWIN_LINEUP, func)
340
341def EVT_COMMAND_SCROLLWIN_LINEDOWN(win, id, func):
342 win.Connect(id, -1, wxEVT_SCROLLWIN_LINEDOWN, func)
343
344def EVT_COMMAND_SCROLLWIN_PAGEUP(win, id, func):
345 win.Connect(id, -1, wxEVT_SCROLLWIN_PAGEUP, func)
346
347def EVT_COMMAND_SCROLLWIN_PAGEDOWN(win, id, func):
348 win.Connect(id, -1, wxEVT_SCROLLWIN_PAGEDOWN, func)
349
350def EVT_COMMAND_SCROLLWIN_THUMBTRACK(win, id, func):
351 win.Connect(id, -1, wxEVT_SCROLLWIN_THUMBTRACK, func)
352
353def EVT_COMMAND_SCROLLWIN_THUMBRELEASE(win, id, func):
354 win.Connect(id, -1, wxEVT_SCROLLWIN_THUMBRELEASE, func)
355
356
357# Convenience commands
358def EVT_BUTTON(win, id, func):
359 win.Connect(id, -1, wxEVT_COMMAND_BUTTON_CLICKED, func)
360
361def EVT_CHECKBOX(win, id, func):
362 win.Connect(id, -1, wxEVT_COMMAND_CHECKBOX_CLICKED, func)
363
364def EVT_CHOICE(win, id, func):
365 win.Connect(id, -1, wxEVT_COMMAND_CHOICE_SELECTED, func)
366
367def EVT_LISTBOX(win, id, func):
368 win.Connect(id, -1, wxEVT_COMMAND_LISTBOX_SELECTED, func)
369
370def EVT_LISTBOX_DCLICK(win, id, func):
371 win.Connect(id, -1, wxEVT_COMMAND_LISTBOX_DOUBLECLICKED, func)
372
373def EVT_TEXT(win, id, func):
374 win.Connect(id, -1, wxEVT_COMMAND_TEXT_UPDATED, func)
375
376def EVT_TEXT_ENTER(win, id, func):
377 win.Connect(id, -1, wxEVT_COMMAND_TEXT_ENTER, func)
378
379def EVT_TEXT_URL(win, id, func):
380 win.Connect(id, -1, wxEVT_COMMAND_TEXT_URL, func)
381
382def EVT_TEXT_MAXLEN(win, id, func):
383 win.Connect(id, -1, wxEVT_COMMAND_TEXT_MAXLEN, func)
384
385def EVT_MENU(win, id, func):
386 win.Connect(id, -1, wxEVT_COMMAND_MENU_SELECTED, func)
387
388def EVT_MENU_RANGE(win, id1, id2, func):
389 win.Connect(id1, id2, wxEVT_COMMAND_MENU_SELECTED, func)
390
391def EVT_SLIDER(win, id, func):
392 win.Connect(id, -1, wxEVT_COMMAND_SLIDER_UPDATED, func)
393
394def EVT_RADIOBOX(win, id, func):
395 win.Connect(id, -1, wxEVT_COMMAND_RADIOBOX_SELECTED, func)
396
397def EVT_RADIOBUTTON(win, id, func):
398 win.Connect(id, -1, wxEVT_COMMAND_RADIOBUTTON_SELECTED, func)
399
400def EVT_VLBOX(win, id, func):
401 win.Connect(id, -1, wxEVT_COMMAND_VLBOX_SELECTED, func)
402
403def EVT_COMBOBOX(win, id, func):
404 win.Connect(id, -1, wxEVT_COMMAND_COMBOBOX_SELECTED, func)
405
406def EVT_TOOL(win, id, func):
407 win.Connect(id, -1, wxEVT_COMMAND_TOOL_CLICKED, func)
408
409def EVT_TOOL_RANGE(win, id, id2, func):
410 win.Connect(id, id2, wxEVT_COMMAND_TOOL_CLICKED, func)
411
412def EVT_TOOL_RCLICKED(win, id, func):
413 win.Connect(id, -1, wxEVT_COMMAND_TOOL_RCLICKED, func)
414
415def EVT_TOOL_RCLICKED_RANGE(win, id, id2, func):
416 win.Connect(id, id2, wxEVT_COMMAND_TOOL_RCLICKED, func)
417
418def EVT_TOOL_ENTER(win, id, func):
419 win.Connect(id, -1, wxEVT_COMMAND_TOOL_ENTER, func)
420
421def EVT_CHECKLISTBOX(win, id, func):
422 win.Connect(id, -1, wxEVT_COMMAND_CHECKLISTBOX_TOGGLED, func)
423
424def EVT_SPINCTRL(win, id, func):
425 win.Connect(id, -1, wxEVT_COMMAND_SPINCTRL_UPDATED, func)
426
427
428
429# Generic command events
430
431def EVT_COMMAND_LEFT_CLICK(win, id, func):
432 win.Connect(id, -1, wxEVT_COMMAND_LEFT_CLICK, func)
433
434def EVT_COMMAND_LEFT_DCLICK(win, id, func):
435 win.Connect(id, -1, wxEVT_COMMAND_LEFT_DCLICK, func)
436
437def EVT_COMMAND_RIGHT_CLICK(win, id, func):
438 win.Connect(id, -1, wxEVT_COMMAND_RIGHT_CLICK, func)
439
440def EVT_COMMAND_RIGHT_DCLICK(win, id, func):
441 win.Connect(id, -1, wxEVT_COMMAND_RIGHT_DCLICK, func)
442
443def EVT_COMMAND_SET_FOCUS(win, id, func):
444 win.Connect(id, -1, wxEVT_COMMAND_SET_FOCUS, func)
445
446def EVT_COMMAND_KILL_FOCUS(win, id, func):
447 win.Connect(id, -1, wxEVT_COMMAND_KILL_FOCUS, func)
448
449def EVT_COMMAND_ENTER(win, id, func):
450 win.Connect(id, -1, wxEVT_COMMAND_ENTER, func)
451
452
453# wxNotebook events
454def EVT_NOTEBOOK_PAGE_CHANGED(win, id, func):
455 win.Connect(id, -1, wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGED, func)
456
457def EVT_NOTEBOOK_PAGE_CHANGING(win, id, func):
458 win.Connect(id, -1, wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGING, func)
459
460
461# wxSpinButton
462def EVT_SPIN_UP(win, id, func):
463 win.Connect(id, -1, wxEVT_SCROLL_LINEUP, func)
464
465def EVT_SPIN_DOWN(win, id, func):
466 win.Connect(id, -1, wxEVT_SCROLL_LINEDOWN, func)
467
468def EVT_SPIN(win, id, func):
469 win.Connect(id, -1, wxEVT_SCROLL_THUMBTRACK,func)
470
471
472# wxTaskBarIcon
473def EVT_TASKBAR_MOVE(win, func):
474 win.Connect(-1, -1, wxEVT_TASKBAR_MOVE, func)
475
476def EVT_TASKBAR_LEFT_DOWN(win, func):
477 win.Connect(-1, -1, wxEVT_TASKBAR_LEFT_DOWN, func)
478
479def EVT_TASKBAR_LEFT_UP(win, func):
480 win.Connect(-1, -1, wxEVT_TASKBAR_LEFT_UP, func)
481
482def EVT_TASKBAR_RIGHT_DOWN(win, func):
483 win.Connect(-1, -1, wxEVT_TASKBAR_RIGHT_DOWN, func)
484
485def EVT_TASKBAR_RIGHT_UP(win, func):
486 win.Connect(-1, -1, wxEVT_TASKBAR_RIGHT_UP, func)
487
488def EVT_TASKBAR_LEFT_DCLICK(win, func):
489 win.Connect(-1, -1, wxEVT_TASKBAR_LEFT_DCLICK, func)
490
491def EVT_TASKBAR_RIGHT_DCLICK(win, func):
492 win.Connect(-1, -1, wxEVT_TASKBAR_RIGHT_DCLICK, func)
493
494
495# wxSashWindow
496def EVT_SASH_DRAGGED(win, id, func):
497 win.Connect(id, -1, wxEVT_SASH_DRAGGED, func)
498
499def EVT_SASH_DRAGGED_RANGE(win, id1, id2, func):
500 win.Connect(id1, id2, wxEVT_SASH_DRAGGED, func)
501
502def EVT_QUERY_LAYOUT_INFO(win, func):
503 win.Connect(-1, -1, wxEVT_EVT_QUERY_LAYOUT_INFO, func)
504
505def EVT_CALCULATE_LAYOUT(win, func):
506 win.Connect(-1, -1, wxEVT_EVT_CALCULATE_LAYOUT, func)
507
508
509#wxSplitterWindow
510def EVT_SPLITTER_SASH_POS_CHANGING(win, id, func):
511 win.Connect(id, -1, wxEVT_COMMAND_SPLITTER_SASH_POS_CHANGING, func)
512
513def EVT_SPLITTER_SASH_POS_CHANGED(win, id, func):
514 win.Connect(id, -1, wxEVT_COMMAND_SPLITTER_SASH_POS_CHANGED, func)
515
516def EVT_SPLITTER_UNSPLIT(win, id, func):
517 win.Connect(id, -1, wxEVT_COMMAND_SPLITTER_UNSPLIT, func)
518
519def EVT_SPLITTER_DOUBLECLICKED(win, id, func):
520 win.Connect(id, -1, wxEVT_COMMAND_SPLITTER_DOUBLECLICKED, func)
521
522
523# wxTimer
524def EVT_TIMER(win, id, func):
525 win.Connect(id, -1, wxEVT_TIMER, func)
526
527# wxProcess
528def EVT_END_PROCESS(eh, id, func):
529 eh.Connect(id, -1, wxEVT_END_PROCESS, func)
530
531
532# wxJoyStick
533def EVT_JOY_DOWN(win, func):
534 win.Connect(-1, -1, wxEVT_JOY_BUTTON_DOWN, func)
535
536def EVT_JOY_UP(win, func):
537 win.Connect(-1, -1, wxEVT_JOY_BUTTON_UP, func)
538
539def EVT_JOY_MOVE(win, func):
540 win.Connect(-1, -1, wxEVT_JOY_MOVE, func)
541
542def EVT_JOY_ZMOVE(win, func):
543 win.Connect(-1, -1, wxEVT_JOY_ZMOVE, func)
544
545def EVT_JOYSTICK_EVENTS(win, func):
546 win.Connect(-1, -1, wxEVT_JOY_BUTTON_DOWN, func)
547 win.Connect(-1, -1, wxEVT_JOY_BUTTON_UP, func)
548 win.Connect(-1, -1, wxEVT_JOY_MOVE, func)
549 win.Connect(-1, -1, wxEVT_JOY_ZMOVE, func)
550
551
552def EVT_TOGGLEBUTTON(win, id, func):
553 win.Connect(id, -1, wxEVT_COMMAND_TOGGLEBUTTON_CLICKED, func)
554
555
556
557def EVT_CONTEXT_MENU(win, func):
558 win.Connect(-1, -1, wxEVT_CONTEXT_MENU, func)
559
560
561#----------------------------------------------------------------------
562
563class wxTimer(wxPyTimer):
564 def __init__(self, evtHandler = None, id = -1):
565 if evtHandler is None:
566 wxPyTimer.__init__(self, self.Notify) # derived class must provide
567 # Notify(self) method.
568 else:
569 wxPyTimer.__init__(self, None)
570 self.SetOwner(evtHandler, id)
571
572#----------------------------------------------------------------------
573# aliases
574
575wxColor = wxColour
576wxNamedColor = wxNamedColour
577wxPen = wxPyPen
578wxScrollbar = wxScrollBar
579
580
581# backwards compatibility
582wxNoRefBitmap = wxBitmap
583wxPyDefaultPosition = wxDefaultPosition
584wxPyDefaultSize = wxDefaultSize
585NULL = None
586wxSystemSettings_GetSystemColour = wxSystemSettings_GetColour
587wxSystemSettings_GetSystemFont = wxSystemSettings_GetFont
588wxSystemSettings_GetSystemMetric = wxSystemSettings_GetMetric
589
590#----------------------------------------------------------------------
591# wxGTK sets the locale when initialized. Doing this at the Python
592# level should set it up to match what GTK is doing at the C level.
593if wxPlatform == "__WXGTK__":
594 try:
595 import locale
596 locale.setlocale(locale.LC_ALL, "")
597 except:
598 pass
599
600
601
602#----------------------------------------------------------------------
603# wxWindows version numbers. wxPython version is in __version__.
604
605wxMAJOR_VERSION = wxc.wxMAJOR_VERSION
606wxMINOR_VERSION = wxc.wxMINOR_VERSION
607wxRELEASE_NUMBER = wxc.wxRELEASE_NUMBER
608wxVERSION_STRING = wxc.wxVERSION_STRING
609wxVERSION_NUMBER = wxc.wxVERSION_NUMBER
610
611wxVERSION = (wxMAJOR_VERSION, wxMINOR_VERSION, wxRELEASE_NUMBER)
612
613
614#----------------------------------------------------------------------
615# This helper function will take a wxPython object and convert it to
616# another wxPython object type. This will not be able to create objects
617# that are derived from wxPython classes by the user, only those that are
618# actually part of wxPython and directly corespond to C++ objects.
619#
620# This is useful in situations where some method returns a generic
621# type such as wxWindow, but you know that it is actually some
622# derived type such as a wxTextCtrl. You can't call wxTextCtrl specific
623# methods on a wxWindow object, but you can use this function to
624# create a wxTextCtrl object that will pass the same pointer to
625# the C++ code. You use it like this:
626#
627# textCtrl = wxPyTypeCast(window, "wxTextCtrl")
628#
629#
630# WARNING: Using this function to type cast objects into types that
631# they are not is not recommended and is likely to cause your
632# program to crash... Hard.
633#
634
635def wxPyTypeCast(obj, typeStr):
636 if obj is None:
637 return None
638 theClass = globals()[typeStr+"Ptr"]
639 typeStr = __wxPyPtrTypeMap.get(typeStr, typeStr)
640 if hasattr(obj, "this"):
641 # if already the right type then just return it
642 if isinstance(obj, theClass) or obj.__class__ is theClass:
643 return obj
644 newPtr = ptrcast(obj.this, typeStr+"_p")
645 else:
646 newPtr = ptrcast(obj, typeStr+"_p")
647 theObj = theClass(newPtr)
648 if hasattr(obj, "this"):
649 theObj.thisown = obj.thisown
650 return theObj
651
652
653#----------------------------------------------------------------------------
654
655class wxPyDeadObjectError(AttributeError):
656 pass
657
658class _wxPyDeadObject:
659 """
660 Instances of wx objects that are OOR capable will have their __class__
661 changed to this class when the C++ object is deleted. This should help
662 prevent crashes due to referencing a bogus C++ pointer.
663 """
664 reprStr = "wxPython wrapper for DELETED %s object! (The C++ object no longer exists.)"
665 attrStr = "The C++ part of the %s object has been deleted, attribute access no longer allowed."
666
667 def __repr__( self ):
668 if not hasattr(self, "_name"):
669 self._name = "[unknown]"
670 return self.reprStr % self._name
671
672 def __getattr__( self, *args ):
673 if not hasattr(self, "_name"):
674 self._name = "[unknown]"
675 raise wxPyDeadObjectError( self.attrStr % self._name )
676
677 def __nonzero__(self):
678 return 0
679
680
681#----------------------------------------------------------------------
682#----------------------------------------------------------------------
683
684class wxPyOnDemandOutputWindow:
685 def __init__(self, title = "wxPython: stdout/stderr"):
686 self.frame = None
687 self.title = title
688 self.parent = None
689
690 def SetParent(self, parent):
691 self.parent = parent
692
693 def OnCloseWindow(self, event):
694 if self.frame != None:
695 self.frame.Destroy()
696 self.frame = None
697 self.text = None
698
699 # These methods provide the file-like output behaviour.
700 def write(self, str):
701 if not wxThread_IsMain():
702 # Aquire the GUI mutex before making GUI calls. Mutex is released
703 # when locker is deleted at the end of this function.
704 locker = wxMutexGuiLocker()
705
706 if not self.frame:
707 self.frame = wxFrame(self.parent, -1, self.title,
708 style=wxDEFAULT_FRAME_STYLE|wxNO_FULL_REPAINT_ON_RESIZE)
709 self.text = wxTextCtrl(self.frame, -1, "",
710 style = wxTE_MULTILINE|wxTE_READONLY)
711 self.frame.SetSize(wxSize(450, 300))
712 self.frame.Show(true)
713 EVT_CLOSE(self.frame, self.OnCloseWindow)
714 self.text.AppendText(str)
715
716 def close(self):
717 if self.frame != None:
718 if not wxThread_IsMain():
719 locker = wxMutexGuiLocker()
720 self.frame.Close()
721
722
723_defRedirect = (wxPlatform == '__WXMSW__')
724
725#----------------------------------------------------------------------
726# The main application class. Derive from this and implement an OnInit
727# method that creates a frame and then calls self.SetTopWindow(frame)
728
729class wxApp(wxPyApp):
730 error = 'wxApp.error'
731 outputWindowClass = wxPyOnDemandOutputWindow
732
733 def __init__(self, redirect=_defRedirect, filename=None):
734 wxPyApp.__init__(self)
735 self.stdioWin = None
736 self.saveStdio = (sys.stdout, sys.stderr)
737 if redirect:
738 self.RedirectStdio(filename)
739 # this initializes wxWindows and then calls our OnInit
740 _wxStart(self.OnInit)
741
742
743 def __del__(self):
744 try:
745 self.RestoreStdio()
746 except:
747 pass
748
749
750 def SetTopWindow(self, frame):
751 if self.stdioWin:
752 self.stdioWin.SetParent(frame)
753 wxPyApp.SetTopWindow(self, frame)
754
755
756 def MainLoop(self):
757 wxPyApp.MainLoop(self)
758 self.RestoreStdio()
759
760
761 def RedirectStdio(self, filename):
762 if filename:
763 sys.stdout = sys.stderr = open(filename, 'a')
764 else:
765 self.stdioWin = self.outputWindowClass() # wxPyOnDemandOutputWindow
766 sys.stdout = sys.stderr = self.stdioWin
767
768
769 def RestoreStdio(self):
770 sys.stdout, sys.stderr = self.saveStdio
771
772
773#----------------------------------------------------------------------------
774
775class wxPySimpleApp(wxApp):
776 def __init__(self, flag=0):
777 wxApp.__init__(self, flag)
778 def OnInit(self):
779 return true
780
781
782class wxPyWidgetTester(wxApp):
783 def __init__(self, size = (250, 100)):
784 self.size = size
785 wxApp.__init__(self, 0)
786
787 def OnInit(self):
788 self.frame = wxFrame(None, -1, "Widget Tester", pos=(0,0), size=self.size)
789 self.SetTopWindow(self.frame)
790 return true
791
792 def SetWidget(self, widgetClass, *args):
793 w = apply(widgetClass, (self.frame,) + args)
794 self.frame.Show(true)
795
796#----------------------------------------------------------------------------
797# DO NOT hold any other references to this object. This is how we
798# know when to cleanup system resources that wxWin is holding. When
799# the sys module is unloaded, the refcount on sys.__wxPythonCleanup
800# goes to zero and it calls the wxApp_CleanUp function.
801
802class __wxPyCleanup:
803 def __init__(self):
804 self.cleanup = wxc.wxApp_CleanUp
805 def __del__(self):
806 self.cleanup()
807
808sys.__wxPythonCleanup = __wxPyCleanup()
809
810## # another possible solution, but it gets called too early...
811## if sys.version[0] == '2':
812## import atexit
813## atexit.register(wxc.wxApp_CleanUp)
814## else:
815## sys.exitfunc = wxc.wxApp_CleanUp
816
817
818#----------------------------------------------------------------------------
819#----------------------------------------------------------------------------