wxPython/src/_panel.i

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        _window.i
   3 // Purpose:     SWIG interface for wxPanel and wxScrolledWindow
   4 //
   5 // Author:      Robin Dunn
   6 //
   7 // Created:     24-June-1997
   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 %{
  19 %}
  20
  21 //---------------------------------------------------------------------------
  22 %newgroup
  23
  24
  25 class wxPanel : public wxWindow
  26 {
  27 public:
  28     %addtofunc wxPanel         "self._setOORInfo(self)"
  29     %addtofunc wxPanel()       ""
  30
  31     wxPanel(wxWindow* parent,
  32             const wxWindowID id=-1,
  33             const wxPoint& pos = wxDefaultPosition,
  34             const wxSize& size = wxDefaultSize,
  35             long style = wxTAB_TRAVERSAL | wxNO_BORDER,
  36             const wxString& name = wxPyPanelNameStr);
  37     %name(PrePanel)wxPanel();
  38
  39     bool Create(wxWindow* parent,
  40                 const wxWindowID id,
  41                 const wxPoint& pos = wxDefaultPosition,
  42                 const wxSize& size = wxDefaultSize,
  43                 long style = wxTAB_TRAVERSAL | wxNO_BORDER,
  44                 const wxString& name = wxPyPanelNameStr);
  45
  46     void InitDialog();
  47
  48 };
  49
  50 //---------------------------------------------------------------------------
  51 %newgroup
  52
  53
  54 // TODO: Add wrappers for the wxScrollHelper class, make wxScrolledWindow
  55 //       derive from it and wxPanel.  But what to do about wxGTK where this
  56 //       is not True?
  57
  58 class wxScrolledWindow : public wxPanel
  59 {
  60 public:
  61     %addtofunc wxScrolledWindow         "self._setOORInfo(self)"
  62     %addtofunc wxScrolledWindow()       ""
  63
  64     wxScrolledWindow(wxWindow* parent,
  65                      const wxWindowID id = -1,
  66                      const wxPoint& pos = wxDefaultPosition,
  67                      const wxSize& size = wxDefaultSize,
  68                      long style = wxHSCROLL | wxVSCROLL,
  69                      const wxString& name = wxPyPanelNameStr);
  70     %name(PreScrolledWindow)wxScrolledWindow();
  71
  72     bool Create(wxWindow* parent,
  73                 const wxWindowID id = -1,
  74                 const wxPoint& pos = wxDefaultPosition,
  75                 const wxSize& size = wxDefaultSize,
  76                 long style = wxHSCROLL | wxVSCROLL,
  77                 const wxString& name = wxPyPanelNameStr);
  78
  79
  80     // configure the scrolling
  81     virtual void SetScrollbars(int pixelsPerUnitX, int pixelsPerUnitY,
  82                                int noUnitsX, int noUnitsY,
  83                                int xPos = 0, int yPos = 0,
  84                                bool noRefresh = False );
  85
  86     // scroll to the given (in logical coords) position
  87     virtual void Scroll(int x, int y);
  88
  89     // get/set the page size for this orientation (wxVERTICAL/wxHORIZONTAL)
  90     int GetScrollPageSize(int orient) const;
  91     void SetScrollPageSize(int orient, int pageSize);
  92
  93     // Set the x, y scrolling increments.
  94     void SetScrollRate( int xstep, int ystep );
  95
  96     %feature("autodoc") GetScrollPixelsPerUnit
  97     "GetScrollPixelsPerUnit() -> (xUnit, yUnit)";
  98     %feature("docstring") GetScrollPixelsPerUnit "
  99         get the size of one logical unit in physical ones
 100         "
 101     virtual void GetScrollPixelsPerUnit(int *OUTPUT,
 102                                         int *OUTPUT) const;
 103
 104     // Enable/disable Windows scrolling in either direction. If True, wxWindows
 105     // scrolls the canvas and only a bit of the canvas is invalidated; no
 106     // Clear() is necessary. If False, the whole canvas is invalidated and a
 107     // Clear() is necessary. Disable for when the scroll increment is used to
 108     // actually scroll a non-constant distance
 109     virtual void EnableScrolling(bool x_scrolling, bool y_scrolling);
 110
 111     // Get the view start
 112     virtual void GetViewStart(int *OUTPUT, int *OUTPUT) const;
 113
 114     // Set the scale factor, used in PrepareDC
 115     void SetScale(double xs, double ys);
 116     double GetScaleX() const;
 117     double GetScaleY() const;
 118
 119
 120     %nokwargs CalcScrolledPosition;
 121     %nokwargs CalcUnscrolledPosition;
 122
 123     // translate between scrolled and unscrolled coordinates
 124     void CalcScrolledPosition(int x, int y, int *OUTPUT, int *OUTPUT) const;
 125     wxPoint CalcScrolledPosition(const wxPoint& pt) const;
 126     void CalcUnscrolledPosition(int x, int y, int *OUTPUT, int *OUTPUT) const;
 127     wxPoint CalcUnscrolledPosition(const wxPoint& pt) const;
 128
 129 // TODO: use directors?
 130 //     virtual void DoCalcScrolledPosition(int x, int y, int *xx, int *yy) const;
 131 //     virtual void DoCalcUnscrolledPosition(int x, int y, int *xx, int *yy) const;
 132
 133     // Adjust the scrollbars
 134     virtual void AdjustScrollbars();
 135
 136     // Calculate scroll increment
 137     virtual int CalcScrollInc(wxScrollWinEvent& event);
 138
 139     // Normally the wxScrolledWindow will scroll itself, but in some rare
 140     // occasions you might want it to scroll [part of] another window (e.g. a
 141     // child of it in order to scroll only a portion the area between the
 142     // scrollbars (spreadsheet: only cell area will move).
 143     virtual void SetTargetWindow(wxWindow *target);
 144     virtual wxWindow *GetTargetWindow() const;
 145
 146 #ifndef __WXGTK__
 147     void SetTargetRect(const wxRect& rect);
 148     wxRect GetTargetRect() const;
 149 #endif
 150 };
 151
 152
 153 //---------------------------------------------------------------------------