warning fix

[wxWidgets.git] / wxPython / src / _constraints.i

diff --git a/wxPython/src/_constraints.i b/wxPython/src/_constraints.i
index 664e8bff30adc11ecd8942d76331d95f768cf4b8..13ceba74f90c9cde78bac7c65daebe099ee0b220 100644 (file)
--- a/wxPython/src/_constraints.i
+++ b/wxPython/src/_constraints.i
@@ -43,51 +43,58 @@ enum wxRelationship
 
 
 DocStr(wxIndividualLayoutConstraint,
 
 
 DocStr(wxIndividualLayoutConstraint,

-"Objects of this class are stored in the wx.LayoutConstraint class as one of
-eight possible constraints that a window can be involved in.  You will never
-need to create an instance of wx.IndividualLayoutConstraint, rather you should
-use create a wx.LayoutContstraints instance and use the individual contstraints
-that it contains.
+"Objects of this class are stored in the `wx.LayoutConstraints` class as
+one of eight possible constraints that a window can be involved in.
+You will never need to create an instance of
+wx.IndividualLayoutConstraint, rather you should create a
+`wx.LayoutConstraints` instance and use the individual contstraints
+that it contains.", "

 
 

-Constraints are initially set to have the relationship wx.Unconstrained, which
-means that their values should be calculated by looking at known constraints.
+Constraints are initially set to have the relationship
+wx.Unconstrained, which means that their values should be calculated
+by looking at known constraints.

 
 The Edge specifies the type of edge or dimension of a window.
 
 
 The Edge specifies the type of edge or dimension of a window.
 

- Edges
-
-    wx.Left    The left edge.
-    wx.Top     The top edge.
-    wx.Right   The right edge.
-    wx.Bottom  The bottom edge.
-    wx.CentreX         The x-coordinate of the centre of the window.
-    wx.CentreY         The y-coordinate of the centre of the window. 
-
-
-The Relationship specifies the relationship that this edge or dimension has
-with another specified edge or dimension. Normally, the user doesn't use these
-directly because functions such as Below and RightOf are a convenience for
-using the more general Set function.
-
- Relationships
-
-    wx.Unconstrained   The edge or dimension is unconstrained
+Edges
+------
+    ==================  ==============================================
+    wx.Left             The left edge.
+    wx.Top              The top edge.
+    wx.Right            The right edge.
+    wx.Bottom           The bottom edge.
+    wx.CentreX          The x-coordinate of the centre of the window.
+    wx.CentreY          The y-coordinate of the centre of the window. 
+    ==================  ==============================================
+
+
+The Relationship specifies the relationship that this edge or
+dimension has with another specified edge or dimension. Normally, the
+user doesn't use these directly because functions such as Below and
+RightOf are a convenience for using the more general Set function.
+
+Relationships
+-------------
+    ==================  ==============================================
+    wx.Unconstrained    The edge or dimension is unconstrained

                         (the default for edges.)
                         (the default for edges.)

-    wx.AsIs            The edge or dimension is to be taken from the current
+    wx.AsIs             The edge or dimension is to be taken from the current

                         window position or size (the default for dimensions.)
                         window position or size (the default for dimensions.)

-    wx.Above           The edge should be above another edge.
-    wx.Below           The edge should be below another edge.
-    wx.LeftOf          The edge should be to the left of another edge.
-    wx.RightOf                 The edge should be to the right of another edge.
-    wx.SameAs          The edge or dimension should be the same as another edge
+    wx.Above            The edge should be above another edge.
+    wx.Below            The edge should be below another edge.
+    wx.LeftOf           The edge should be to the left of another edge.
+    wx.RightOf          The edge should be to the right of another edge.
+    wx.SameAs           The edge or dimension should be the same as another edge

                         or dimension.
                         or dimension.

-    wx.PercentOf       The edge or dimension should be a percentage of another
+    wx.PercentOf        The edge or dimension should be a percentage of another

                         edge or dimension.
                         edge or dimension.

-    wx.Absolute        The edge or dimension should be a given absolute value.
+    wx.Absolute         The edge or dimension should be a given absolute value.
+    ==================  ==============================================

 
 

+:see: `wx.LayoutConstraints`, `wx.Window.SetConstraints`

 ");
 
 ");
 

-// wxIndividualLayoutConstraint: a constraint on window position
+

 class wxIndividualLayoutConstraint : public wxObject
 {
 public:
 class wxIndividualLayoutConstraint : public wxObject
 {
 public:


@@ -97,123 +104,141 @@ public:
     DocDeclStr(
         void , Set(wxRelationship rel, wxWindow *otherW, wxEdge otherE,
                    int val = 0, int marg = wxLAYOUT_DEFAULT_MARGIN),
     DocDeclStr(
         void , Set(wxRelationship rel, wxWindow *otherW, wxEdge otherE,
                    int val = 0, int marg = wxLAYOUT_DEFAULT_MARGIN),

-        "");
+        "Sets the properties of the constraint. Normally called by one of the
+convenience functions such as Above, RightOf, SameAs.", "");

     
 
      DocDeclStr(
         void , LeftOf(wxWindow *sibling, int marg = 0),
     
 
      DocDeclStr(
         void , LeftOf(wxWindow *sibling, int marg = 0),

-        "Sibling relationship");
+        "Constrains this edge to be to the left of the given window, with an
+optional margin. Implicitly, this is relative to the left edge of the
+other window.", "");

     
     DocDeclStr(
         void , RightOf(wxWindow *sibling, int marg = 0),
     
     DocDeclStr(
         void , RightOf(wxWindow *sibling, int marg = 0),

-        "Sibling relationship");
+        "Constrains this edge to be to the right of the given window, with an
+optional margin. Implicitly, this is relative to the right edge of the
+other window.", "");

     
     DocDeclStr(
         void , Above(wxWindow *sibling, int marg = 0),
     
     DocDeclStr(
         void , Above(wxWindow *sibling, int marg = 0),

-        "Sibling relationship");
+        "Constrains this edge to be above the given window, with an optional
+margin. Implicitly, this is relative to the top edge of the other
+window.", "");

     
     DocDeclStr(
         void , Below(wxWindow *sibling, int marg = 0),
     
     DocDeclStr(
         void , Below(wxWindow *sibling, int marg = 0),

-        "Sibling relationship");
+        "Constrains this edge to be below the given window, with an optional
+margin. Implicitly, this is relative to the bottom edge of the other
+window.", "");

 
     DocDeclStr(
         void , SameAs(wxWindow *otherW, wxEdge edge, int marg = 0),
 
     DocDeclStr(
         void , SameAs(wxWindow *otherW, wxEdge edge, int marg = 0),

-        "'Same edge' alignment");
+        "Constrains this edge or dimension to be to the same as the edge of the
+given window, with an optional margin.", "");

     
 
     DocDeclStr(
         void , PercentOf(wxWindow *otherW, wxEdge wh, int per),
     
 
     DocDeclStr(
         void , PercentOf(wxWindow *otherW, wxEdge wh, int per),

-        "The edge is a percentage of the other window's edge");
+        "Constrains this edge or dimension to be to a percentage of the given
+window, with an optional margin.", "");

     
 
     DocDeclStr(
         void , Absolute(int val),
     
 
     DocDeclStr(
         void , Absolute(int val),

-        "Edge has absolute value");
+        "Constrains this edge or dimension to be the given absolute value.", "");

 
     DocDeclStr(
         void , Unconstrained(),
 
     DocDeclStr(
         void , Unconstrained(),

-        "Dimension is unconstrained");
+        "Sets this edge or dimension to be unconstrained, that is, dependent on
+other edges and dimensions from which this value can be deduced.", "");

     
 
     DocDeclStr(
         void , AsIs(),
     
 
     DocDeclStr(
         void , AsIs(),

-        "Dimension is 'as is' (use current size settings)");
+        "Sets this edge or constraint to be whatever the window's value is at
+the moment. If either of the width and height constraints are *as is*,
+the window will not be resized, but moved instead. This is important
+when considering panel items which are intended to have a default
+size, such as a button, which may take its size from the size of the
+button label.", "");

     
 
     DocDeclStr(
         wxWindow *, GetOtherWindow(),
     
 
     DocDeclStr(
         wxWindow *, GetOtherWindow(),

-        "");
+        "", "");

         
     DocDeclStr(
         wxEdge , GetMyEdge() const,
         
     DocDeclStr(
         wxEdge , GetMyEdge() const,

-        "");
+        "", "");

     
     DocDeclStr(
         void , SetEdge(wxEdge which),
     
     DocDeclStr(
         void , SetEdge(wxEdge which),

-        "");
+        "", "");

     
     DocDeclStr(
         void , SetValue(int v),
     
     DocDeclStr(
         void , SetValue(int v),

-        "");
+        "", "");

     
     DocDeclStr(
         int , GetMargin(),
     
     DocDeclStr(
         int , GetMargin(),

-        "");
+        "", "");

     
     DocDeclStr(
         void , SetMargin(int m),
     
     DocDeclStr(
         void , SetMargin(int m),

-        "");
+        "", "");

     
     DocDeclStr(
         int , GetValue() const,
     
     DocDeclStr(
         int , GetValue() const,

-        "");
+        "", "");

     
     DocDeclStr(
         int , GetPercent() const,
     
     DocDeclStr(
         int , GetPercent() const,

-        "");
+        "", "");

     
     DocDeclStr(
         int , GetOtherEdge() const,
     
     DocDeclStr(
         int , GetOtherEdge() const,

-        "");
+        "", "");

     
     DocDeclStr(
         bool , GetDone() const,
     
     DocDeclStr(
         bool , GetDone() const,

-        "");
+        "", "");

     
     DocDeclStr(
         void , SetDone(bool d),
     
     DocDeclStr(
         void , SetDone(bool d),

-        "");
+        "", "");

     
     DocDeclStr(
         wxRelationship , GetRelationship(),
     
     DocDeclStr(
         wxRelationship , GetRelationship(),

-        "");
+        "", "");

     
     DocDeclStr(
         void , SetRelationship(wxRelationship r),
     
     DocDeclStr(
         void , SetRelationship(wxRelationship r),

-        "");
+        "", "");

     
 
     DocDeclStr(
         bool , ResetIfWin(wxWindow *otherW),
     
 
     DocDeclStr(
         bool , ResetIfWin(wxWindow *otherW),

-        "Reset constraint if it mentions otherWin");
+        "Reset constraint if it mentions otherWin", "");

     
 
     DocDeclStr(
         bool , SatisfyConstraint(wxLayoutConstraints *constraints, wxWindow *win),
     
 
     DocDeclStr(
         bool , SatisfyConstraint(wxLayoutConstraints *constraints, wxWindow *win),

-        "Try to satisfy constraint");
+        "Try to satisfy constraint", "");

     
 
     DocDeclStr(
         int , GetEdge(wxEdge which, wxWindow *thisWin, wxWindow *other) const,
         "Get the value of this edge or dimension, or if this\n"
     
 
     DocDeclStr(
         int , GetEdge(wxEdge which, wxWindow *thisWin, wxWindow *other) const,
         "Get the value of this edge or dimension, or if this\n"

-        "is not determinable, -1.");
+        "is not determinable, -1.", "");

 };
 
 DocStr(wxLayoutConstraints,
 };
 
 DocStr(wxLayoutConstraints,

-"Note: constraints are now deprecated and you should use sizers instead.
+"**Note:** constraints are now deprecated and you should use sizers
+instead.

 
 

-Objects of this class can be associated with a window to define its layout
-constraints, with respect to siblings or its parent.
+Objects of this class can be associated with a window to define its
+layout constraints, with respect to siblings or its parent.

 
 The class consists of the following eight constraints of class
 wx.IndividualLayoutConstraint, some or all of which should be accessed
 
 The class consists of the following eight constraints of class
 wx.IndividualLayoutConstraint, some or all of which should be accessed


@@ -228,15 +253,18 @@ directly to set the appropriate constraints.
     * centreX: represents the horizontal centre point of the window
     * centreY: represents the vertical centre point of the window 
 
     * centreX: represents the horizontal centre point of the window
     * centreY: represents the vertical centre point of the window 
 

-Most constraints are initially set to have the relationship wxUnconstrained,
-which means that their values should be calculated by looking at known
-constraints. The exceptions are width and height, which are set to wxAsIs to
-ensure that if the user does not specify a constraint, the existing width and
-height will be used, to be compatible with panel items which often have take a
-default size. If the constraint is wxAsIs, the dimension will not be changed.
-");
+Most constraints are initially set to have the relationship
+wxUnconstrained, which means that their values should be calculated by
+looking at known constraints. The exceptions are width and height,
+which are set to wxAsIs to ensure that if the user does not specify a
+constraint, the existing width and height will be used, to be
+compatible with panel items which often have take a default size. If
+the constraint is ``wx.AsIs``, the dimension will not be changed.
+
+:see: `wx.IndividualLayoutConstraint`, `wx.Window.SetConstraints`
+", "");

        
        

-// wxLayoutConstraints: the complete set of constraints for a window
+

 class wxLayoutConstraints : public wxObject
 {
 public:
 class wxLayoutConstraints : public wxObject
 {
 public:


@@ -260,7 +288,7 @@ public:
 
     DocCtorStr(
         wxLayoutConstraints(),
 
     DocCtorStr(
         wxLayoutConstraints(),

-        "");
+        "", "");

     
     DocDeclA(
         bool, SatisfyConstraints(wxWindow *win, int *OUTPUT),
     
     DocDeclA(
         bool, SatisfyConstraints(wxWindow *win, int *OUTPUT),