X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/861d483291fc24105808125c6fa442b882f3c622..2a783b2daaae6f06928e7095ebbc4fc039583907:/wxPython/src/_constraints.i diff --git a/wxPython/src/_constraints.i b/wxPython/src/_constraints.i index 664e8bff30..2af1005bf3 100644 --- a/wxPython/src/_constraints.i +++ b/wxPython/src/_constraints.i @@ -43,51 +43,58 @@ enum wxRelationship 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. - 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.) - 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.) - 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. - 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. - 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: @@ -97,123 +104,152 @@ public: 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), - "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), - "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), - "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), - "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), - "'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), - "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), - "Edge has absolute value"); + "Constrains this edge or dimension to be the given absolute value.", ""); 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(), - "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( wxEdge , GetMyEdge() const, - ""); + "", ""); DocDeclStr( void , SetEdge(wxEdge which), - ""); + "", ""); DocDeclStr( void , SetValue(int v), - ""); + "", ""); DocDeclStr( int , GetMargin(), - ""); + "", ""); DocDeclStr( void , SetMargin(int m), - ""); + "", ""); DocDeclStr( int , GetValue() const, - ""); + "", ""); DocDeclStr( int , GetPercent() const, - ""); + "", ""); DocDeclStr( int , GetOtherEdge() const, - ""); + "", ""); DocDeclStr( bool , GetDone() const, - ""); + "", ""); DocDeclStr( void , SetDone(bool d), - ""); + "", ""); DocDeclStr( wxRelationship , GetRelationship(), - ""); + "", ""); DocDeclStr( void , SetRelationship(wxRelationship r), - ""); + "", ""); DocDeclStr( bool , ResetIfWin(wxWindow *otherW), - "Reset constraint if it mentions otherWin"); + "Reset constraint if it mentions otherWin", ""); 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" - "is not determinable, -1."); + "is not determinable, -1.", ""); + + %property(Done, GetDone, SetDone, doc="See `GetDone` and `SetDone`"); + %property(Margin, GetMargin, SetMargin, doc="See `GetMargin` and `SetMargin`"); + %property(MyEdge, GetMyEdge, doc="See `GetMyEdge`"); + %property(OtherEdge, GetOtherEdge, doc="See `GetOtherEdge`"); + %property(OtherWindow, GetOtherWindow, doc="See `GetOtherWindow`"); + %property(Percent, GetPercent, doc="See `GetPercent`"); + %property(Relationship, GetRelationship, SetRelationship, doc="See `GetRelationship` and `SetRelationship`"); + %property(Value, GetValue, SetValue, doc="See `GetValue` and `SetValue`"); + }; + 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 @@ -228,15 +264,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 -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: @@ -260,7 +299,9 @@ public: DocCtorStr( wxLayoutConstraints(), - ""); + "", ""); + + ~wxLayoutConstraints(); DocDeclA( bool, SatisfyConstraints(wxWindow *win, int *OUTPUT),