wxPython/src/_constraints.i

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        _constraints.i
   3 // Purpose:     SWIG interface defs for the layout constraints
   4 //
   5 // Author:      Robin Dunn
   6 //
   7 // Created:     3-July-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 enum wxEdge
  26 {
  27     wxLeft, wxTop, wxRight, wxBottom, wxWidth, wxHeight,
  28     wxCentre, wxCenter = wxCentre, wxCentreX, wxCentreY
  29 };
  30
  31 enum wxRelationship
  32 {
  33     wxUnconstrained = 0,
  34     wxAsIs,
  35     wxPercentOf,
  36     wxAbove,
  37     wxBelow,
  38     wxLeftOf,
  39     wxRightOf,
  40     wxSameAs,
  41     wxAbsolute
  42 };
  43
  44
  45 DocStr(wxIndividualLayoutConstraint,
  46 "Objects of this class are stored in the `wx.LayoutConstraints` class as
  47 one of eight possible constraints that a window can be involved in.
  48 You will never need to create an instance of
  49 wx.IndividualLayoutConstraint, rather you should create a
  50 `wx.LayoutConstraints` instance and use the individual contstraints
  51 that it contains.", "
  52
  53 Constraints are initially set to have the relationship
  54 wx.Unconstrained, which means that their values should be calculated
  55 by looking at known constraints.
  56
  57 The Edge specifies the type of edge or dimension of a window.
  58
  59 Edges
  60 ------
  61     ==================  ==============================================
  62     wx.Left             The left edge.
  63     wx.Top              The top edge.
  64     wx.Right            The right edge.
  65     wx.Bottom           The bottom edge.
  66     wx.CentreX          The x-coordinate of the centre of the window.
  67     wx.CentreY          The y-coordinate of the centre of the window.
  68     ==================  ==============================================
  69
  70
  71 The Relationship specifies the relationship that this edge or
  72 dimension has with another specified edge or dimension. Normally, the
  73 user doesn't use these directly because functions such as Below and
  74 RightOf are a convenience for using the more general Set function.
  75
  76 Relationships
  77 -------------
  78     ==================  ==============================================
  79     wx.Unconstrained    The edge or dimension is unconstrained
  80                         (the default for edges.)
  81     wx.AsIs             The edge or dimension is to be taken from the current
  82                         window position or size (the default for dimensions.)
  83     wx.Above            The edge should be above another edge.
  84     wx.Below            The edge should be below another edge.
  85     wx.LeftOf           The edge should be to the left of another edge.
  86     wx.RightOf          The edge should be to the right of another edge.
  87     wx.SameAs           The edge or dimension should be the same as another edge
  88                         or dimension.
  89     wx.PercentOf        The edge or dimension should be a percentage of another
  90                         edge or dimension.
  91     wx.Absolute         The edge or dimension should be a given absolute value.
  92     ==================  ==============================================
  93
  94 :see: `wx.LayoutConstraints`, `wx.Window.SetConstraints`
  95 ");
  96
  97
  98 class wxIndividualLayoutConstraint : public wxObject
  99 {
 100 public:
 101 //    wxIndividualLayoutConstraint();
 102 //    ~wxIndividualLayoutConstraint();
 103
 104     DocDeclStr(
 105         void , Set(wxRelationship rel, wxWindow *otherW, wxEdge otherE,
 106                    int val = 0, int marg = wxLAYOUT_DEFAULT_MARGIN),
 107         "Sets the properties of the constraint. Normally called by one of the
 108 convenience functions such as Above, RightOf, SameAs.", "");
 109
 110
 111      DocDeclStr(
 112         void , LeftOf(wxWindow *sibling, int marg = 0),
 113         "Constrains this edge to be to the left of the given window, with an
 114 optional margin. Implicitly, this is relative to the left edge of the
 115 other window.", "");
 116
 117     DocDeclStr(
 118         void , RightOf(wxWindow *sibling, int marg = 0),
 119         "Constrains this edge to be to the right of the given window, with an
 120 optional margin. Implicitly, this is relative to the right edge of the
 121 other window.", "");
 122
 123     DocDeclStr(
 124         void , Above(wxWindow *sibling, int marg = 0),
 125         "Constrains this edge to be above the given window, with an optional
 126 margin. Implicitly, this is relative to the top edge of the other
 127 window.", "");
 128
 129     DocDeclStr(
 130         void , Below(wxWindow *sibling, int marg = 0),
 131         "Constrains this edge to be below the given window, with an optional
 132 margin. Implicitly, this is relative to the bottom edge of the other
 133 window.", "");
 134
 135     DocDeclStr(
 136         void , SameAs(wxWindow *otherW, wxEdge edge, int marg = 0),
 137         "Constrains this edge or dimension to be to the same as the edge of the
 138 given window, with an optional margin.", "");
 139
 140
 141     DocDeclStr(
 142         void , PercentOf(wxWindow *otherW, wxEdge wh, int per),
 143         "Constrains this edge or dimension to be to a percentage of the given
 144 window, with an optional margin.", "");
 145
 146
 147     DocDeclStr(
 148         void , Absolute(int val),
 149         "Constrains this edge or dimension to be the given absolute value.", "");
 150
 151     DocDeclStr(
 152         void , Unconstrained(),
 153         "Sets this edge or dimension to be unconstrained, that is, dependent on
 154 other edges and dimensions from which this value can be deduced.", "");
 155
 156
 157     DocDeclStr(
 158         void , AsIs(),
 159         "Sets this edge or constraint to be whatever the window's value is at
 160 the moment. If either of the width and height constraints are *as is*,
 161 the window will not be resized, but moved instead. This is important
 162 when considering panel items which are intended to have a default
 163 size, such as a button, which may take its size from the size of the
 164 button label.", "");
 165
 166
 167     DocDeclStr(
 168         wxWindow *, GetOtherWindow(),
 169         "", "");
 170
 171     DocDeclStr(
 172         wxEdge , GetMyEdge() const,
 173         "", "");
 174
 175     DocDeclStr(
 176         void , SetEdge(wxEdge which),
 177         "", "");
 178
 179     DocDeclStr(
 180         void , SetValue(int v),
 181         "", "");
 182
 183     DocDeclStr(
 184         int , GetMargin(),
 185         "", "");
 186
 187     DocDeclStr(
 188         void , SetMargin(int m),
 189         "", "");
 190
 191     DocDeclStr(
 192         int , GetValue() const,
 193         "", "");
 194
 195     DocDeclStr(
 196         int , GetPercent() const,
 197         "", "");
 198
 199     DocDeclStr(
 200         int , GetOtherEdge() const,
 201         "", "");
 202
 203     DocDeclStr(
 204         bool , GetDone() const,
 205         "", "");
 206
 207     DocDeclStr(
 208         void , SetDone(bool d),
 209         "", "");
 210
 211     DocDeclStr(
 212         wxRelationship , GetRelationship(),
 213         "", "");
 214
 215     DocDeclStr(
 216         void , SetRelationship(wxRelationship r),
 217         "", "");
 218
 219
 220     DocDeclStr(
 221         bool , ResetIfWin(wxWindow *otherW),
 222         "Reset constraint if it mentions otherWin", "");
 223
 224
 225     DocDeclStr(
 226         bool , SatisfyConstraint(wxLayoutConstraints *constraints, wxWindow *win),
 227         "Try to satisfy constraint", "");
 228
 229
 230     DocDeclStr(
 231         int , GetEdge(wxEdge which, wxWindow *thisWin, wxWindow *other) const,
 232         "Get the value of this edge or dimension, or if this\n"
 233         "is not determinable, -1.", "");
 234 };
 235
 236 DocStr(wxLayoutConstraints,
 237 "**Note:** constraints are now deprecated and you should use sizers
 238 instead.
 239
 240 Objects of this class can be associated with a window to define its
 241 layout constraints, with respect to siblings or its parent.
 242
 243 The class consists of the following eight constraints of class
 244 wx.IndividualLayoutConstraint, some or all of which should be accessed
 245 directly to set the appropriate constraints.
 246
 247     * left: represents the left hand edge of the window
 248     * right: represents the right hand edge of the window
 249     * top: represents the top edge of the window
 250     * bottom: represents the bottom edge of the window
 251     * width: represents the width of the window
 252     * height: represents the height of the window
 253     * centreX: represents the horizontal centre point of the window
 254     * centreY: represents the vertical centre point of the window
 255
 256 Most constraints are initially set to have the relationship
 257 wxUnconstrained, which means that their values should be calculated by
 258 looking at known constraints. The exceptions are width and height,
 259 which are set to wxAsIs to ensure that if the user does not specify a
 260 constraint, the existing width and height will be used, to be
 261 compatible with panel items which often have take a default size. If
 262 the constraint is ``wx.AsIs``, the dimension will not be changed.
 263
 264 :see: `wx.IndividualLayoutConstraint`, `wx.Window.SetConstraints`
 265 ", "");
 266
 267
 268 class wxLayoutConstraints : public wxObject
 269 {
 270 public:
 271     %immutable;
 272
 273     // Edge constraints
 274     wxIndividualLayoutConstraint left;
 275     wxIndividualLayoutConstraint top;
 276     wxIndividualLayoutConstraint right;
 277     wxIndividualLayoutConstraint bottom;
 278
 279     // Size constraints
 280     wxIndividualLayoutConstraint width;
 281     wxIndividualLayoutConstraint height;
 282
 283     // Centre constraints
 284     wxIndividualLayoutConstraint centreX;
 285     wxIndividualLayoutConstraint centreY;
 286
 287     %mutable;
 288
 289     DocCtorStr(
 290         wxLayoutConstraints(),
 291         "", "");
 292
 293     DocDeclA(
 294         bool, SatisfyConstraints(wxWindow *win, int *OUTPUT),
 295         "SatisfyConstraints(Window win) -> (areSatisfied, noChanges)");
 296
 297     bool AreSatisfied() const;
 298 };
 299
 300 //---------------------------------------------------------------------------