utils/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 %}
  20
  21 //----------------------------------------------------------------------
  22
  23 %include typemaps.i
  24 %include my_typemaps.i
  25
  26 // Import some definitions of other classes, etc.
  27 %import _defs.i
  28 %import misc.i
  29 %import gdi.i
  30
  31 %pragma(python) code = "import wx"
  32
  33 //---------------------------------------------------------------------------
  34
  35 class wxEvtHandler {
  36 public:
  37     %addmethods {
  38         void Connect( int id, int lastId, int eventType, PyObject* func) {
  39             if (PyCallable_Check(func)) {
  40                 self->Connect(id, lastId, eventType,
  41                           (wxObjectEventFunction) &wxPyCallback::EventThunker,
  42                           new wxPyCallback(func));
  43             }
  44         }
  45     }
  46 };
  47
  48
  49 //----------------------------------------------------------------------
  50
  51
  52 class wxWindow : public wxEvtHandler {
  53 public:
  54
  55     wxWindow(wxWindow* parent, const wxWindowID id,
  56              const wxPoint& pos = wxPyDefaultPosition,
  57              const wxSize& size = wxPyDefaultSize,
  58              long style = 0,
  59              char* name = "panel");
  60
  61     %pragma(python) addtomethod = "__init__:wx._StdWindowCallbacks(self)"
  62
  63     void CaptureMouse();
  64     void Center(int direction = wxHORIZONTAL);
  65     void Centre(int direction = wxHORIZONTAL);
  66     %name(ClientToScreenXY)void ClientToScreen(int *BOTH, int *BOTH);
  67 #ifndef __WXGTK__
  68     wxPoint ClientToScreen(const wxPoint& pt);
  69 #endif
  70     bool Close(int force = FALSE);
  71     bool Destroy();
  72     void DestroyChildren();
  73 #ifdef __WXMSW__
  74     void DragAcceptFiles(bool accept);
  75 #endif
  76     void Enable(bool enable);
  77     //bool FakePopupMenu(wxMenu* menu, int x, int y);
  78     %name(FindWindowById) wxWindow* FindWindow(long id);
  79     %name(FindWindowByName) wxWindow* FindWindow(const wxString& name);
  80     void Fit();
  81     wxColour GetBackgroundColour();
  82     int  GetCharHeight();
  83     int  GetCharWidth();
  84     %name(GetClientSizeTuple) void GetClientSize(int *OUTPUT, int *OUTPUT);
  85     wxSize GetClientSize();
  86     wxLayoutConstraints * GetConstraints();
  87 #ifdef __WXMSW__
  88     wxButton* GetDefaultItem();
  89 #endif
  90     //wxEvtHandler* GetEventHandler();
  91
  92     wxFont& GetFont();
  93     wxColour GetForegroundColour();
  94     wxWindow * GetGrandParent();
  95     int GetId();
  96     wxString GetLabel();
  97     wxString GetName();
  98     wxWindow * GetParent();
  99     %name(GetPositionTuple) void GetPosition(int *OUTPUT, int *OUTPUT);
 100     wxPoint GetPosition();
 101     wxRect GetRect();
 102     int  GetReturnCode();
 103     int GetScrollThumb(int orientation);
 104     int GetScrollPos(int orientation);
 105     int GetScrollRange(int orientation);
 106     %name(GetSizeTuple) void GetSize(int *OUTPUT, int *OUTPUT);
 107     wxSize GetSize();
 108     void GetTextExtent(const wxString& string, int *OUTPUT, int *OUTPUT);
 109     %name(GetFullTextExtent)void GetTextExtent(const wxString& string,
 110                        int *OUTPUT, int *OUTPUT, int *OUTPUT, int* OUTPUT,
 111                        const wxFont* font = NULL); //, bool use16 = FALSE)
 112     wxString GetTitle();
 113     long GetWindowStyleFlag();
 114     void InitDialog();
 115     bool IsEnabled();
 116     bool IsRetained();
 117     bool IsShown();
 118     void Layout();
 119     bool LoadFromResource(wxWindow* parent, const wxString& resourceName, const wxResourceTable* resourceTable = NULL);
 120     void Lower();
 121     void MakeModal(bool flag);
 122     %name(MoveXY)void Move(int x, int y);
 123     void Move(const wxPoint& point);
 124
 125     //wxEvtHandler* PopEventHandler(bool deleteHandler = FALSE);
 126     bool PopupMenu(wxMenu *menu, int x, int y);
 127     //void PushEventHandler(wxEvtHandler* handler);
 128
 129     void Raise();
 130     void Refresh(bool eraseBackground = TRUE, const wxRect* rect = NULL);
 131     void ReleaseMouse();
 132     %name(ScreenToClientXY)void ScreenToClient(int *BOTH, int *BOTH);
 133 #ifndef __WXGTK__
 134     wxPoint ScreenToClient(const wxPoint& pt);
 135 #endif
 136
 137     void ScrollWindow(int dx, int dy, const wxRect* rect = NULL);
 138     void SetAcceleratorTable(const wxAcceleratorTable& accel);
 139     void SetAutoLayout(bool autoLayout);
 140     void SetBackgroundColour(const wxColour& colour);
 141     void SetConstraints(wxLayoutConstraints *constraints);
 142     void SetDoubleClick(bool allowDoubleClick);
 143     void SetFocus();
 144     void SetFont(const wxFont& font);
 145     void SetForegroundColour(const wxColour& colour);
 146     void SetId(int id);
 147     void SetName(const wxString& name);
 148     void SetReturnCode(int retCode);
 149     void SetScrollbar(int orientation, int position, int thumbSize, int range, bool refresh = TRUE);
 150     void SetScrollPos(int orientation, int pos, bool refresh = TRUE);
 151
 152     %name(SetDimensions) void SetSize(int x, int y, int width, int height, int sizeFlags=wxSIZE_AUTO);
 153     %addmethods {
 154         void SetSize(const wxSize& size) {
 155             self->SetSize(size.x, size.y);
 156         }
 157
 158         void SetPosition(const wxPoint& pos) {
 159             self->SetSize(pos.x, pos.y, -1, -1);
 160         }
 161     }
 162
 163     void SetSizeHints(int minW=-1, int minH=-1, int maxW=-1, int maxH=-1, int incW=-1, int incH=-1);
 164     %name(SetClientSizeWH)void SetClientSize(int width, int height);
 165     void SetClientSize(const wxSize& size);
 166     //void SetPalette(wxPalette* palette);
 167     void SetCursor(const wxCursor&cursor);
 168     //void SetEventHandler(wxEvtHandler* handler);
 169     void SetTitle(const wxString& title);
 170     bool Show(bool show);
 171     bool TransferDataFromWindow();
 172     bool TransferDataToWindow();
 173     bool Validate();
 174     void WarpPointer(int x, int y);
 175
 176     %name(ConvertDialogPointToPixels) wxPoint ConvertDialogToPixels(const wxPoint& pt);
 177     %name(ConvertDialogSizeToPixels)  wxSize  ConvertDialogToPixels(const wxSize& sz);
 178
 179     %name(ConvertPixelPointToDialog) wxPoint ConvertPixelsToDialog(const wxPoint& pt);
 180     %name(ConvertPixelSizeToDialog)  wxSize  ConvertPixelsToDialog(const wxSize& sz);
 181
 182     %name(SetToolTipString)void SetToolTip(const wxString &tip);
 183     void SetToolTip(wxToolTip *tooltip);
 184     wxToolTip* GetToolTip();
 185 };
 186
 187 %pragma(python) code = "
 188 def wxDLG_PNT(win, point):
 189     return win.ConvertDialogPointToPixels(point)
 190
 191 def wxDLG_SZE(win, size):
 192     return win.ConvertDialogSizeToPixels(size)
 193 "
 194
 195 #ifdef __WXMSW__
 196 %inline %{
 197     wxWindow* wxWindow_FindFocus() {
 198         return wxWindow::FindFocus();
 199     }
 200 %}
 201
 202
 203 %inline %{
 204 wxWindow* wxWindow_FromHWND(unsigned long hWnd) {
 205     wxWindow* win = new wxWindow;
 206     win->SetHWND(hWnd);
 207     win->SubclassWin(hWnd);
 208     return win;
 209 }
 210 %}
 211 #endif
 212
 213
 214 //---------------------------------------------------------------------------
 215
 216 class wxPanel : public wxWindow {
 217 public:
 218     wxPanel(wxWindow* parent,
 219             const wxWindowID id,
 220             const wxPoint& pos = wxPyDefaultPosition,
 221             const wxSize& size = wxPyDefaultSize,
 222             long style = wxTAB_TRAVERSAL,
 223             const char* name = "panel");
 224
 225     %pragma(python) addtomethod = "__init__:wx._StdWindowCallbacks(self)"
 226
 227     void InitDialog();
 228 };
 229
 230 //---------------------------------------------------------------------------
 231
 232 class wxDialog : public wxPanel {
 233 public:
 234     wxDialog(wxWindow* parent,
 235              const wxWindowID id,
 236              const wxString& title,
 237              const wxPoint& pos = wxPyDefaultPosition,
 238              const wxSize& size = wxPyDefaultSize,
 239              long style = wxDEFAULT_DIALOG_STYLE,
 240              const char* name = "dialogBox");
 241
 242     %pragma(python) addtomethod = "__init__:wx._StdDialogCallbacks(self)"
 243
 244     void Centre(int direction = wxBOTH);
 245     void EndModal(int retCode);
 246     wxString GetTitle();
 247     void Iconize(bool iconize);
 248     bool IsIconized();
 249     void SetModal(bool flag);
 250     bool IsModal();
 251     void SetTitle(const wxString& title);
 252     bool Show(bool show);
 253     int ShowModal();
 254 };
 255
 256 //---------------------------------------------------------------------------
 257
 258 class wxScrolledWindow : public wxWindow {
 259 public:
 260     wxScrolledWindow(wxWindow* parent,
 261                      const wxWindowID id = -1,
 262                      const wxPoint& pos = wxPyDefaultPosition,
 263                      const wxSize& size = wxPyDefaultSize,
 264                      long style = wxHSCROLL | wxVSCROLL,
 265                      char* name = "scrolledWindow");
 266
 267     %pragma(python) addtomethod = "__init__:wx._StdWindowCallbacks(self)"
 268     %pragma(python) addtomethod = "__init__:wx._StdOnScrollCallbacks(self)"
 269
 270     void EnableScrolling(bool xScrolling, bool yScrolling);
 271     void GetScrollPixelsPerUnit(int* OUTPUT, int* OUTPUT);
 272     void GetVirtualSize(int* OUTPUT, int* OUTPUT);
 273     bool IsRetained();
 274     void PrepareDC(wxDC& dc);
 275     void Scroll(int x, int y);
 276     void SetScrollbars(int pixelsPerUnitX, int pixelsPerUnitY,
 277                        int noUnitsX, int noUnitsY,
 278                        int xPos = 0, int yPos = 0);
 279     void ViewStart(int* OUTPUT, int* OUTPUT);
 280 };
 281
 282 //----------------------------------------------------------------------
 283
 284
 285 class wxMenu : public wxEvtHandler {
 286 public:
 287     wxMenu(const wxString& title = wxPyEmptyStr);
 288
 289     void Append(int id, const wxString& item,
 290                 const wxString& helpString = wxPyEmptyStr,
 291                 int checkable = FALSE);
 292     %name(AppendMenu)void Append(int id, const wxString& item, wxMenu *subMenu,
 293                 const wxString& helpString = wxPyEmptyStr);
 294 #ifndef __WXGTK__
 295     %name(AppendItem)void Append(const wxMenuItem* item);
 296 #endif
 297
 298     void AppendSeparator();
 299     void Break();
 300     void Check(int id, bool flag);
 301     void Enable(int id, bool enable);
 302     int FindItem(const wxString& itemString);
 303     wxString GetTitle();
 304     void SetTitle(const wxString& title);
 305     wxMenuItem* FindItemForId(int id);
 306     wxString GetHelpString(int id);
 307     wxString GetLabel(int id);
 308     void SetHelpString(int id, const wxString& helpString);
 309     bool IsChecked(int id);
 310     bool IsEnabled(int id);
 311     void SetLabel(int id, const wxString& label);
 312 };
 313
 314
 315 //
 316 // This one knows how to set a callback and handle INC- and DECREFing it.  To
 317 // be used for PopupMenus, but you must retain a referece to it while using
 318 // it.
 319 //
 320 class wxPyMenu : public wxMenu {
 321 public:
 322     wxPyMenu(const wxString& title = wxPyEmptyStr, PyObject* func = NULL);
 323     ~wxPyMenu();
 324 };
 325
 326 //----------------------------------------------------------------------
 327
 328 class wxMenuBar : public wxEvtHandler {
 329 public:
 330     wxMenuBar();
 331
 332     void Append(wxMenu *menu, const wxString& title);
 333     void Check(int id, bool flag);
 334     bool Checked(int id);
 335     void Enable(int id, bool enable);
 336     bool Enabled(int id);
 337     int FindMenuItem(const wxString& menuString, const wxString& itemString);
 338     wxMenuItem * FindItemForId(int id);
 339 #ifdef __WXMSW__
 340     void EnableTop(int pos, bool enable);
 341     wxString GetHelpString(int id);
 342     wxString GetLabel(int id);
 343     void SetHelpString(int id, const wxString& helpString);
 344     void SetLabel(int id, const wxString& label);
 345     wxString GetLabelTop(int pos);
 346     void SetLabelTop(int pos, const wxString& label);
 347 #endif
 348     int GetMenuCount();
 349     wxMenu* GetMenu(int i);
 350 };
 351
 352
 353 //----------------------------------------------------------------------
 354
 355 class wxMenuItem {
 356 public:
 357     bool IsSeparator();
 358     bool IsEnabled();
 359     bool IsChecked();
 360     bool IsCheckable();
 361     int  GetId();
 362     wxMenu* GetSubMenu();
 363     void SetName(const wxString& strName);
 364     const wxString& GetName();
 365     const wxString& GetHelp();
 366     void SetHelp(const wxString& strHelp);
 367     void Enable(bool bDoEnable = TRUE);
 368     void Check(bool bDoCheck = TRUE);
 369
 370 #ifdef __WXMSW__
 371     void DeleteSubMenu();
 372 #endif
 373 };
 374
 375 //---------------------------------------------------------------------------
 376 /////////////////////////////////////////////////////////////////////////////
 377 //
 378 // $Log$
 379 // Revision 1.14  1999/02/23 23:48:33  RD
 380 // reenabled some methods for wxPython on wxGTK
 381 //
 382 // Revision 1.13  1999/02/20 10:02:38  RD
 383 //
 384 // Changes needed to enable wxGTK compatibility.
 385 //
 386 // Revision 1.12  1999/02/20 09:03:03  RD
 387 // Added wxWindow_FromHWND(hWnd) for wxMSW to construct a wxWindow from a
 388 // window handle.  If you can get the window handle into the python code,
 389 // it should just work...  More news on this later.
 390 //
 391 // Added wxImageList, wxToolTip.
 392 //
 393 // Re-enabled wxConfig.DeleteAll() since it is reportedly fixed for the
 394 // wxRegConfig class.
 395 //
 396 // As usual, some bug fixes, tweaks, etc.
 397 //
 398 // Revision 1.11  1998/12/18 15:49:10  RR
 399 //
 400 //   wxClipboard now serves the primary selection as well
 401 //   wxPython fixes
 402 //   warning mesages
 403 //
 404 // Revision 1.10  1998/12/17 17:52:20  RD
 405 //
 406 // wxPython 0.5.2
 407 // Minor fixes and SWIG code generation for RR's changes.  MSW and GTK
 408 // versions are much closer now!
 409 //
 410 // Revision 1.9  1998/12/17 14:07:46  RR
 411 //
 412 //   Removed minor differences between wxMSW and wxGTK
 413 //
 414 // Revision 1.8  1998/12/16 22:10:56  RD
 415 //
 416 // Tweaks needed to be able to build wxPython with wxGTK.
 417 //
 418 // Revision 1.7  1998/12/15 20:41:25  RD
 419 // Changed the import semantics from "from wxPython import *" to "from
 420 // wxPython.wx import *"  This is for people who are worried about
 421 // namespace pollution, they can use "from wxPython import wx" and then
 422 // prefix all the wxPython identifiers with "wx."
 423 //
 424 // Added wxTaskbarIcon for wxMSW.
 425 //
 426 // Made the events work for wxGrid.
 427 //
 428 // Added wxConfig.
 429 //
 430 // Added wxMiniFrame for wxGTK, (untested.)
 431 //
 432 // Changed many of the args and return values that were pointers to gdi
 433 // objects to references to reflect changes in the wxWindows API.
 434 //
 435 // Other assorted fixes and additions.
 436 //
 437 // Revision 1.6  1998/10/02 06:40:43  RD
 438 //
 439 // Version 0.4 of wxPython for MSW.
 440 //
 441 // Revision 1.5  1998/08/17 18:29:40  RD
 442 // Removed an extra method definition
 443 //
 444 // Revision 1.4  1998/08/16 04:31:11  RD
 445 // More wxGTK work.
 446 //
 447 // Revision 1.3  1998/08/15 07:36:47  RD
 448 // - Moved the header in the .i files out of the code that gets put into
 449 // the .cpp files.  It caused CVS conflicts because of the RCS ID being
 450 // different each time.
 451 //
 452 // - A few minor fixes.
 453 //
 454 // Revision 1.2  1998/08/14 23:36:46  RD
 455 // Beginings of wxGTK compatibility
 456 //
 457 // Revision 1.1  1998/08/09 08:25:52  RD
 458 // Initial version
 459 //
 460 //
 461
 462