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     //bool FakePopupMenu(wxMenu* menu, int x, int y);
 220     %name(FindWindowById) wxWindow* FindWindow(long id);
 221     %name(FindWindowByName) wxWindow* FindWindow(const wxString& name);
 222     void Fit();
 223     wxColour GetBackgroundColour();
 224     wxBorder GetBorder() const;
 225
 226     //wxList& GetChildren();
 227     %addmethods {
 228         PyObject* GetChildren() {
 229             wxWindowList& list = self->GetChildren();
 230             return wxPy_ConvertList(&list, "wxWindow");
 231         }
 232     }
 233
 234     int  GetCharHeight();
 235     int  GetCharWidth();
 236     %name(GetClientSizeTuple) void GetClientSize(int *OUTPUT, int *OUTPUT);
 237     wxSize GetClientSize();
 238
 239     // get the origin of the client area of the window relative to the
 240     // window top left corner (the client area may be shifted because of
 241     // the borders, scrollbars, other decorations...)
 242     wxPoint GetClientAreaOrigin() const;
 243
 244     // get the client rectangle in window (i.e. client) coordinates
 245     wxRect GetClientRect() const;
 246
 247     wxLayoutConstraints * GetConstraints();
 248     wxEvtHandler* GetEventHandler();
 249
 250     wxFont GetFont();
 251     wxColour GetForegroundColour();
 252     wxWindow * GetGrandParent();
 253     %addmethods {
 254         long GetHandle() {
 255             return wxPyGetWinHandle(self); //(long)self->GetHandle();
 256         }
 257     }
 258     int GetId();
 259     wxString GetLabel();
 260     void SetLabel(const wxString& label);
 261     wxString GetName();
 262     wxWindow * GetParent();
 263     %name(GetPositionTuple) void GetPosition(int *OUTPUT, int *OUTPUT);
 264     wxPoint GetPosition();
 265     wxRect GetRect();
 266     int GetScrollThumb(int orientation);
 267     int GetScrollPos(int orientation);
 268     int GetScrollRange(int orientation);
 269     %name(GetSizeTuple) void GetSize(int *OUTPUT, int *OUTPUT);
 270     wxSize GetSize();
 271     void GetTextExtent(const wxString& string, int *OUTPUT, int *OUTPUT);
 272     %name(GetFullTextExtent)void GetTextExtent(const wxString& string,
 273                        int *OUTPUT, int *OUTPUT, int *OUTPUT, int* OUTPUT,
 274                        const wxFont* font = NULL); //, bool use16 = FALSE)
 275     wxString GetTitle();
 276     wxRegion GetUpdateRegion();
 277     long GetWindowStyleFlag();
 278     void SetWindowStyleFlag(long style);
 279     void SetWindowStyle(long style);
 280     bool HasScrollbar(int orient) const;
 281     bool Hide();
 282     wxHitTest HitTest(const wxPoint& pt);
 283     void InitDialog();
 284     bool IsEnabled();
 285     bool IsExposed( int x, int y, int w=0, int h=0 );
 286     %name(IsExposedPoint) bool IsExposed( const wxPoint& pt );
 287     %name(IsExposedRect)  bool IsExposed( const wxRect& rect );
 288     bool IsRetained();
 289     bool IsShown();
 290     bool IsTopLevel();
 291     void Layout();
 292     bool LoadFromResource(wxWindow* parent, const wxString& resourceName, const wxResourceTable* resourceTable = NULL);
 293     void Lower();
 294     void MakeModal(bool flag=TRUE);
 295     %name(MoveXY)void Move(int x, int y, int flags = wxSIZE_USE_EXISTING);
 296     void Move(const wxPoint& point, int flags = wxSIZE_USE_EXISTING);
 297
 298     wxEvtHandler* PopEventHandler(bool deleteHandler = FALSE);
 299     void PushEventHandler(wxEvtHandler* handler);
 300
 301         // find the given handler in the event handler chain and remove (but
 302         // not delete) it from the event handler chain, return TRUE if it was
 303         // found and FALSE otherwise (this also results in an assert failure so
 304         // this function should only be called when the handler is supposed to
 305         // be there)
 306     bool RemoveEventHandler(wxEvtHandler *handler);
 307
 308     %name(PopupMenuXY)bool PopupMenu(wxMenu *menu, int x, int y);
 309     bool PopupMenu(wxMenu *menu, const wxPoint& pos);
 310
 311     void Raise();
 312     void Refresh(bool eraseBackground = TRUE, const wxRect* rect = NULL);
 313     void RefreshRect(const wxRect& rect);
 314
 315     void RemoveChild(wxWindow* child);
 316     bool Reparent( wxWindow* newParent );
 317
 318     // (uses apply'ed INOUT typemap, see above)
 319     %name(ScreenToClientXY)void ScreenToClient(int *x, int *y);
 320     wxPoint ScreenToClient(const wxPoint& pt);
 321
 322     void ScrollWindow(int dx, int dy, const wxRect* rect = NULL);
 323     void SetAutoLayout(bool autoLayout);
 324     bool GetAutoLayout();
 325     void SetBackgroundColour(const wxColour& colour);
 326     void SetConstraints(wxLayoutConstraints *constraints);
 327     void UnsetConstraints(wxLayoutConstraints *constraints);
 328     void SetFocus();
 329     void SetFocusFromKbd();
 330     bool AcceptsFocus();
 331     void SetFont(const wxFont& font);
 332     void SetForegroundColour(const wxColour& colour);
 333     void SetId(int id);
 334     void SetName(const wxString& name);
 335     void SetScrollbar(int orientation, int position, int thumbSize, int range, int refresh = TRUE);
 336     void SetScrollPos(int orientation, int pos, bool refresh = TRUE);
 337
 338     %name(SetDimensions) void SetSize(int x, int y, int width, int height, int sizeFlags=wxSIZE_AUTO);
 339     %addmethods {
 340         void SetSize(const wxSize& size) {
 341             self->SetSize(size);
 342         }
 343
 344         void SetPosition(const wxPoint& pos, int flags = wxSIZE_USE_EXISTING) {
 345             self->Move(pos, flags);
 346         }
 347
 348         void SetRect(const wxRect& rect, int sizeFlags=wxSIZE_AUTO) {
 349             self->SetSize(rect, sizeFlags);
 350         }
 351     }
 352
 353     void SetSizeHints(int minW,    int minH,
 354                       int maxW=-1, int maxH=-1,
 355                       int incW=-1, int incH=-1);
 356     void SetVirtualSizeHints( int minW, int minH,
 357                               int maxW = -1, int maxH = -1 );
 358
 359     void SetVirtualSize( const wxSize &size );
 360     %name(SetVirtualSizeWH)void SetVirtualSize( int x, int y );
 361
 362     wxSize GetVirtualSize() const;
 363     %name(GetVirtualSizeTuple)void GetVirtualSize( int *OUTPUT, int *OUTPUT ) const;
 364
 365     %name(SetClientSizeWH)void SetClientSize(int width, int height);
 366     void SetClientSize(const wxSize& size);
 367     //void SetPalette(wxPalette* palette);
 368     void SetCursor(const wxCursor& cursor);
 369     void SetEventHandler(wxEvtHandler* handler);
 370     void SetExtraStyle(long exStyle);
 371     void SetTitle(const wxString& title);
 372     bool Show(bool show=TRUE);
 373     bool TransferDataFromWindow();
 374     bool TransferDataToWindow();
 375     void UpdateWindowUI();
 376     bool Validate();
 377
 378     %name(ConvertDialogPointToPixels) wxPoint ConvertDialogToPixels(const wxPoint& pt);
 379     %name(ConvertDialogSizeToPixels)  wxSize  ConvertDialogToPixels(const wxSize& sz);
 380
 381     %name(DLG_PNT) wxPoint ConvertDialogToPixels(const wxPoint& pt);
 382     %name(DLG_SZE) wxSize  ConvertDialogToPixels(const wxSize& sz);
 383
 384     %name(ConvertPixelPointToDialog) wxPoint ConvertPixelsToDialog(const wxPoint& pt);
 385     %name(ConvertPixelSizeToDialog)  wxSize  ConvertPixelsToDialog(const wxSize& sz);
 386
 387     %name(SetToolTipString)void SetToolTip(const wxString &tip);
 388     void SetToolTip(wxToolTip *tooltip);
 389     wxToolTip* GetToolTip();
 390
 391     void SetSizer(wxSizer* sizer, bool deleteOld=TRUE);
 392     void SetSizerAndFit(wxSizer *sizer, bool deleteOld=TRUE);
 393     wxSizer* GetSizer();
 394
 395         // Track if this window is a member of a sizer
 396     void SetContainingSizer(wxSizer* sizer);
 397     wxSizer *GetContainingSizer() const;
 398
 399     wxValidator* GetValidator();
 400     void SetValidator(const wxValidator& validator);
 401
 402 #ifndef __WXMAC__
 403     void SetDropTarget(wxDropTarget* target);
 404     wxDropTarget* GetDropTarget();
 405     %pragma(python) addtomethod = "SetDropTarget:_args[0].thisown = 0"
 406 #endif
 407
 408     wxSize GetBestSize();
 409     wxSize GetMaxSize();
 410
 411     void SetCaret(wxCaret *caret);
 412     wxCaret *GetCaret();
 413     %pragma(python) addtoclass = "# replaces broken shadow method
 414     def GetCaret(self, *_args, **_kwargs):
 415         from misc2 import wxCaretPtr
 416         val = apply(windowsc.wxWindow_GetCaret,(self,) + _args, _kwargs)
 417         if val: val = wxCaretPtr(val)
 418         return val
 419     "
 420
 421     void Freeze();
 422     void Thaw();
 423     void Update();
 424
 425     wxString GetHelpText();
 426     void SetHelpText(const wxString& helpText);
 427     void SetHelpTextForId(const wxString& text);
 428
 429     bool ScrollLines(int lines);
 430     bool ScrollPages(int pages);
 431     bool LineUp();
 432     bool LineDown();
 433     bool PageUp();
 434     bool PageDown();
 435
 436     static wxWindow* FindFocus();
 437     static int NewControlId();
 438     static int NextControlId(int id);
 439     static int PrevControlId(int id);
 440
 441     void SetAcceleratorTable(const wxAcceleratorTable& accel);
 442     wxAcceleratorTable *GetAcceleratorTable();
 443
 444 #ifdef __WXMSW__
 445     // A way to do the native draw first...  Too bad it isn't in wxGTK too.
 446     void OnPaint(wxPaintEvent& event);
 447 #endif
 448
 449     wxWindow* GetDefaultItem();
 450     wxWindow* SetDefaultItem(wxWindow *btn);
 451     void SetTmpDefaultItem(wxWindow *win);
 452
 453     // move the mouse to the specified position
 454     void WarpPointer(int x, int y);
 455
 456     // start or end mouse capture, these functions maintain the stack of
 457     // windows having captured the mouse and after calling ReleaseMouse()
 458     // the mouse is not released but returns to the window which had had
 459     // captured it previously (if any)
 460     void CaptureMouse();
 461     void ReleaseMouse();
 462
 463     // get the window which currently captures the mouse or NULL
 464     static wxWindow *GetCapture();
 465
 466     // does this window have the capture?
 467     bool HasCapture() const;
 468 };
 469
 470
 471
 472
 473 %pragma(python) code = "
 474 def wxDLG_PNT(win, point_or_x, y=None):
 475     if y is None:
 476         return win.ConvertDialogPointToPixels(point_or_x)
 477     else:
 478         return win.ConvertDialogPointToPixels(wxPoint(point_or_x, y))
 479
 480 def wxDLG_SZE(win, size_width, height=None):
 481     if height is None:
 482         return win.ConvertDialogSizeToPixels(size_width)
 483     else:
 484         return win.ConvertDialogSizeToPixels(wxSize(size_width, height))
 485 "
 486
 487
 488 #ifdef __WXMSW__
 489 %inline %{
 490 wxWindow* wxWindow_FromHWND(unsigned long hWnd) {
 491     wxWindow* win = new wxWindow;
 492     win->SetHWND(hWnd);
 493     win->SubclassWin(hWnd);
 494     return win;
 495 }
 496 %}
 497 #endif
 498
 499
 500 //---------------------------------------------------------------------------
 501
 502 class wxPanel : public wxWindow {
 503 public:
 504     wxPanel(wxWindow* parent,
 505             const wxWindowID id,
 506             const wxPoint& pos = wxDefaultPosition,
 507             const wxSize& size = wxDefaultSize,
 508             long style = wxTAB_TRAVERSAL,
 509             const wxString& name = wxPyPanelNameStr);
 510     %name(wxPrePanel)wxPanel();
 511
 512     bool Create(wxWindow* parent,
 513                 const wxWindowID id,
 514                 const wxPoint& pos = wxDefaultPosition,
 515                 const wxSize& size = wxDefaultSize,
 516                 long style = wxTAB_TRAVERSAL,
 517                 const wxString& name = wxPyPanelNameStr);
 518
 519     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
 520     %pragma(python) addtomethod = "wxPrePanel:val._setOORInfo(val)"
 521
 522     void InitDialog();
 523
 524 };
 525
 526 //---------------------------------------------------------------------------
 527
 528
 529 // TODO: Add wrappers for the wxScrollHelper class, make wxScrolledWindow
 530 //       derive from it and wxPanel.
 531
 532
 533 class wxScrolledWindow : public wxPanel {
 534 public:
 535     wxScrolledWindow(wxWindow* parent,
 536                      const wxWindowID id = -1,
 537                      const wxPoint& pos = wxDefaultPosition,
 538                      const wxSize& size = wxDefaultSize,
 539                      long style = wxHSCROLL | wxVSCROLL,
 540                      const wxString& name = wxPyPanelNameStr);
 541     %name(wxPreScrolledWindow)wxScrolledWindow();
 542
 543     bool Create(wxWindow* parent,
 544                 const wxWindowID id = -1,
 545                 const wxPoint& pos = wxDefaultPosition,
 546                 const wxSize& size = wxDefaultSize,
 547                 long style = wxHSCROLL | wxVSCROLL,
 548                 const wxString& name = wxPyPanelNameStr);
 549
 550     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
 551     %pragma(python) addtomethod = "wxPreScrolledWindow:val._setOORInfo(val)"
 552
 553     void EnableScrolling(bool xScrolling, bool yScrolling);
 554     int GetScrollPageSize(int orient);
 555     void GetScrollPixelsPerUnit(int* OUTPUT, int* OUTPUT);
 556     wxWindow* GetTargetWindow();
 557     bool IsRetained();
 558     void PrepareDC(wxDC& dc);
 559     void Scroll(int x, int y);
 560     void SetScrollbars(int pixelsPerUnitX, int pixelsPerUnitY,
 561                        int noUnitsX, int noUnitsY,
 562                        int xPos = 0, int yPos = 0, int noRefresh=FALSE);
 563     void SetScrollPageSize(int orient, int pageSize);
 564     void SetTargetWindow(wxWindow* window);
 565     void GetViewStart(int* OUTPUT, int* OUTPUT);
 566     %pragma(python) addtoclass = "ViewStart = GetViewStart"
 567
 568     %name(CalcScrolledPosition1)wxPoint CalcScrolledPosition(const wxPoint& pt);
 569     %name(CalcScrolledPosition2)void CalcScrolledPosition( int x, int y, int *OUTPUT, int *OUTPUT);
 570
 571     %name(CalcUnscrolledPosition1)wxPoint CalcUnscrolledPosition(const wxPoint& pt);
 572     %name(CalcUnscrolledPosition2)void CalcUnscrolledPosition( int x, int y, int *OUTPUT, int *OUTPUT);
 573
 574     %pragma(python) addtoclass = "
 575     def CalcScrolledPosition(self, *args):
 576         if len(args) == 1:
 577             return apply(self.CalcScrolledPosition1, args)
 578         elif len(args) == 2:
 579             return apply(self.CalcScrolledPosition2, args)
 580         else:
 581             raise TypeError, 'Invalid parameters: only (x,y) or (point) allowed'
 582
 583     def CalcUnscrolledPosition(self, *args):
 584         if len(args) == 1:
 585             return apply(self.CalcUnscrolledPosition1, args)
 586         elif len(args) == 2:
 587             return apply(self.CalcUnscrolledPosition2, args)
 588         else:
 589             raise TypeError, 'Invalid parameters: only (x,y) or (point) allowed'
 590 "
 591
 592     void SetScale(double xs, double ys);
 593     double GetScaleX();
 594     double GetScaleY();
 595
 596     void AdjustScrollbars();
 597
 598     bool Layout();
 599
 600     // Set the x, y scrolling increments.
 601     void SetScrollRate( int xstep, int ystep );
 602
 603 };
 604
 605 //----------------------------------------------------------------------
 606
 607
 608 class wxMenu : public wxEvtHandler {
 609 public:
 610     wxMenu(const wxString& title = wxPyEmptyString, long style = 0);
 611
 612     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
 613
 614     void Append(int id, const wxString& item,
 615                 const wxString& helpString = wxPyEmptyString,
 616                 wxItemKind kind = wxITEM_NORMAL);
 617     %name(AppendMenu)void Append(int id, const wxString& item, wxMenu *subMenu,
 618                                  const wxString& helpString = wxPyEmptyString);
 619     %name(AppendItem)void Append(const wxMenuItem* item);
 620     void AppendCheckItem(int id,
 621                          const wxString& text,
 622                          const wxString& help = wxPyEmptyString);
 623     void AppendRadioItem(int id,
 624                          const wxString& text,
 625                          const wxString& help = wxPyEmptyString);
 626     void AppendSeparator();
 627
 628
 629     void Insert(size_t pos,
 630                 int id,
 631                 const wxString& text,
 632                 const wxString& help = wxPyEmptyString,
 633                 wxItemKind kind = wxITEM_NORMAL);
 634     void InsertSeparator(size_t pos);
 635     void InsertCheckItem(size_t pos,
 636                          int id,
 637                          const wxString& text,
 638                          const wxString& help = wxPyEmptyString);
 639     void InsertRadioItem(size_t pos,
 640                          int id,
 641                          const wxString& text,
 642                          const wxString& help = wxPyEmptyString);
 643     %name(InsertMenu)void Insert(size_t pos,
 644                                  int id,
 645                                  const wxString& text,
 646                                  wxMenu *submenu,
 647                                  const wxString& help = wxPyEmptyString);
 648     %name(InsertItem)bool Insert(size_t pos, wxMenuItem *item);
 649
 650
 651     void Prepend(int id,
 652                  const wxString& text,
 653                  const wxString& help = wxPyEmptyString,
 654                  wxItemKind kind = wxITEM_NORMAL);
 655     void PrependSeparator();
 656     void PrependCheckItem(int id,
 657                           const wxString& text,
 658                           const wxString& help = wxPyEmptyString);
 659     void PrependRadioItem(int id,
 660                           const wxString& text,
 661                           const wxString& help = wxPyEmptyString);
 662     %name(PrependMenu)void Prepend(int id,
 663                                    const wxString& text,
 664                                    wxMenu *submenu,
 665                                    const wxString& help = wxPyEmptyString);
 666     %name(PrependItem)void Prepend(wxMenuItem *item);
 667
 668
 669     void Break();
 670     void Check(int id, bool flag);
 671     bool IsChecked(int id);
 672     void Enable(int id, bool enable);
 673     bool IsEnabled(int id);
 674
 675     int FindItem(const wxString& itemString);
 676     %name(FindItemById)wxMenuItem* FindItem(int id/*, wxMenu **menu = NULL*/);
 677
 678     wxString GetTitle();
 679     void SetTitle(const wxString& title);
 680
 681     wxString GetLabel(int id);
 682     void SetLabel(int id, const wxString& label);
 683
 684     wxString GetHelpString(int id);
 685     void SetHelpString(int id, const wxString& helpString);
 686     void UpdateUI(wxEvtHandler* source = NULL);
 687
 688     bool Delete(int id);
 689     %name(DeleteItem)bool Delete(wxMenuItem *item);
 690     wxMenuItem *Remove(int id);
 691     %name(RemoveItem) wxMenuItem *Remove(wxMenuItem *item);
 692
 693
 694
 695
 696     %addmethods {
 697         void Destroy() { delete self; }
 698     }
 699     %name(DestroyId)bool Destroy(int id);
 700     %name(DestroyItem)bool Destroy(wxMenuItem *item);
 701
 702     size_t GetMenuItemCount();
 703     //wxMenuItemList& GetMenuItems();
 704     %addmethods {
 705         PyObject* GetMenuItems() {
 706             wxMenuItemList& list = self->GetMenuItems();
 707             return wxPy_ConvertList(&list, "wxMenuItem");
 708         }
 709     }
 710
 711     void SetEventHandler(wxEvtHandler *handler);
 712     wxEvtHandler *GetEventHandler();
 713
 714     void SetInvokingWindow(wxWindow *win);
 715     wxWindow *GetInvokingWindow();
 716
 717     long GetStyle();
 718
 719     bool IsAttached();
 720
 721     void SetParent(wxMenu *parent);
 722     wxMenu *GetParent();
 723 };
 724
 725
 726 //----------------------------------------------------------------------
 727
 728 class wxMenuBar : public wxWindow {
 729 public:
 730     wxMenuBar(long style = 0);
 731
 732     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
 733
 734     bool Append(wxMenu *menu, const wxString& title);
 735     bool Insert(size_t pos, wxMenu *menu, const wxString& title);
 736     size_t GetMenuCount();
 737     wxMenu *GetMenu(size_t pos);
 738     wxMenu *Replace(size_t pos, wxMenu *menu, const wxString& title);
 739     wxMenu *Remove(size_t pos);
 740     void EnableTop(size_t pos, bool enable);
 741     void SetLabelTop(size_t pos, const wxString& label);
 742     wxString GetLabelTop(size_t pos);
 743     int FindMenu(const wxString& title);
 744     int FindMenuItem(const wxString& menuString, const wxString& itemString);
 745     %name(FindItemById)wxMenuItem* FindItem(int id/*, wxMenu **menu = NULL*/);
 746     void Enable(int id, bool enable);
 747     void Check(int id, bool check);
 748     bool IsChecked(int id);
 749     bool IsEnabled(int id);
 750
 751     void SetLabel(int id, const wxString &label);
 752     wxString GetLabel(int id);
 753
 754     void SetHelpString(int id, const wxString& helpString);
 755     wxString GetHelpString(int id);
 756
 757 };
 758
 759
 760 //----------------------------------------------------------------------
 761
 762 class wxMenuItem : public wxObject {
 763 public:
 764     wxMenuItem(wxMenu* parentMenu=NULL, int id=wxID_SEPARATOR,
 765                const wxString& text = wxPyEmptyString,
 766                const wxString& help = wxPyEmptyString,
 767                wxItemKind kind = wxITEM_NORMAL,
 768                wxMenu* subMenu = NULL);
 769
 770
 771     wxMenu *GetMenu();
 772     void SetId(int id);
 773     int  GetId();
 774     bool IsSeparator();
 775     void SetText(const wxString& str);
 776     wxString GetLabel();
 777     const wxString& GetText();
 778     wxItemKind GetKind();
 779     void SetCheckable(bool checkable);
 780     bool IsCheckable();
 781     bool IsSubMenu();
 782     void SetSubMenu(wxMenu *menu);
 783     wxMenu *GetSubMenu();
 784     void Enable(bool enable = TRUE);
 785     bool IsEnabled();
 786     void Check(bool check = TRUE);
 787     bool IsChecked();
 788     void Toggle();
 789     void SetHelp(const wxString& str);
 790     const wxString& GetHelp();
 791     wxAcceleratorEntry *GetAccel();
 792     void SetAccel(wxAcceleratorEntry *accel);
 793
 794     static wxString GetLabelFromText(const wxString& text);
 795 //    static wxAcceleratorEntry *GetAccelFromString(const wxString& label);
 796
 797     // wxOwnerDrawn methods
 798 #ifdef __WXMSW__
 799     void SetFont(const wxFont& font);
 800     wxFont GetFont();
 801     void SetTextColour(const wxColour& colText);
 802     wxColour GetTextColour();
 803     void SetBackgroundColour(const wxColour& colBack);
 804     wxColour GetBackgroundColour();
 805     void SetBitmaps(const wxBitmap& bmpChecked,
 806                     const wxBitmap& bmpUnchecked = wxNullBitmap);
 807     void SetBitmap(const wxBitmap& bmpChecked);
 808     wxBitmap GetBitmap(bool bChecked = TRUE);
 809     void SetMarginWidth(int nWidth);
 810     int GetMarginWidth();
 811     static int GetDefaultMarginWidth();
 812     //void SetName(const wxString& strName);
 813     //const wxString& GetName();
 814     //void SetCheckable(bool checkable);
 815     //bool IsCheckable();
 816     bool IsOwnerDrawn();
 817     void ResetOwnerDrawn();
 818 #endif
 819 };
 820
 821 //---------------------------------------------------------------------------
 822
 823
 824