wxPython/src/windows.i

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        windows.i
   3 // Purpose:     SWIG definitions of various window classes
   4 //
   5 // Author:      Robin Dunn
   6 //
   7 // Created:     6/24/97
   8 // RCS-ID:      $Id$
   9 // Copyright:   (c) 1998 by Total Control Software
  10 // Licence:     wxWindows license
  11 /////////////////////////////////////////////////////////////////////////////
  12
  13
  14 %module windows
  15
  16 %{
  17 #include "helpers.h"
  18 #include <wx/menuitem.h>
  19 #include <wx/tooltip.h>
  20 %}
  21
  22 //----------------------------------------------------------------------
  23
  24 %include typemaps.i
  25 %include my_typemaps.i
  26
  27 // Import some definitions of other classes, etc.
  28 %import _defs.i
  29 %import misc.i
  30 %import gdi.i
  31 %import clip_dnd.i
  32
  33 %pragma(python) code = "import wx"
  34
  35
  36 //----------------------------------------------------------------------
  37
  38 %{
  39     // Put some wx default wxChar* values into wxStrings.
  40     DECLARE_DEF_STRING(PanelNameStr);
  41     static const wxString wxPyEmptyString(wxT(""));
  42 %}
  43
  44 //---------------------------------------------------------------------------
  45
  46 class wxEvtHandler : public wxObject {
  47 public:
  48     wxEvtHandler();
  49
  50     bool ProcessEvent(wxEvent& event);
  51     void AddPendingEvent(wxEvent& event);
  52     //bool SearchEventTable(wxEventTable& table, wxEvent& event);
  53
  54     bool GetEvtHandlerEnabled();
  55     void SetEvtHandlerEnabled(bool enabled);
  56
  57     wxEvtHandler* GetNextHandler();
  58     wxEvtHandler* GetPreviousHandler();
  59     void SetNextHandler(wxEvtHandler* handler);
  60     void SetPreviousHandler(wxEvtHandler* handler);
  61
  62
  63     %addmethods {
  64         void Connect( int id, int lastId, int eventType, PyObject* func) {
  65             if (PyCallable_Check(func)) {
  66                 self->Connect(id, lastId, eventType,
  67                           (wxObjectEventFunction) &wxPyCallback::EventThunker,
  68                           new wxPyCallback(func));
  69             }
  70             else if (func == Py_None) {
  71                 self->Disconnect(id, lastId, eventType,
  72                                  (wxObjectEventFunction)
  73                                  &wxPyCallback::EventThunker);
  74             }
  75             else {
  76                 PyErr_SetString(PyExc_TypeError, "Expected callable object or None.");
  77             }
  78         }
  79
  80         bool Disconnect(int id, int lastId = -1,
  81                         wxEventType eventType = wxEVT_NULL) {
  82             return self->Disconnect(id, lastId, eventType,
  83                                    (wxObjectEventFunction)
  84                                     &wxPyCallback::EventThunker);
  85         }
  86     }
  87
  88     %addmethods {
  89         void _setOORInfo(PyObject* _self) {
  90             self->SetClientObject(new wxPyOORClientData(_self));
  91         }
  92     }
  93 };
  94
  95
  96 //----------------------------------------------------------------------
  97
  98 class wxValidator : public wxEvtHandler {
  99 public:
 100     wxValidator();
 101     //~wxValidator();
 102
 103     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
 104
 105     wxValidator* Clone();
 106     wxWindow* GetWindow();
 107     void SetWindow(wxWindow* window);
 108
 109     static bool IsSilent();
 110     static void SetBellOnError(int doIt = TRUE);
 111
 112 };
 113
 114
 115 //----------------------------------------------------------------------
 116 %{
 117 class wxPyValidator : public wxValidator {
 118     DECLARE_DYNAMIC_CLASS(wxPyValidator);
 119 public:
 120     wxPyValidator() {
 121     }
 122
 123     ~wxPyValidator() {
 124     }
 125
 126     wxObject* Clone() const {
 127         wxPyValidator* ptr = NULL;
 128         wxPyValidator* self = (wxPyValidator*)this;
 129
 130         wxPyBeginBlockThreads();
 131         if (self->m_myInst.findCallback("Clone")) {
 132             PyObject* ro;
 133             ro = self->m_myInst.callCallbackObj(Py_BuildValue("()"));
 134             if (ro) {
 135                 SWIG_GetPtrObj(ro, (void **)&ptr, "_wxPyValidator_p");
 136                 Py_DECREF(ro);
 137             }
 138         }
 139         wxPyEndBlockThreads();
 140
 141         // This is very dangerous!!! But is the only way I could find
 142         // to squash a memory leak.  Currently it is okay, but if the
 143         // validator architecture in wxWindows ever changes, problems
 144         // could arise.
 145         delete self;
 146         return ptr;
 147     }
 148
 149
 150     DEC_PYCALLBACK_BOOL_WXWIN(Validate);
 151     DEC_PYCALLBACK_BOOL_(TransferToWindow);
 152     DEC_PYCALLBACK_BOOL_(TransferFromWindow);
 153
 154     PYPRIVATE;
 155 };
 156
 157 IMP_PYCALLBACK_BOOL_WXWIN(wxPyValidator, wxValidator, Validate);
 158 IMP_PYCALLBACK_BOOL_(wxPyValidator, wxValidator, TransferToWindow);
 159 IMP_PYCALLBACK_BOOL_(wxPyValidator, wxValidator, TransferFromWindow);
 160
 161 IMPLEMENT_DYNAMIC_CLASS(wxPyValidator, wxValidator);
 162
 163 %}
 164
 165 class wxPyValidator : public wxValidator {
 166 public:
 167     wxPyValidator();
 168
 169     void _setCallbackInfo(PyObject* self, PyObject* _class, int incref=TRUE);
 170     %pragma(python) addtomethod = "__init__:self._setCallbackInfo(self, wxPyValidator, 1)"
 171
 172     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
 173 };
 174
 175 //----------------------------------------------------------------------
 176
 177 %apply int * INOUT { int* x, int* y };
 178
 179 class wxWindow : public wxEvtHandler {
 180 public:
 181     wxWindow(wxWindow* parent, const wxWindowID id,
 182              const wxPoint& pos = wxDefaultPosition,
 183              const wxSize& size = wxDefaultSize,
 184              long style = 0,
 185              const wxString& name = wxPyPanelNameStr);
 186     %name(wxPreWindow)wxWindow();
 187
 188     bool Create(wxWindow* parent, const wxWindowID id,
 189                 const wxPoint& pos = wxDefaultPosition,
 190                 const wxSize& size = wxDefaultSize,
 191                 long style = 0,
 192                 const wxString& name = wxPyPanelNameStr);
 193
 194     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
 195     %pragma(python) addtomethod = "wxPreWindow:val._setOORInfo(val)"
 196
 197
 198     void Center(int direction = wxBOTH);
 199     void Centre(int direction = wxBOTH);
 200     void CentreOnParent(int direction = wxBOTH );
 201     void CenterOnParent(int direction = wxBOTH );
 202     void CentreOnScreen(int direction = wxBOTH );
 203     void CenterOnScreen(int direction = wxBOTH );
 204
 205     void Clear();
 206
 207     // (uses apply'ed INOUT typemap, see above)
 208     %name(ClientToScreenXY)void ClientToScreen(int* x, int* y);
 209     wxPoint ClientToScreen(const wxPoint& pt);
 210
 211     bool Close(int force = FALSE);
 212     bool Destroy();
 213     void DestroyChildren();
 214     bool IsBeingDeleted();
 215 #ifdef __WXMSW__
 216     void DragAcceptFiles(bool accept);
 217 #endif
 218     void Enable(bool enable);
 219
 220     // Find child window by ID or name
 221     %name(FindWindowById) wxWindow* FindWindow(long id);
 222     %name(FindWindowByName) wxWindow* FindWindow(const wxString& name);
 223
 224     void Fit();
 225     wxColour GetBackgroundColour();
 226     wxBorder GetBorder() const;
 227
 228     //wxList& GetChildren();
 229     %addmethods {
 230         PyObject* GetChildren() {
 231             wxWindowList& list = self->GetChildren();
 232             return wxPy_ConvertList(&list, "wxWindow");
 233         }
 234     }
 235
 236     int  GetCharHeight();
 237     int  GetCharWidth();
 238     %name(GetClientSizeTuple) void GetClientSize(int *OUTPUT, int *OUTPUT);
 239     wxSize GetClientSize();
 240
 241     // get the origin of the client area of the window relative to the
 242     // window top left corner (the client area may be shifted because of
 243     // the borders, scrollbars, other decorations...)
 244     wxPoint GetClientAreaOrigin() const;
 245
 246     // get the client rectangle in window (i.e. client) coordinates
 247     wxRect GetClientRect() const;
 248
 249     wxLayoutConstraints * GetConstraints();
 250     wxEvtHandler* GetEventHandler();
 251
 252     wxFont GetFont();
 253     wxColour GetForegroundColour();
 254     wxWindow * GetGrandParent();
 255     %addmethods {
 256         long GetHandle() {
 257             return wxPyGetWinHandle(self); //(long)self->GetHandle();
 258         }
 259     }
 260     int GetId();
 261     wxString GetLabel();
 262     void SetLabel(const wxString& label);
 263     wxString GetName();
 264     wxWindow * GetParent();
 265     %name(GetPositionTuple) void GetPosition(int *OUTPUT, int *OUTPUT);
 266     wxPoint GetPosition();
 267     wxRect GetRect();
 268     int GetScrollThumb(int orientation);
 269     int GetScrollPos(int orientation);
 270     int GetScrollRange(int orientation);
 271     %name(GetSizeTuple) void GetSize(int *OUTPUT, int *OUTPUT);
 272     wxSize GetSize();
 273     void GetTextExtent(const wxString& string, int *OUTPUT, int *OUTPUT);
 274     %name(GetFullTextExtent)void GetTextExtent(const wxString& string,
 275                        int *OUTPUT, int *OUTPUT, int *OUTPUT, int* OUTPUT,
 276                        const wxFont* font = NULL); //, bool use16 = FALSE)
 277     wxString GetTitle();
 278     wxRegion GetUpdateRegion();
 279     long GetWindowStyleFlag();
 280     void SetWindowStyleFlag(long style);
 281     void SetWindowStyle(long style);
 282     bool HasScrollbar(int orient) const;
 283     bool Hide();
 284     wxHitTest HitTest(const wxPoint& pt);
 285     void InitDialog();
 286     bool IsEnabled();
 287     bool IsExposed( int x, int y, int w=0, int h=0 );
 288     %name(IsExposedPoint) bool IsExposed( const wxPoint& pt );
 289     %name(IsExposedRect)  bool IsExposed( const wxRect& rect );
 290     bool IsRetained();
 291     bool IsShown();
 292     bool IsTopLevel();
 293     void Layout();
 294     bool LoadFromResource(wxWindow* parent, const wxString& resourceName, const wxResourceTable* resourceTable = NULL);
 295     void Lower();
 296     void MakeModal(bool flag=TRUE);
 297     %name(MoveXY)void Move(int x, int y, int flags = wxSIZE_USE_EXISTING);
 298     void Move(const wxPoint& point, int flags = wxSIZE_USE_EXISTING);
 299
 300     wxEvtHandler* PopEventHandler(bool deleteHandler = FALSE);
 301     void PushEventHandler(wxEvtHandler* handler);
 302
 303         // find the given handler in the event handler chain and remove (but
 304         // not delete) it from the event handler chain, return TRUE if it was
 305         // found and FALSE otherwise (this also results in an assert failure so
 306         // this function should only be called when the handler is supposed to
 307         // be there)
 308     bool RemoveEventHandler(wxEvtHandler *handler);
 309
 310     %name(PopupMenuXY)bool PopupMenu(wxMenu *menu, int x, int y);
 311     bool PopupMenu(wxMenu *menu, const wxPoint& pos);
 312
 313     void Raise();
 314     void Refresh(bool eraseBackground = TRUE, const wxRect* rect = NULL);
 315     void RefreshRect(const wxRect& rect);
 316
 317     void AddChild(wxWindow* child);
 318     void RemoveChild(wxWindow* child);
 319     bool Reparent( wxWindow* newParent );
 320
 321     // (uses apply'ed INOUT typemap, see above)
 322     %name(ScreenToClientXY)void ScreenToClient(int *x, int *y);
 323     wxPoint ScreenToClient(const wxPoint& pt);
 324
 325     void ScrollWindow(int dx, int dy, const wxRect* rect = NULL);
 326     void SetAutoLayout(bool autoLayout);
 327     bool GetAutoLayout();
 328     void SetBackgroundColour(const wxColour& colour);
 329     void SetConstraints(wxLayoutConstraints *constraints);
 330     void UnsetConstraints(wxLayoutConstraints *constraints);
 331     void SetFocus();
 332     void SetFocusFromKbd();
 333     bool AcceptsFocus();
 334     void SetFont(const wxFont& font);
 335     void SetForegroundColour(const wxColour& colour);
 336     void SetId(int id);
 337     void SetName(const wxString& name);
 338     void SetScrollbar(int orientation, int position, int thumbSize, int range, int refresh = TRUE);
 339     void SetScrollPos(int orientation, int pos, bool refresh = TRUE);
 340
 341     %name(SetDimensions) void SetSize(int x, int y, int width, int height, int sizeFlags=wxSIZE_AUTO);
 342     %addmethods {
 343         void SetSize(const wxSize& size) {
 344             self->SetSize(size);
 345         }
 346
 347         void SetPosition(const wxPoint& pos, int flags = wxSIZE_USE_EXISTING) {
 348             self->Move(pos, flags);
 349         }
 350
 351         void SetRect(const wxRect& rect, int sizeFlags=wxSIZE_AUTO) {
 352             self->SetSize(rect, sizeFlags);
 353         }
 354     }
 355
 356     void SetSizeHints(int minW,    int minH,
 357                       int maxW=-1, int maxH=-1,
 358                       int incW=-1, int incH=-1);
 359     void SetVirtualSizeHints( int minW, int minH,
 360                               int maxW = -1, int maxH = -1 );
 361
 362     void SetVirtualSize( const wxSize &size );
 363     %name(SetVirtualSizeWH)void SetVirtualSize( int x, int y );
 364
 365     wxSize GetVirtualSize() const;
 366     %name(GetVirtualSizeTuple)void GetVirtualSize( int *OUTPUT, int *OUTPUT ) const;
 367
 368     %name(SetClientSizeWH)void SetClientSize(int width, int height);
 369     void SetClientSize(const wxSize& size);
 370     //void SetPalette(wxPalette* palette);
 371     bool SetCursor(const wxCursor& cursor);
 372     wxCursor& GetCursor();
 373     void SetEventHandler(wxEvtHandler* handler);
 374     void SetExtraStyle(long exStyle);
 375     void SetTitle(const wxString& title);
 376     bool Show(bool show=TRUE);
 377     bool TransferDataFromWindow();
 378     bool TransferDataToWindow();
 379     void UpdateWindowUI();
 380     bool Validate();
 381
 382     %name(ConvertDialogPointToPixels) wxPoint ConvertDialogToPixels(const wxPoint& pt);
 383     %name(ConvertDialogSizeToPixels)  wxSize  ConvertDialogToPixels(const wxSize& sz);
 384
 385     %name(DLG_PNT) wxPoint ConvertDialogToPixels(const wxPoint& pt);
 386     %name(DLG_SZE) wxSize  ConvertDialogToPixels(const wxSize& sz);
 387
 388     %name(ConvertPixelPointToDialog) wxPoint ConvertPixelsToDialog(const wxPoint& pt);
 389     %name(ConvertPixelSizeToDialog)  wxSize  ConvertPixelsToDialog(const wxSize& sz);
 390
 391     %name(SetToolTipString)void SetToolTip(const wxString &tip);
 392     void SetToolTip(wxToolTip *tooltip);
 393     wxToolTip* GetToolTip();
 394
 395     void SetSizer(wxSizer* sizer, bool deleteOld=TRUE);
 396     void SetSizerAndFit(wxSizer *sizer, bool deleteOld=TRUE);
 397     wxSizer* GetSizer();
 398
 399         // Track if this window is a member of a sizer
 400     void SetContainingSizer(wxSizer* sizer);
 401     wxSizer *GetContainingSizer() const;
 402
 403     wxValidator* GetValidator();
 404     void SetValidator(const wxValidator& validator);
 405
 406     void SetDropTarget(wxDropTarget* target);
 407     wxDropTarget* GetDropTarget();
 408     %pragma(python) addtomethod = "SetDropTarget:_args[0].thisown = 0"
 409
 410     wxSize GetBestSize();
 411     wxSize GetMaxSize();
 412
 413     void SetCaret(wxCaret *caret);
 414     wxCaret *GetCaret();
 415     %pragma(python) addtoclass = "# replaces broken shadow method
 416     def GetCaret(self, *_args, **_kwargs):
 417         from misc2 import wxCaretPtr
 418         val = apply(windowsc.wxWindow_GetCaret,(self,) + _args, _kwargs)
 419         if val: val = wxCaretPtr(val)
 420         return val
 421     "
 422
 423     void Freeze();
 424     void Thaw();
 425     void Update();
 426
 427     wxString GetHelpText();
 428     void SetHelpText(const wxString& helpText);
 429     void SetHelpTextForId(const wxString& text);
 430
 431     bool ScrollLines(int lines);
 432     bool ScrollPages(int pages);
 433     bool LineUp();
 434     bool LineDown();
 435     bool PageUp();
 436     bool PageDown();
 437
 438     static wxWindow* FindFocus();
 439     static int NewControlId();
 440     static int NextControlId(int id);
 441     static int PrevControlId(int id);
 442
 443     void SetAcceleratorTable(const wxAcceleratorTable& accel);
 444     wxAcceleratorTable *GetAcceleratorTable();
 445
 446 #ifdef __WXMSW__
 447     // A way to do the native draw first...  Too bad it isn't in wxGTK too.
 448     void OnPaint(wxPaintEvent& event);
 449 #endif
 450
 451     wxWindow* GetDefaultItem();
 452     wxWindow* SetDefaultItem(wxWindow *btn);
 453     void SetTmpDefaultItem(wxWindow *win);
 454
 455     // move the mouse to the specified position
 456     void WarpPointer(int x, int y);
 457
 458     // start or end mouse capture, these functions maintain the stack of
 459     // windows having captured the mouse and after calling ReleaseMouse()
 460     // the mouse is not released but returns to the window which had had
 461     // captured it previously (if any)
 462     void CaptureMouse();
 463     void ReleaseMouse();
 464
 465     // get the window which currently captures the mouse or NULL
 466     static wxWindow *GetCapture();
 467
 468     // does this window have the capture?
 469     bool HasCapture() const;
 470 };
 471
 472
 473
 474
 475 %pragma(python) code = "
 476 def wxDLG_PNT(win, point_or_x, y=None):
 477     if y is None:
 478         return win.ConvertDialogPointToPixels(point_or_x)
 479     else:
 480         return win.ConvertDialogPointToPixels(wxPoint(point_or_x, y))
 481
 482 def wxDLG_SZE(win, size_width, height=None):
 483     if height is None:
 484         return win.ConvertDialogSizeToPixels(size_width)
 485     else:
 486         return win.ConvertDialogSizeToPixels(wxSize(size_width, height))
 487 "
 488
 489
 490 #ifdef __WXMSW__
 491 %inline %{
 492 wxWindow* wxWindow_FromHWND(unsigned long hWnd) {
 493     wxWindow* win = new wxWindow;
 494     win->SetHWND(hWnd);
 495     win->SubclassWin(hWnd);
 496     return win;
 497 }
 498 %}
 499 #endif
 500
 501
 502 // Unfortunatly the names of these new static methods clash with the
 503 // names wxPython has been using forever for the overloaded
 504 // wxWindow::FindWindow, so instead of swigging them as statics create
 505 // standalone functions for them.
 506 %inline %{
 507 wxWindow* wxFindWindowById( long id, const wxWindow *parent = NULL ) {
 508     return wxWindow::FindWindowById(id, parent);
 509 }
 510
 511 wxWindow* wxFindWindowByName( const wxString& name,
 512                               const wxWindow *parent = NULL ) {
 513      return wxWindow::FindWindowByName(name, parent);
 514 }
 515
 516 wxWindow* wxFindWindowByLabel( const wxString& label,
 517                                const wxWindow *parent = NULL ) {
 518     return wxWindow::FindWindowByLabel(label, parent);
 519 }
 520 %}
 521
 522
 523 //---------------------------------------------------------------------------
 524
 525 class wxPanel : public wxWindow {
 526 public:
 527     wxPanel(wxWindow* parent,
 528             const wxWindowID id,
 529             const wxPoint& pos = wxDefaultPosition,
 530             const wxSize& size = wxDefaultSize,
 531             long style = wxTAB_TRAVERSAL,
 532             const wxString& name = wxPyPanelNameStr);
 533     %name(wxPrePanel)wxPanel();
 534
 535     bool Create(wxWindow* parent,
 536                 const wxWindowID id,
 537                 const wxPoint& pos = wxDefaultPosition,
 538                 const wxSize& size = wxDefaultSize,
 539                 long style = wxTAB_TRAVERSAL,
 540                 const wxString& name = wxPyPanelNameStr);
 541
 542     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
 543     %pragma(python) addtomethod = "wxPrePanel:val._setOORInfo(val)"
 544
 545     void InitDialog();
 546
 547 };
 548
 549 //---------------------------------------------------------------------------
 550
 551
 552 // TODO: Add wrappers for the wxScrollHelper class, make wxScrolledWindow
 553 //       derive from it and wxPanel.
 554
 555
 556 class wxScrolledWindow : public wxPanel {
 557 public:
 558     wxScrolledWindow(wxWindow* parent,
 559                      const wxWindowID id = -1,
 560                      const wxPoint& pos = wxDefaultPosition,
 561                      const wxSize& size = wxDefaultSize,
 562                      long style = wxHSCROLL | wxVSCROLL,
 563                      const wxString& name = wxPyPanelNameStr);
 564     %name(wxPreScrolledWindow)wxScrolledWindow();
 565
 566     bool Create(wxWindow* parent,
 567                 const wxWindowID id = -1,
 568                 const wxPoint& pos = wxDefaultPosition,
 569                 const wxSize& size = wxDefaultSize,
 570                 long style = wxHSCROLL | wxVSCROLL,
 571                 const wxString& name = wxPyPanelNameStr);
 572
 573     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
 574     %pragma(python) addtomethod = "wxPreScrolledWindow:val._setOORInfo(val)"
 575
 576     void EnableScrolling(bool xScrolling, bool yScrolling);
 577     int GetScrollPageSize(int orient);
 578     void GetScrollPixelsPerUnit(int* OUTPUT, int* OUTPUT);
 579     wxWindow* GetTargetWindow();
 580     bool IsRetained();
 581     void PrepareDC(wxDC& dc);
 582     void Scroll(int x, int y);
 583     void SetScrollbars(int pixelsPerUnitX, int pixelsPerUnitY,
 584                        int noUnitsX, int noUnitsY,
 585                        int xPos = 0, int yPos = 0, int noRefresh=FALSE);
 586     void SetScrollPageSize(int orient, int pageSize);
 587     void SetTargetWindow(wxWindow* window);
 588     void GetViewStart(int* OUTPUT, int* OUTPUT);
 589     %pragma(python) addtoclass = "ViewStart = GetViewStart"
 590
 591     %name(CalcScrolledPosition1)wxPoint CalcScrolledPosition(const wxPoint& pt);
 592     %name(CalcScrolledPosition2)void CalcScrolledPosition( int x, int y, int *OUTPUT, int *OUTPUT);
 593
 594     %name(CalcUnscrolledPosition1)wxPoint CalcUnscrolledPosition(const wxPoint& pt);
 595     %name(CalcUnscrolledPosition2)void CalcUnscrolledPosition( int x, int y, int *OUTPUT, int *OUTPUT);
 596
 597     %pragma(python) addtoclass = "
 598     def CalcScrolledPosition(self, *args):
 599         if len(args) == 1:
 600             return apply(self.CalcScrolledPosition1, args)
 601         elif len(args) == 2:
 602             return apply(self.CalcScrolledPosition2, args)
 603         else:
 604             raise TypeError, 'Invalid parameters: only (x,y) or (point) allowed'
 605
 606     def CalcUnscrolledPosition(self, *args):
 607         if len(args) == 1:
 608             return apply(self.CalcUnscrolledPosition1, args)
 609         elif len(args) == 2:
 610             return apply(self.CalcUnscrolledPosition2, args)
 611         else:
 612             raise TypeError, 'Invalid parameters: only (x,y) or (point) allowed'
 613 "
 614
 615     void SetScale(double xs, double ys);
 616     double GetScaleX();
 617     double GetScaleY();
 618
 619     void AdjustScrollbars();
 620
 621     bool Layout();
 622
 623     // Set the x, y scrolling increments.
 624     void SetScrollRate( int xstep, int ystep );
 625
 626 };
 627
 628 //----------------------------------------------------------------------
 629
 630
 631 class wxMenu : public wxEvtHandler {
 632 public:
 633     wxMenu(const wxString& title = wxPyEmptyString, long style = 0);
 634
 635     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
 636
 637     void Append(int id, const wxString& item,
 638                 const wxString& helpString = wxPyEmptyString,
 639                 wxItemKind kind = wxITEM_NORMAL);
 640     %name(AppendMenu)void Append(int id, const wxString& item, wxMenu *subMenu,
 641                                  const wxString& helpString = wxPyEmptyString);
 642     %name(AppendItem)void Append(const wxMenuItem* item);
 643     void AppendCheckItem(int id,
 644                          const wxString& text,
 645                          const wxString& help = wxPyEmptyString);
 646     void AppendRadioItem(int id,
 647                          const wxString& text,
 648                          const wxString& help = wxPyEmptyString);
 649     void AppendSeparator();
 650
 651
 652     void Insert(size_t pos,
 653                 int id,
 654                 const wxString& text,
 655                 const wxString& help = wxPyEmptyString,
 656                 wxItemKind kind = wxITEM_NORMAL);
 657     void InsertSeparator(size_t pos);
 658     void InsertCheckItem(size_t pos,
 659                          int id,
 660                          const wxString& text,
 661                          const wxString& help = wxPyEmptyString);
 662     void InsertRadioItem(size_t pos,
 663                          int id,
 664                          const wxString& text,
 665                          const wxString& help = wxPyEmptyString);
 666     %name(InsertMenu)void Insert(size_t pos,
 667                                  int id,
 668                                  const wxString& text,
 669                                  wxMenu *submenu,
 670                                  const wxString& help = wxPyEmptyString);
 671     %name(InsertItem)bool Insert(size_t pos, wxMenuItem *item);
 672
 673
 674     void Prepend(int id,
 675                  const wxString& text,
 676                  const wxString& help = wxPyEmptyString,
 677                  wxItemKind kind = wxITEM_NORMAL);
 678     void PrependSeparator();
 679     void PrependCheckItem(int id,
 680                           const wxString& text,
 681                           const wxString& help = wxPyEmptyString);
 682     void PrependRadioItem(int id,
 683                           const wxString& text,
 684                           const wxString& help = wxPyEmptyString);
 685     %name(PrependMenu)void Prepend(int id,
 686                                    const wxString& text,
 687                                    wxMenu *submenu,
 688                                    const wxString& help = wxPyEmptyString);
 689     %name(PrependItem)void Prepend(wxMenuItem *item);
 690
 691
 692     void Break();
 693     void Check(int id, bool flag);
 694     bool IsChecked(int id);
 695     void Enable(int id, bool enable);
 696     bool IsEnabled(int id);
 697
 698     int FindItem(const wxString& itemString);
 699     %name(FindItemById)wxMenuItem* FindItem(int id/*, wxMenu **menu = NULL*/);
 700
 701     wxString GetTitle();
 702     void SetTitle(const wxString& title);
 703
 704     wxString GetLabel(int id);
 705     void SetLabel(int id, const wxString& label);
 706
 707     wxString GetHelpString(int id);
 708     void SetHelpString(int id, const wxString& helpString);
 709     void UpdateUI(wxEvtHandler* source = NULL);
 710
 711     bool Delete(int id);
 712     %name(DeleteItem)bool Delete(wxMenuItem *item);
 713     wxMenuItem *Remove(int id);
 714     %name(RemoveItem) wxMenuItem *Remove(wxMenuItem *item);
 715
 716
 717
 718
 719     %addmethods {
 720         void Destroy() { delete self; }
 721     }
 722     %name(DestroyId)bool Destroy(int id);
 723     %name(DestroyItem)bool Destroy(wxMenuItem *item);
 724
 725     size_t GetMenuItemCount();
 726     //wxMenuItemList& GetMenuItems();
 727     %addmethods {
 728         PyObject* GetMenuItems() {
 729             wxMenuItemList& list = self->GetMenuItems();
 730             return wxPy_ConvertList(&list, "wxMenuItem");
 731         }
 732     }
 733
 734     void SetEventHandler(wxEvtHandler *handler);
 735     wxEvtHandler *GetEventHandler();
 736
 737     void SetInvokingWindow(wxWindow *win);
 738     wxWindow *GetInvokingWindow();
 739
 740     long GetStyle();
 741
 742     bool IsAttached();
 743
 744     void SetParent(wxMenu *parent);
 745     wxMenu *GetParent();
 746 };
 747
 748
 749 //----------------------------------------------------------------------
 750
 751 class wxMenuBar : public wxWindow {
 752 public:
 753     wxMenuBar(long style = 0);
 754
 755     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
 756
 757     bool Append(wxMenu *menu, const wxString& title);
 758     bool Insert(size_t pos, wxMenu *menu, const wxString& title);
 759     size_t GetMenuCount();
 760     wxMenu *GetMenu(size_t pos);
 761     wxMenu *Replace(size_t pos, wxMenu *menu, const wxString& title);
 762     wxMenu *Remove(size_t pos);
 763     void EnableTop(size_t pos, bool enable);
 764     void SetLabelTop(size_t pos, const wxString& label);
 765     wxString GetLabelTop(size_t pos);
 766     int FindMenu(const wxString& title);
 767     int FindMenuItem(const wxString& menuString, const wxString& itemString);
 768     %name(FindItemById)wxMenuItem* FindItem(int id/*, wxMenu **menu = NULL*/);
 769     void Enable(int id, bool enable);
 770     void Check(int id, bool check);
 771     bool IsChecked(int id);
 772     bool IsEnabled(int id);
 773
 774     void SetLabel(int id, const wxString &label);
 775     wxString GetLabel(int id);
 776
 777     void SetHelpString(int id, const wxString& helpString);
 778     wxString GetHelpString(int id);
 779
 780 };
 781
 782
 783 //----------------------------------------------------------------------
 784
 785 class wxMenuItem : public wxObject {
 786 public:
 787     wxMenuItem(wxMenu* parentMenu=NULL, int id=wxID_SEPARATOR,
 788                const wxString& text = wxPyEmptyString,
 789                const wxString& help = wxPyEmptyString,
 790                wxItemKind kind = wxITEM_NORMAL,
 791                wxMenu* subMenu = NULL);
 792
 793
 794     wxMenu *GetMenu();
 795     void SetId(int id);
 796     int  GetId();
 797     bool IsSeparator();
 798     void SetText(const wxString& str);
 799     wxString GetLabel();
 800     const wxString& GetText();
 801     wxItemKind GetKind();
 802     void SetCheckable(bool checkable);
 803     bool IsCheckable();
 804     bool IsSubMenu();
 805     void SetSubMenu(wxMenu *menu);
 806     wxMenu *GetSubMenu();
 807     void Enable(bool enable = TRUE);
 808     bool IsEnabled();
 809     void Check(bool check = TRUE);
 810     bool IsChecked();
 811     void Toggle();
 812     void SetHelp(const wxString& str);
 813     const wxString& GetHelp();
 814     wxAcceleratorEntry *GetAccel();
 815     void SetAccel(wxAcceleratorEntry *accel);
 816
 817     static wxString GetLabelFromText(const wxString& text);
 818 //    static wxAcceleratorEntry *GetAccelFromString(const wxString& label);
 819
 820     // wxOwnerDrawn methods
 821 #ifdef __WXMSW__
 822     void SetFont(const wxFont& font);
 823     wxFont GetFont();
 824     void SetTextColour(const wxColour& colText);
 825     wxColour GetTextColour();
 826     void SetBackgroundColour(const wxColour& colBack);
 827     wxColour GetBackgroundColour();
 828     void SetBitmaps(const wxBitmap& bmpChecked,
 829                     const wxBitmap& bmpUnchecked = wxNullBitmap);
 830     void SetBitmap(const wxBitmap& bmpChecked);
 831     wxBitmap GetBitmap(bool bChecked = TRUE);
 832     void SetMarginWidth(int nWidth);
 833     int GetMarginWidth();
 834     static int GetDefaultMarginWidth();
 835     //void SetName(const wxString& strName);
 836     //const wxString& GetName();
 837     //void SetCheckable(bool checkable);
 838     //bool IsCheckable();
 839     bool IsOwnerDrawn();
 840     void ResetOwnerDrawn();
 841 #endif
 842 };
 843
 844 //---------------------------------------------------------------------------
 845
 846
 847