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