wxPython/src/_toplvl.i

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        _toplvl.i
   3 // Purpose:     SWIG definitions for wxTopLevelWindow, wxFrame, wxDialog and etc.
   4 //
   5 // Author:      Robin Dunn
   6 //
   7 // Created:     27-Aug-1998
   8 // RCS-ID:      $Id$
   9 // Copyright:   (c) 2003 by Total Control Software
  10 // Licence:     wxWindows license
  11 /////////////////////////////////////////////////////////////////////////////
  12
  13 // Not a %module
  14
  15
  16 //---------------------------------------------------------------------------
  17
  18 MAKE_CONST_WXSTRING(FrameNameStr);
  19 MAKE_CONST_WXSTRING(DialogNameStr);
  20 MAKE_CONST_WXSTRING(StatusLineNameStr);
  21 MAKE_CONST_WXSTRING(ToolBarNameStr);
  22
  23 //---------------------------------------------------------------------------
  24 %newgroup
  25
  26 enum
  27 {
  28     wxSTAY_ON_TOP,
  29     wxICONIZE,
  30     wxMINIMIZE,
  31     wxMAXIMIZE,
  32     wxCLOSE_BOX,
  33     wxTHICK_FRAME,
  34     wxSYSTEM_MENU,
  35     wxMINIMIZE_BOX,
  36     wxMAXIMIZE_BOX,
  37     wxTINY_CAPTION_HORIZ,
  38     wxTINY_CAPTION_VERT,
  39     wxRESIZE_BOX,
  40     wxRESIZE_BORDER,
  41
  42     wxDIALOG_NO_PARENT,
  43
  44     wxDEFAULT_FRAME_STYLE,
  45     wxDEFAULT_DIALOG_STYLE,
  46
  47     wxFRAME_TOOL_WINDOW,
  48     wxFRAME_FLOAT_ON_PARENT,
  49     wxFRAME_NO_WINDOW_MENU,
  50     wxFRAME_NO_TASKBAR,
  51     wxFRAME_SHAPED,
  52
  53     // Obsolete
  54     wxDIALOG_MODAL,
  55     wxDIALOG_MODELESS,
  56     wxUSER_COLOURS,
  57     wxNO_3D,
  58 };
  59
  60 enum
  61 {
  62     wxFULLSCREEN_NOMENUBAR,
  63     wxFULLSCREEN_NOTOOLBAR,
  64     wxFULLSCREEN_NOSTATUSBAR,
  65     wxFULLSCREEN_NOBORDER,
  66     wxFULLSCREEN_NOCAPTION,
  67     wxFULLSCREEN_ALL,
  68
  69     wxTOPLEVEL_EX_DIALOG,
  70 };
  71
  72
  73
  74 %typemap(in) (int widths, int* widths_field) {
  75     $1 = PyList_Size($input);
  76     $2 =  int_LIST_helper($input);
  77     if ($2 == NULL) SWIG_fail;
  78 }
  79
  80 %typemap(freearg) (int widths, int* widths_field) {
  81     if ($2) delete [] $2;
  82 }
  83
  84
  85 //---------------------------------------------------------------------------
  86
  87 class  wxTopLevelWindow : public wxWindow
  88 {
  89 public:
  90
  91     // No constructor as it can not be used directly from Python
  92
  93     // maximize = True => maximize, otherwise - restore
  94     virtual void Maximize(bool maximize = True);
  95
  96     // undo Maximize() or Iconize()
  97     virtual void Restore();
  98
  99     // iconize = True => iconize, otherwise - restore
 100     virtual void Iconize(bool iconize = True);
 101
 102     // return True if the frame is maximized
 103     virtual bool IsMaximized() const;
 104
 105     // return True if the frame is iconized
 106     virtual bool IsIconized() const;
 107
 108     // get the frame icon
 109     wxIcon GetIcon() const;
 110
 111     // set the frame icon
 112     virtual void SetIcon(const wxIcon& icon);
 113
 114     // set the frame icons
 115     virtual void SetIcons(const wxIconBundle& icons );
 116
 117     // maximize the window to cover entire screen
 118     virtual bool ShowFullScreen(bool show, long style = wxFULLSCREEN_ALL);
 119
 120     // return True if the frame is in fullscreen mode
 121     virtual bool IsFullScreen() const;
 122
 123     virtual void SetTitle(const wxString& title);
 124     virtual wxString GetTitle() const;
 125
 126     // Set the shape of the window to the given region.
 127     // Returns True if the platform supports this feature (and the operation
 128     // is successful.)
 129     virtual bool SetShape(const wxRegion& region);
 130
 131 #ifdef __WXMAC__
 132     void MacSetMetalAppearance( bool on ) ;
 133     bool MacGetMetalAppearance() const ;
 134 #endif
 135 };
 136
 137
 138 //---------------------------------------------------------------------------
 139 %newgroup
 140
 141 // wxFrame is a top-level window with optional menubar, statusbar and toolbar
 142 //
 143 // For each of *bars, a frame may have several of them, but only one is
 144 // managed by the frame, i.e. resized/moved when the frame is and whose size
 145 // is accounted for in client size calculations - all others should be taken
 146 // care of manually.
 147
 148 class wxFrame : public wxTopLevelWindow {
 149 public:
 150     %pythonAppend wxFrame         "self._setOORInfo(self)"
 151     %pythonAppend wxFrame()       ""
 152
 153     wxFrame(wxWindow* parent, const wxWindowID id, const wxString& title,
 154             const wxPoint& pos = wxDefaultPosition,
 155             const wxSize& size = wxDefaultSize,
 156             long style = wxDEFAULT_FRAME_STYLE,
 157             const wxString& name = wxPyFrameNameStr);
 158     %name(PreFrame)wxFrame();
 159
 160     bool Create(wxWindow* parent, const wxWindowID id, const wxString& title,
 161                 const wxPoint& pos = wxDefaultPosition,
 162                 const wxSize& size = wxDefaultSize,
 163                 long style = wxDEFAULT_FRAME_STYLE,
 164                 const wxString& name = wxPyFrameNameStr);
 165
 166
 167     // frame state
 168     // -----------
 169
 170     // get the origin of the client area (which may be different from (0, 0)
 171     // if the frame has a toolbar) in client coordinates
 172     virtual wxPoint GetClientAreaOrigin() const;
 173
 174     // sends a size event to the window using its current size -- this has an
 175     // effect of refreshing the window layout
 176     //
 177     virtual void SendSizeEvent() { }
 178
 179
 180     // menu bar functions
 181     // ------------------
 182
 183     virtual void SetMenuBar(wxMenuBar *menubar);
 184     virtual wxMenuBar *GetMenuBar() const;
 185
 186
 187     // process menu command: returns True if processed
 188     bool ProcessCommand(int winid);
 189     %pythoncode { Command = ProcessCommand }
 190
 191
 192     // status bar functions
 193     // --------------------
 194
 195     // create the main status bar by calling OnCreateStatusBar()
 196     virtual wxStatusBar* CreateStatusBar(int number = 1,
 197                                          long style = wxDEFAULT_STATUSBAR_STYLE,
 198                                          wxWindowID winid = 0,
 199                                          const wxString& name = wxPyStatusLineNameStr);
 200 // TODO: with directors?
 201 //     // return a new status bar
 202 //     virtual wxStatusBar *OnCreateStatusBar(int number,
 203 //                                            long style,
 204 //                                            wxWindowID winid,
 205 //                                            const wxString& name);
 206
 207     // get the main status bar
 208     virtual wxStatusBar *GetStatusBar() const;
 209
 210     // sets the main status bar
 211     void SetStatusBar(wxStatusBar *statBar);
 212
 213     // forward these to status bar
 214     virtual void SetStatusText(const wxString &text, int number = 0);
 215     virtual void SetStatusWidths(int widths, const int* widths_field); //uses typemap above
 216     void PushStatusText(const wxString &text, int number = 0);
 217     void PopStatusText(int number = 0);
 218
 219     // set the status bar pane the help will be shown in
 220     void SetStatusBarPane(int n);
 221     int GetStatusBarPane() const;
 222
 223
 224     // toolbar functions
 225     // -----------------
 226
 227     // create main toolbar bycalling OnCreateToolBar()
 228     virtual wxToolBar* CreateToolBar(long style = -1,
 229                                      wxWindowID winid = -1,
 230                                      const wxString& name = wxPyToolBarNameStr);
 231 // TODO: with directors?
 232 //     // return a new toolbar
 233 //     virtual wxToolBar *OnCreateToolBar(long style,
 234 //                                        wxWindowID winid,
 235 //                                        const wxString& name );
 236
 237     // get/set the main toolbar
 238     virtual wxToolBar *GetToolBar() const;
 239     virtual void SetToolBar(wxToolBar *toolbar);
 240
 241
 242     // show help text (typically in the statusbar); show is False
 243     // if you are hiding the help, True otherwise
 244     virtual void DoGiveHelp(const wxString& text, bool show);
 245
 246
 247     // send wxUpdateUIEvents for all menu items in the menubar,
 248     // or just for menu if non-NULL
 249     void DoMenuUpdates(wxMenu* menu = NULL);
 250 };
 251
 252 //---------------------------------------------------------------------------
 253 %newgroup
 254
 255 class wxDialog : public wxTopLevelWindow {
 256 public:
 257     %pythonAppend wxDialog   "self._setOORInfo(self)"
 258     %pythonAppend wxDialog() ""
 259
 260     wxDialog(wxWindow* parent,
 261              const wxWindowID id,
 262              const wxString& title,
 263              const wxPoint& pos = wxDefaultPosition,
 264              const wxSize& size = wxDefaultSize,
 265              long style = wxDEFAULT_DIALOG_STYLE,
 266              const wxString& name = wxPyDialogNameStr);
 267     %name(PreDialog)wxDialog();
 268
 269     bool Create(wxWindow* parent,
 270                 const wxWindowID id,
 271                 const wxString& title,
 272                 const wxPoint& pos = wxDefaultPosition,
 273                 const wxSize& size = wxDefaultSize,
 274                 long style = wxDEFAULT_DIALOG_STYLE,
 275                 const wxString& name = wxPyDialogNameStr);
 276
 277
 278     // the modal dialogs have a return code - usually the id of the last
 279     // pressed button
 280     void SetReturnCode(int returnCode) { m_returnCode = returnCode; }
 281     int GetReturnCode() const { return m_returnCode; }
 282
 283     // splits text up at newlines and places the
 284     // lines into a vertical wxBoxSizer
 285     wxSizer *CreateTextSizer( const wxString &message );
 286
 287     // places buttons into a horizontal wxBoxSizer
 288     wxSizer *CreateButtonSizer( long flags );
 289
 290
 291     //void SetModal(bool flag);
 292
 293     // is the dialog in modal state right now?
 294     virtual bool IsModal() const;
 295
 296     // Shows the dialog and starts a nested event loop that returns when
 297     // EndModal is called.
 298     virtual int ShowModal();
 299
 300     // may be called to terminate the dialog with the given return code
 301     virtual void EndModal(int retCode);
 302
 303     // returns True if we're in a modal loop
 304     %extend {
 305         bool IsModalShowing() {
 306         #ifdef __WXGTK__
 307             return self->m_modalShowing;
 308         #else
 309             return self->IsModalShowing();
 310         #endif
 311         }
 312     }
 313 };
 314
 315 //---------------------------------------------------------------------------
 316 %newgroup
 317
 318
 319 class wxMiniFrame : public wxFrame {
 320 public:
 321     %pythonAppend wxMiniFrame         "self._setOORInfo(self)"
 322     %pythonAppend wxMiniFrame()       ""
 323
 324     wxMiniFrame(wxWindow* parent, const wxWindowID id, const wxString& title,
 325                 const wxPoint& pos = wxDefaultPosition,
 326                 const wxSize& size = wxDefaultSize,
 327                 long style = wxDEFAULT_FRAME_STYLE,
 328                 const wxString& name = wxPyFrameNameStr);
 329     %name(PreMiniFrame)wxMiniFrame();
 330
 331     bool Create(wxWindow* parent, const wxWindowID id, const wxString& title,
 332                 const wxPoint& pos = wxDefaultPosition,
 333                 const wxSize& size = wxDefaultSize,
 334                 long style = wxDEFAULT_FRAME_STYLE,
 335                 const wxString& name = wxPyFrameNameStr);
 336
 337 };
 338
 339
 340 //---------------------------------------------------------------------------
 341 %newgroup
 342
 343
 344 enum {
 345     wxSPLASH_CENTRE_ON_PARENT,
 346     wxSPLASH_CENTRE_ON_SCREEN,
 347     wxSPLASH_NO_CENTRE,
 348     wxSPLASH_TIMEOUT,
 349     wxSPLASH_NO_TIMEOUT,
 350 };
 351
 352
 353 class wxSplashScreenWindow: public wxWindow
 354 {
 355 public:
 356     %pythonAppend wxSplashScreenWindow         "self._setOORInfo(self)"
 357
 358     wxSplashScreenWindow(const wxBitmap& bitmap,
 359                          wxWindow* parent, wxWindowID id,
 360                          const wxPoint& pos = wxDefaultPosition,
 361                          const wxSize& size = wxDefaultSize,
 362                          long style = wxNO_BORDER);
 363
 364     void SetBitmap(const wxBitmap& bitmap);
 365     wxBitmap& GetBitmap();
 366 };
 367
 368
 369 class wxSplashScreen : public wxFrame {
 370 public:
 371     %pythonAppend wxSplashScreen         "self._setOORInfo(self)"
 372
 373     wxSplashScreen(const wxBitmap& bitmap, long splashStyle, int milliseconds,
 374                    wxWindow* parent, wxWindowID id,
 375                    const wxPoint& pos = wxDefaultPosition,
 376                    const wxSize& size = wxDefaultSize,
 377                    long style = wxSIMPLE_BORDER|wxFRAME_NO_TASKBAR|wxSTAY_ON_TOP);
 378
 379     long GetSplashStyle() const;
 380     wxSplashScreenWindow* GetSplashWindow() const;
 381     int GetTimeout() const;
 382 };
 383
 384
 385 //---------------------------------------------------------------------------