wxPython/src/_extras.py

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