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
 173 # all mouse events
 174 def EVT_MOUSE_EVENTS(win, func):
 175     win.Connect(-1, -1, wxEVT_LEFT_DOWN,     func)
 176     win.Connect(-1, -1, wxEVT_LEFT_UP,       func)
 177     win.Connect(-1, -1, wxEVT_MIDDLE_DOWN,   func)
 178     win.Connect(-1, -1, wxEVT_MIDDLE_UP,     func)
 179     win.Connect(-1, -1, wxEVT_RIGHT_DOWN,    func)
 180     win.Connect(-1, -1, wxEVT_RIGHT_UP,      func)
 181     win.Connect(-1, -1, wxEVT_MOTION,        func)
 182     win.Connect(-1, -1, wxEVT_LEFT_DCLICK,   func)
 183     win.Connect(-1, -1, wxEVT_MIDDLE_DCLICK, func)
 184     win.Connect(-1, -1, wxEVT_RIGHT_DCLICK,  func)
 185     win.Connect(-1, -1, wxEVT_LEAVE_WINDOW,  func)
 186     win.Connect(-1, -1, wxEVT_ENTER_WINDOW,  func)
 187
 188 # EVT_COMMAND
 189 def EVT_COMMAND(win, id, cmd, func):
 190     win.Connect(id, -1, cmd, func)
 191
 192 def EVT_COMMAND_RANGE(win, id1, id2, cmd, func):
 193     win.Connect(id1, id2, cmd, func)
 194
 195
 196 # Scrolling
 197 def EVT_SCROLL(win, func):
 198     win.Connect(-1, -1, wxEVT_SCROLL_TOP,       func)
 199     win.Connect(-1, -1, wxEVT_SCROLL_BOTTOM,    func)
 200     win.Connect(-1, -1, wxEVT_SCROLL_LINEUP,    func)
 201     win.Connect(-1, -1, wxEVT_SCROLL_LINEDOWN,  func)
 202     win.Connect(-1, -1, wxEVT_SCROLL_PAGEUP,    func)
 203     win.Connect(-1, -1, wxEVT_SCROLL_PAGEDOWN,  func)
 204     win.Connect(-1, -1, wxEVT_SCROLL_THUMBTRACK,func)
 205     win.Connect(-1, -1, wxEVT_SCROLL_THUMBRELEASE,func)
 206
 207 def EVT_SCROLL_TOP(win, func):
 208     win.Connect(-1, -1, wxEVT_SCROLL_TOP, func)
 209
 210 def EVT_SCROLL_BOTTOM(win, func):
 211     win.Connect(-1, -1, wxEVT_SCROLL_BOTTOM, func)
 212
 213 def EVT_SCROLL_LINEUP(win, func):
 214     win.Connect(-1, -1, wxEVT_SCROLL_LINEUP, func)
 215
 216 def EVT_SCROLL_LINEDOWN(win, func):
 217     win.Connect(-1, -1, wxEVT_SCROLL_LINEDOWN, func)
 218
 219 def EVT_SCROLL_PAGEUP(win, func):
 220     win.Connect(-1, -1, wxEVT_SCROLL_PAGEUP, func)
 221
 222 def EVT_SCROLL_PAGEDOWN(win, func):
 223     win.Connect(-1, -1, wxEVT_SCROLL_PAGEDOWN, func)
 224
 225 def EVT_SCROLL_THUMBTRACK(win, func):
 226     win.Connect(-1, -1, wxEVT_SCROLL_THUMBTRACK, func)
 227
 228 def EVT_SCROLL_THUMBRELEASE(win, func):
 229     win.Connect(-1, -1, wxEVT_SCROLL_THUMBRELEASE, func)
 230
 231
 232
 233 # Scrolling, with an id
 234 def EVT_COMMAND_SCROLL(win, id, func):
 235     win.Connect(id, -1, wxEVT_SCROLL_TOP,       func)
 236     win.Connect(id, -1, wxEVT_SCROLL_BOTTOM,    func)
 237     win.Connect(id, -1, wxEVT_SCROLL_LINEUP,    func)
 238     win.Connect(id, -1, wxEVT_SCROLL_LINEDOWN,  func)
 239     win.Connect(id, -1, wxEVT_SCROLL_PAGEUP,    func)
 240     win.Connect(id, -1, wxEVT_SCROLL_PAGEDOWN,  func)
 241     win.Connect(id, -1, wxEVT_SCROLL_THUMBTRACK,func)
 242     win.Connect(id, -1, wxEVT_SCROLL_THUMBRELEASE,func)
 243
 244 def EVT_COMMAND_SCROLL_TOP(win, id, func):
 245     win.Connect(id, -1, wxEVT_SCROLL_TOP, func)
 246
 247 def EVT_COMMAND_SCROLL_BOTTOM(win, id, func):
 248     win.Connect(id, -1, wxEVT_SCROLL_BOTTOM, func)
 249
 250 def EVT_COMMAND_SCROLL_LINEUP(win, id, func):
 251     win.Connect(id, -1, wxEVT_SCROLL_LINEUP, func)
 252
 253 def EVT_COMMAND_SCROLL_LINEDOWN(win, id, func):
 254     win.Connect(id, -1, wxEVT_SCROLL_LINEDOWN, func)
 255
 256 def EVT_COMMAND_SCROLL_PAGEUP(win, id, func):
 257     win.Connect(id, -1, wxEVT_SCROLL_PAGEUP, func)
 258
 259 def EVT_COMMAND_SCROLL_PAGEDOWN(win, id, func):
 260     win.Connect(id, -1, wxEVT_SCROLL_PAGEDOWN, func)
 261
 262 def EVT_COMMAND_SCROLL_THUMBTRACK(win, id, func):
 263     win.Connect(id, -1, wxEVT_SCROLL_THUMBTRACK, func)
 264
 265 def EVT_COMMAND_SCROLL_THUMBRELEASE(win, id, func):
 266     win.Connect(id, -1, wxEVT_SCROLL_THUMBRELEASE, func)
 267
 268 #---
 269 def EVT_SCROLLWIN(win, func):
 270     win.Connect(-1, -1, wxEVT_SCROLLWIN_TOP,         func)
 271     win.Connect(-1, -1, wxEVT_SCROLLWIN_BOTTOM,      func)
 272     win.Connect(-1, -1, wxEVT_SCROLLWIN_LINEUP,      func)
 273     win.Connect(-1, -1, wxEVT_SCROLLWIN_LINEDOWN,    func)
 274     win.Connect(-1, -1, wxEVT_SCROLLWIN_PAGEUP,      func)
 275     win.Connect(-1, -1, wxEVT_SCROLLWIN_PAGEDOWN,    func)
 276     win.Connect(-1, -1, wxEVT_SCROLLWIN_THUMBTRACK,  func)
 277     win.Connect(-1, -1, wxEVT_SCROLLWIN_THUMBRELEASE,func)
 278
 279 def EVT_SCROLLWIN_TOP(win, func):
 280     win.Connect(-1, -1, wxEVT_SCROLLWIN_TOP, func)
 281
 282 def EVT_SCROLLWIN_BOTTOM(win, func):
 283     win.Connect(-1, -1, wxEVT_SCROLLWIN_BOTTOM, func)
 284
 285 def EVT_SCROLLWIN_LINEUP(win, func):
 286     win.Connect(-1, -1, wxEVT_SCROLLWIN_LINEUP, func)
 287
 288 def EVT_SCROLLWIN_LINEDOWN(win, func):
 289     win.Connect(-1, -1, wxEVT_SCROLLWIN_LINEDOWN, func)
 290
 291 def EVT_SCROLLWIN_PAGEUP(win, func):
 292     win.Connect(-1, -1, wxEVT_SCROLLWIN_PAGEUP, func)
 293
 294 def EVT_SCROLLWIN_PAGEDOWN(win, func):
 295     win.Connect(-1, -1, wxEVT_SCROLLWIN_PAGEDOWN, func)
 296
 297 def EVT_SCROLLWIN_THUMBTRACK(win, func):
 298     win.Connect(-1, -1, wxEVT_SCROLLWIN_THUMBTRACK, func)
 299
 300 def EVT_SCROLLWIN_THUMBRELEASE(win, func):
 301     win.Connect(-1, -1, wxEVT_SCROLLWIN_THUMBRELEASE, func)
 302
 303
 304
 305 # Scrolling, with an id
 306 def EVT_COMMAND_SCROLLWIN(win, id, func):
 307     win.Connect(id, -1, wxEVT_SCROLLWIN_TOP,         func)
 308     win.Connect(id, -1, wxEVT_SCROLLWIN_BOTTOM,      func)
 309     win.Connect(id, -1, wxEVT_SCROLLWIN_LINEUP,      func)
 310     win.Connect(id, -1, wxEVT_SCROLLWIN_LINEDOWN,    func)
 311     win.Connect(id, -1, wxEVT_SCROLLWIN_PAGEUP,      func)
 312     win.Connect(id, -1, wxEVT_SCROLLWIN_PAGEDOWN,    func)
 313     win.Connect(id, -1, wxEVT_SCROLLWIN_THUMBTRACK,  func)
 314     win.Connect(id, -1, wxEVT_SCROLLWIN_THUMBRELEASE,func)
 315
 316 def EVT_COMMAND_SCROLLWIN_TOP(win, id, func):
 317     win.Connect(id, -1, wxEVT_SCROLLWIN_TOP, func)
 318
 319 def EVT_COMMAND_SCROLLWIN_BOTTOM(win, id, func):
 320     win.Connect(id, -1, wxEVT_SCROLLWIN_BOTTOM, func)
 321
 322 def EVT_COMMAND_SCROLLWIN_LINEUP(win, id, func):
 323     win.Connect(id, -1, wxEVT_SCROLLWIN_LINEUP, func)
 324
 325 def EVT_COMMAND_SCROLLWIN_LINEDOWN(win, id, func):
 326     win.Connect(id, -1, wxEVT_SCROLLWIN_LINEDOWN, func)
 327
 328 def EVT_COMMAND_SCROLLWIN_PAGEUP(win, id, func):
 329     win.Connect(id, -1, wxEVT_SCROLLWIN_PAGEUP, func)
 330
 331 def EVT_COMMAND_SCROLLWIN_PAGEDOWN(win, id, func):
 332     win.Connect(id, -1, wxEVT_SCROLLWIN_PAGEDOWN, func)
 333
 334 def EVT_COMMAND_SCROLLWIN_THUMBTRACK(win, id, func):
 335     win.Connect(id, -1, wxEVT_SCROLLWIN_THUMBTRACK, func)
 336
 337 def EVT_COMMAND_SCROLLWIN_THUMBRELEASE(win, id, func):
 338     win.Connect(id, -1, wxEVT_SCROLLWIN_THUMBRELEASE, func)
 339
 340
 341 # Convenience commands
 342 def EVT_BUTTON(win, id, func):
 343     win.Connect(id, -1, wxEVT_COMMAND_BUTTON_CLICKED, func)
 344
 345 def EVT_CHECKBOX(win, id, func):
 346     win.Connect(id, -1, wxEVT_COMMAND_CHECKBOX_CLICKED, func)
 347
 348 def EVT_CHOICE(win, id, func):
 349     win.Connect(id, -1, wxEVT_COMMAND_CHOICE_SELECTED, func)
 350
 351 def EVT_LISTBOX(win, id, func):
 352     win.Connect(id, -1, wxEVT_COMMAND_LISTBOX_SELECTED, func)
 353
 354 def EVT_LISTBOX_DCLICK(win, id, func):
 355     win.Connect(id, -1, wxEVT_COMMAND_LISTBOX_DOUBLECLICKED, func)
 356
 357 def EVT_TEXT(win, id, func):
 358     win.Connect(id, -1, wxEVT_COMMAND_TEXT_UPDATED, func)
 359
 360 def EVT_TEXT_ENTER(win, id, func):
 361     win.Connect(id, -1, wxEVT_COMMAND_TEXT_ENTER, func)
 362
 363 def EVT_MENU(win, id, func):
 364     win.Connect(id, -1, wxEVT_COMMAND_MENU_SELECTED, func)
 365
 366 def EVT_MENU_RANGE(win, id1, id2, func):
 367     win.Connect(id1, id2, wxEVT_COMMAND_MENU_SELECTED, func)
 368
 369 def EVT_SLIDER(win, id, func):
 370     win.Connect(id, -1, wxEVT_COMMAND_SLIDER_UPDATED, func)
 371
 372 def EVT_RADIOBOX(win, id, func):
 373     win.Connect(id, -1, wxEVT_COMMAND_RADIOBOX_SELECTED, func)
 374
 375 def EVT_RADIOBUTTON(win, id, func):
 376     win.Connect(id, -1, wxEVT_COMMAND_RADIOBUTTON_SELECTED, func)
 377
 378 def EVT_VLBOX(win, id, func):
 379     win.Connect(id, -1, wxEVT_COMMAND_VLBOX_SELECTED, func)
 380
 381 def EVT_COMBOBOX(win, id, func):
 382     win.Connect(id, -1, wxEVT_COMMAND_COMBOBOX_SELECTED, func)
 383
 384 def EVT_TOOL(win, id, func):
 385     win.Connect(id, -1, wxEVT_COMMAND_TOOL_CLICKED, func)
 386
 387 def EVT_TOOL_RANGE(win, id, id2, func):
 388     win.Connect(id, id2, wxEVT_COMMAND_TOOL_CLICKED, func)
 389
 390 def EVT_TOOL_RCLICKED(win, id, func):
 391     win.Connect(id, -1, wxEVT_COMMAND_TOOL_RCLICKED, func)
 392
 393 def EVT_TOOL_RCLICKED_RANGE(win, id, id2, func):
 394     win.Connect(id, id2, wxEVT_COMMAND_TOOL_RCLICKED, func)
 395
 396 def EVT_TOOL_ENTER(win, id, func):
 397     win.Connect(id, -1, wxEVT_COMMAND_TOOL_ENTER, func)
 398
 399 def EVT_CHECKLISTBOX(win, id, func):
 400     win.Connect(id, -1, wxEVT_COMMAND_CHECKLISTBOX_TOGGLED, func)
 401
 402 def EVT_SPINCTRL(win, id, func):
 403     win.Connect(id, -1, wxEVT_COMMAND_SPINCTRL_UPDATED, func)
 404
 405
 406
 407 # Generic command events
 408
 409 def EVT_COMMAND_LEFT_CLICK(win, id, func):
 410     win.Connect(id, -1, wxEVT_COMMAND_LEFT_CLICK, func)
 411
 412 def EVT_COMMAND_LEFT_DCLICK(win, id, func):
 413     win.Connect(id, -1, wxEVT_COMMAND_LEFT_DCLICK, func)
 414
 415 def EVT_COMMAND_RIGHT_CLICK(win, id, func):
 416     win.Connect(id, -1, wxEVT_COMMAND_RIGHT_CLICK, func)
 417
 418 def EVT_COMMAND_RIGHT_DCLICK(win, id, func):
 419     win.Connect(id, -1, wxEVT_COMMAND_RIGHT_DCLICK, func)
 420
 421 def EVT_COMMAND_SET_FOCUS(win, id, func):
 422     win.Connect(id, -1, wxEVT_COMMAND_SET_FOCUS, func)
 423
 424 def EVT_COMMAND_KILL_FOCUS(win, id, func):
 425     win.Connect(id, -1, wxEVT_COMMAND_KILL_FOCUS, func)
 426
 427 def EVT_COMMAND_ENTER(win, id, func):
 428     win.Connect(id, -1, wxEVT_COMMAND_ENTER, func)
 429
 430
 431 # wxNotebook events
 432 def EVT_NOTEBOOK_PAGE_CHANGED(win, id, func):
 433     win.Connect(id, -1, wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGED, func)
 434
 435 def EVT_NOTEBOOK_PAGE_CHANGING(win, id, func):
 436     win.Connect(id, -1, wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGING, func)
 437
 438
 439 # wxTreeCtrl events
 440 def EVT_TREE_BEGIN_DRAG(win, id, func):
 441     win.Connect(id, -1, wxEVT_COMMAND_TREE_BEGIN_DRAG, func)
 442
 443 def EVT_TREE_BEGIN_RDRAG(win, id, func):
 444     win.Connect(id, -1, wxEVT_COMMAND_TREE_BEGIN_RDRAG, func)
 445
 446 def EVT_TREE_BEGIN_LABEL_EDIT(win, id, func):
 447     win.Connect(id, -1, wxEVT_COMMAND_TREE_BEGIN_LABEL_EDIT, func)
 448
 449 def EVT_TREE_END_LABEL_EDIT(win, id, func):
 450     win.Connect(id, -1, wxEVT_COMMAND_TREE_END_LABEL_EDIT, func)
 451
 452 def EVT_TREE_GET_INFO(win, id, func):
 453     win.Connect(id, -1, wxEVT_COMMAND_TREE_GET_INFO, func)
 454
 455 def EVT_TREE_SET_INFO(win, id, func):
 456     win.Connect(id, -1, wxEVT_COMMAND_TREE_SET_INFO, func)
 457
 458 def EVT_TREE_ITEM_EXPANDED(win, id, func):
 459     win.Connect(id, -1, wxEVT_COMMAND_TREE_ITEM_EXPANDED, func)
 460
 461 def EVT_TREE_ITEM_EXPANDING(win, id, func):
 462     win.Connect(id, -1, wxEVT_COMMAND_TREE_ITEM_EXPANDING, func)
 463
 464 def EVT_TREE_ITEM_COLLAPSED(win, id, func):
 465     win.Connect(id, -1, wxEVT_COMMAND_TREE_ITEM_COLLAPSED, func)
 466
 467 def EVT_TREE_ITEM_COLLAPSING(win, id, func):
 468     win.Connect(id, -1, wxEVT_COMMAND_TREE_ITEM_COLLAPSING, func)
 469
 470 def EVT_TREE_SEL_CHANGED(win, id, func):
 471     win.Connect(id, -1, wxEVT_COMMAND_TREE_SEL_CHANGED, func)
 472
 473 def EVT_TREE_SEL_CHANGING(win, id, func):
 474     win.Connect(id, -1, wxEVT_COMMAND_TREE_SEL_CHANGING, func)
 475
 476 def EVT_TREE_KEY_DOWN(win, id, func):
 477     win.Connect(id, -1, wxEVT_COMMAND_TREE_KEY_DOWN, func)
 478
 479 def EVT_TREE_DELETE_ITEM(win, id, func):
 480     win.Connect(id, -1, wxEVT_COMMAND_TREE_DELETE_ITEM, func)
 481
 482 def EVT_TREE_ITEM_ACTIVATED(win, id, func):
 483     win.Connect(id, -1, wxEVT_COMMAND_TREE_ITEM_ACTIVATED, func)
 484
 485 def EVT_TREE_ITEM_RIGHT_CLICK(win, id, func):
 486     win.Connect(id, -1, wxEVT_COMMAND_TREE_ITEM_RIGHT_CLICK, func)
 487
 488 def EVT_TREE_ITEM_MIDDLE_CLICK(win, id, func):
 489     win.Connect(id, -1, wxEVT_COMMAND_TREE_ITEM_MIDDLE_CLICK, func)
 490
 491
 492 # wxSpinButton
 493 def EVT_SPIN_UP(win, id, func):
 494     win.Connect(id, -1, wxEVT_SCROLL_LINEUP, func)
 495
 496 def EVT_SPIN_DOWN(win, id, func):
 497     win.Connect(id, -1, wxEVT_SCROLL_LINEDOWN, func)
 498
 499 def EVT_SPIN(win, id, func):
 500     win.Connect(id, -1, wxEVT_SCROLL_THUMBTRACK,func)
 501
 502
 503
 504
 505 # wxTaskBarIcon
 506 def EVT_TASKBAR_MOVE(win, func):
 507     win.Connect(-1, -1, wxEVT_TASKBAR_MOVE, func)
 508
 509 def EVT_TASKBAR_LEFT_DOWN(win, func):
 510     win.Connect(-1, -1, wxEVT_TASKBAR_LEFT_DOWN, func)
 511
 512 def EVT_TASKBAR_LEFT_UP(win, func):
 513     win.Connect(-1, -1, wxEVT_TASKBAR_LEFT_UP, func)
 514
 515 def EVT_TASKBAR_RIGHT_DOWN(win, func):
 516     win.Connect(-1, -1, wxEVT_TASKBAR_RIGHT_DOWN, func)
 517
 518 def EVT_TASKBAR_RIGHT_UP(win, func):
 519     win.Connect(-1, -1, wxEVT_TASKBAR_RIGHT_UP, func)
 520
 521 def EVT_TASKBAR_LEFT_DCLICK(win, func):
 522     win.Connect(-1, -1, wxEVT_TASKBAR_LEFT_DCLICK, func)
 523
 524 def EVT_TASKBAR_RIGHT_DCLICK(win, func):
 525     win.Connect(-1, -1, wxEVT_TASKBAR_RIGHT_DCLICK, func)
 526
 527
 528 # wxSashWindow
 529 def EVT_SASH_DRAGGED(win, id, func):
 530     win.Connect(id, -1, wxEVT_SASH_DRAGGED, func)
 531
 532 def EVT_SASH_DRAGGED_RANGE(win, id1, id2, func):
 533     win.Connect(id1, id2, wxEVT_SASH_DRAGGED, func)
 534
 535 def EVT_QUERY_LAYOUT_INFO(win, func):
 536     win.Connect(-1, -1, wxEVT_EVT_QUERY_LAYOUT_INFO, func)
 537
 538 def EVT_CALCULATE_LAYOUT(win, func):
 539     win.Connect(-1, -1, wxEVT_EVT_CALCULATE_LAYOUT, func)
 540
 541
 542 # wxListCtrl
 543 def EVT_LIST_BEGIN_DRAG(win, id, func):
 544     win.Connect(id, -1, wxEVT_COMMAND_LIST_BEGIN_DRAG, func)
 545
 546 def EVT_LIST_BEGIN_RDRAG(win, id, func):
 547     win.Connect(id, -1, wxEVT_COMMAND_LIST_BEGIN_RDRAG, func)
 548
 549 def EVT_LIST_BEGIN_LABEL_EDIT(win, id, func):
 550     win.Connect(id, -1, wxEVT_COMMAND_LIST_BEGIN_LABEL_EDIT, func)
 551
 552 def EVT_LIST_END_LABEL_EDIT(win, id, func):
 553     win.Connect(id, -1, wxEVT_COMMAND_LIST_END_LABEL_EDIT, func)
 554
 555 def EVT_LIST_DELETE_ITEM(win, id, func):
 556     win.Connect(id, -1, wxEVT_COMMAND_LIST_DELETE_ITEM, func)
 557
 558 def EVT_LIST_DELETE_ALL_ITEMS(win, id, func):
 559     win.Connect(id, -1, wxEVT_COMMAND_LIST_DELETE_ALL_ITEMS, func)
 560
 561 def EVT_LIST_GET_INFO(win, id, func):
 562     win.Connect(id, -1, wxEVT_COMMAND_LIST_GET_INFO, func)
 563
 564 def EVT_LIST_SET_INFO(win, id, func):
 565     win.Connect(id, -1, wxEVT_COMMAND_LIST_SET_INFO, func)
 566
 567 def EVT_LIST_ITEM_SELECTED(win, id, func):
 568     win.Connect(id, -1,  wxEVT_COMMAND_LIST_ITEM_SELECTED, func)
 569
 570 def EVT_LIST_ITEM_DESELECTED(win, id, func):
 571     win.Connect(id, -1, wxEVT_COMMAND_LIST_ITEM_DESELECTED, func)
 572
 573 def EVT_LIST_KEY_DOWN(win, id, func):
 574     win.Connect(id, -1, wxEVT_COMMAND_LIST_KEY_DOWN, func)
 575
 576 def EVT_LIST_INSERT_ITEM(win, id, func):
 577     win.Connect(id, -1, wxEVT_COMMAND_LIST_INSERT_ITEM, func)
 578
 579 def EVT_LIST_COL_CLICK(win, id, func):
 580     win.Connect(id, -1, wxEVT_COMMAND_LIST_COL_CLICK, func)
 581
 582 def EVT_LIST_ITEM_RIGHT_CLICK(win, id, func):
 583     win.Connect(id, -1, wxEVT_COMMAND_LIST_ITEM_RIGHT_CLICK, func)
 584
 585 def EVT_LIST_ITEM_MIDDLE_CLICK(win, id, func):
 586     win.Connect(id, -1, wxEVT_COMMAND_LIST_ITEM_MIDDLE_CLICK, func)
 587
 588 def EVT_LIST_ITEM_ACTIVATED(win, id, func):
 589     win.Connect(id, -1,  wxEVT_COMMAND_LIST_ITEM_ACTIVATED, func)
 590
 591
 592
 593
 594 #wxSplitterWindow
 595 def EVT_SPLITTER_SASH_POS_CHANGING(win, id, func):
 596     win.Connect(id, -1, wxEVT_COMMAND_SPLITTER_SASH_POS_CHANGING, func)
 597
 598 def EVT_SPLITTER_SASH_POS_CHANGED(win, id, func):
 599     win.Connect(id, -1, wxEVT_COMMAND_SPLITTER_SASH_POS_CHANGED, func)
 600
 601 def EVT_SPLITTER_UNSPLIT(win, id, func):
 602     win.Connect(id, -1, wxEVT_COMMAND_SPLITTER_UNSPLIT, func)
 603
 604 def EVT_SPLITTER_DOUBLECLICKED(win, id, func):
 605     win.Connect(id, -1, wxEVT_COMMAND_SPLITTER_DOUBLECLICKED, func)
 606
 607
 608 # wxTimer
 609 def EVT_TIMER(win, id, func):
 610     win.Connect(id, -1, wxEVT_TIMER, func)
 611
 612 # wxProcess
 613 def EVT_END_PROCESS(eh, id, func):
 614     eh.Connect(id, -1, wxEVT_END_PROCESS, func)
 615
 616
 617 # wxJoyStick
 618 def EVT_JOY_DOWN(win, func):
 619     win.Connect(-1, -1, wxEVT_JOY_DOWN, func)
 620
 621 def EVT_JOY_UP(win, func):
 622     win.Connect(-1, -1, wxEVT_JOY_UP, func)
 623
 624 def EVT_JOY_MOVE(win, func):
 625     win.Connect(-1, -1, wxEVT_JOY_MOVE, func)
 626
 627 def EVT_JOY_ZMOVE(win, func):
 628     win.Connect(-1, -1, wxEVT_JOY_ZMOVE, func)
 629
 630 def EVT_JOYSTICK_EVENTS(win, func):
 631     win.Connect(-1, -1, wxEVT_JOY_DOWN, func)
 632     win.Connect(-1, -1, wxEVT_JOY_UP, func)
 633     win.Connect(-1, -1, wxEVT_JOY_MOVE, func)
 634     win.Connect(-1, -1, wxEVT_JOY_ZMOVE, func)
 635
 636 #----------------------------------------------------------------------
 637
 638 class wxTimer(wxPyTimer):
 639     def __init__(self, evtHandler = None, id = -1):
 640         if evtHandler is None:
 641             wxPyTimer.__init__(self, self.Notify)   # derived class must provide
 642                                                     # Notify(self) method.
 643         else:
 644             wxPyTimer.__init__(self, None)
 645             self.SetOwner(evtHandler, id)
 646
 647 #----------------------------------------------------------------------
 648 # Some wxWin methods can take "NULL" as parameters, but the shadow classes
 649 # expect an object with the SWIG pointer as a 'this' member.  This class
 650 # and instance fools the shadow into passing the NULL pointer.
 651
 652 ## NOTE:  This is not needed anymore as None can be passed instead and
 653 #         will be interpreted as NULL.
 654
 655 class _NullObj:
 656     this = 'NULL'       # SWIG converts this to (void*)0
 657
 658 NULL = _NullObj()
 659
 660
 661 #----------------------------------------------------------------------
 662 # aliases
 663
 664 wxColor      = wxColour
 665 wxNamedColor = wxNamedColour
 666
 667
 668 # backwards compatibility
 669 wxNoRefBitmap       = wxBitmap
 670 wxPyDefaultPosition = wxDefaultPosition
 671 wxPyDefaultSize     = wxDefaultSize
 672
 673 #----------------------------------------------------------------------
 674 # This helper function will take a wxPython object and convert it to
 675 # another wxPython object type.  This will not be able to create objects
 676 # that are derived from wxPython classes by the user, only those that are
 677 # actually part of wxPython and directly corespond to C++ objects.
 678 #
 679 # This is useful in situations where some method returns a generic
 680 # type such as wxWindow, but you know that it is actually some
 681 # derived type such as a wxTextCtrl.  You can't call wxTextCtrl specific
 682 # methods on a wxWindow object, but you can use this function to
 683 # create a wxTextCtrl object that will pass the same pointer to
 684 # the C++ code.  You use it like this:
 685 #
 686 #    textCtrl = wxPyTypeCast(window, "wxTextCtrl")
 687 #
 688 #
 689 # WARNING:  Using this function to type cast objects into types that
 690 #           they are not is not recommended and is likely to cause your
 691 #           program to crash...  Hard.
 692 #
 693
 694 def wxPyTypeCast(obj, typeStr):
 695     if obj is None:
 696         return None
 697     if hasattr(obj, "this"):
 698         newPtr = ptrcast(obj.this, typeStr+"_p")
 699     else:
 700         newPtr = ptrcast(obj, typeStr+"_p")
 701     theClass = globals()[typeStr+"Ptr"]
 702     theObj = theClass(newPtr)
 703     if hasattr(obj, "this"):
 704         theObj.thisown = obj.thisown
 705     return theObj
 706
 707
 708 #----------------------------------------------------------------------
 709 #----------------------------------------------------------------------
 710
 711 class wxPyOnDemandOutputWindow:
 712     def __init__(self, title = "wxPython: stdout/stderr"):
 713         self.frame  = None
 714         self.title  = title
 715         self.parent = None
 716
 717     def SetParent(self, parent):
 718         self.parent = parent
 719
 720     def OnCloseWindow(self, event):
 721         if self.frame != None:
 722             self.frame.Destroy()
 723         self.frame = None
 724         self.text  = None
 725
 726     # These methods provide the file-like output behaviour.
 727     def write(self, str):
 728         if not wxThread_IsMain():
 729             # Aquire the GUI mutex before making GUI calls.  Mutex is released
 730             # when locker is deleted a the end of this function.
 731             locker = wxMutexGuiLocker()
 732
 733         if not self.frame:
 734             self.frame = wxFrame(self.parent, -1, self.title)
 735             self.text  = wxTextCtrl(self.frame, -1, "",
 736                                     style = wxTE_MULTILINE|wxTE_READONLY)
 737             self.frame.SetSize(wxSize(450, 300))
 738             self.frame.Show(true)
 739             EVT_CLOSE(self.frame, self.OnCloseWindow)
 740         self.text.AppendText(str)
 741
 742     def close(self):
 743         if self.frame != None:
 744             if not wxThread_IsMain():
 745                 locker = wxMutexGuiLocker()
 746             self.frame.Close()
 747
 748
 749 _defRedirect = (wxPlatform == '__WXMSW__')
 750
 751 #----------------------------------------------------------------------
 752 # The main application class.  Derive from this and implement an OnInit
 753 # method that creates a frame and then calls self.SetTopWindow(frame)
 754
 755 class wxApp(wxPyApp):
 756     error = 'wxApp.error'
 757     outputWindowClass = wxPyOnDemandOutputWindow
 758
 759     def __init__(self, redirect=_defRedirect, filename=None):
 760         wxPyApp.__init__(self)
 761         self.stdioWin = None
 762         self.saveStdio = (sys.stdout, sys.stderr)
 763         if redirect:
 764             self.RedirectStdio(filename)
 765         # this initializes wxWindows and then calls our OnInit
 766         _wxStart(self.OnInit)
 767
 768
 769     def __del__(self):
 770         try:
 771             self.RestoreStdio()
 772         except:
 773             pass
 774
 775
 776     def SetTopWindow(self, frame):
 777         if self.stdioWin:
 778             self.stdioWin.SetParent(frame)
 779         wxPyApp.SetTopWindow(self, frame)
 780
 781
 782     def MainLoop(self):
 783         wxPyApp.MainLoop(self)
 784         self.RestoreStdio()
 785
 786
 787     def RedirectStdio(self, filename):
 788         if filename:
 789             sys.stdout = sys.stderr = open(filename, 'a')
 790         else:
 791             self.stdioWin = self.outputWindowClass() # wxPyOnDemandOutputWindow
 792             sys.stdout = sys.stderr = self.stdioWin
 793
 794
 795     def RestoreStdio(self):
 796         sys.stdout, sys.stderr = self.saveStdio
 797
 798
 799 #----------------------------------------------------------------------------
 800
 801 class wxPySimpleApp(wxApp):
 802     def __init__(self, flag=0):
 803         wxApp.__init__(self, flag)
 804     def OnInit(self):
 805         return true
 806
 807
 808 class wxPyWidgetTester(wxApp):
 809     def __init__(self, size = (250, 100)):
 810         self.size = size
 811         wxApp.__init__(self, 0)
 812
 813     def OnInit(self):
 814         self.frame = wxFrame(None, -1, "Widget Tester", pos=(0,0), size=self.size)
 815         self.SetTopWindow(self.frame)
 816         return true
 817
 818     def SetWidget(self, widgetClass, *args):
 819         w = apply(widgetClass, (self.frame,) + args)
 820         self.frame.Show(true)
 821
 822 #----------------------------------------------------------------------------
 823 # DO NOT hold any other references to this object.  This is how we know when
 824 # to cleanup system resources that wxWin is holding.  When this module is
 825 # unloaded, the refcount on __cleanMeUp goes to zero and it calls the
 826 # wxApp_CleanUp function.
 827
 828 class __wxPyCleanup:
 829     def __init__(self):
 830         self.cleanup = wxc.wxApp_CleanUp
 831     def __del__(self):
 832         self.cleanup()
 833
 834 __cleanMeUp = __wxPyCleanup()
 835 #----------------------------------------------------------------------------