]> git.saurik.com Git - wxWidgets.git/blobdiff - interface/layout.h
Added the function and macro group pages for Doxygen.
[wxWidgets.git] / interface / layout.h
index 7b9279fec19cc5fbdf6de3fb2b8cbae3002816d6..cdfc160005e50bf10372c888a3abde261b5b2722 100644 (file)
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        layout.h
-// Purpose:     documentation for wxIndividualLayoutConstraint class
+// Purpose:     interface of wxIndividualLayoutConstraint
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
@@ -9,20 +9,19 @@
 /**
     @class wxIndividualLayoutConstraint
     @wxheader{layout.h}
-    
+
     Objects of this class are stored in the wxLayoutConstraint class
     as one of eight possible constraints that a window can be involved in.
-    
+
     Constraints are initially set to have the relationship wxUnconstrained,
     which means that their values should be calculated by looking at known
     constraints.
-    
+
     @library{wxcore}
     @category{winlayout}
-    
-    @seealso
-    @ref overview_constraintsoverview "Overview and examples", wxLayoutConstraints,
-    wxWindow::SetConstraints.
+
+    @see @ref overview_constraintsoverview "Overview and examples",
+    wxLayoutConstraints, wxWindow::SetConstraints.
 */
 class wxIndividualLayoutConstraint : public wxObject
 {
@@ -37,7 +36,7 @@ public:
         optional margin. Implicitly, this is relative to the top edge of the other
         window.
     */
-    void Above(wxWindow * otherWin, int margin = 0);
+    void Above(wxWindow* otherWin, int margin = 0);
 
     /**
         Constrains this edge or dimension to be the given absolute value.
@@ -52,14 +51,14 @@ public:
         to have a default size, such as a button, which may take its size
         from the size of the button label.
     */
-#define void AsIs()     /* implementation is private */
+    void AsIs();
 
     /**
         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.
     */
-    void Below(wxWindow * otherWin, int margin = 0);
+    void Below(wxWindow* otherWin, int margin = 0);
 
     /**
         The @e wxEdge enumerated type specifies the type of edge or dimension of a
@@ -67,32 +66,26 @@ public:
         
         wxLeft
         
-        
         The left edge.
         
         wxTop
         
-        
         The top edge.
         
         wxRight
         
-        
         The right edge.
         
         wxBottom
         
-        
         The bottom edge.
         
         wxCentreX
         
-        
         The x-coordinate of the centre of the window.
         
         wxCentreY
         
-        
         The y-coordinate of the centre of the window.
         
         The @e wxRelationship enumerated type specifies the relationship that
@@ -104,49 +97,40 @@ public:
         
         wxUnconstrained
         
-        
         The edge or dimension is unconstrained (the default for edges.
         
         wxAsIs
         
-        
         The edge or dimension is to be taken from the current window position or size
         (the
         default for dimensions.
         
         wxAbove
         
-        
         The edge should be above another edge.
         
         wxBelow
         
-        
         The edge should be below another edge.
         
         wxLeftOf
         
-        
         The edge should be to the left of another edge.
         
         wxRightOf
         
-        
         The edge should be to the right of another edge.
         
         wxSameAs
         
-        
         The edge or dimension should be the same as another edge or dimension.
         
         wxPercentOf
         
-        
         The edge or dimension should be a percentage of another edge or dimension.
         
         wxAbsolute
         
-        
         The edge or dimension should be a given absolute value.
     */
 
@@ -156,36 +140,36 @@ public:
         optional margin. Implicitly, this is relative to the left edge of the other
         window.
     */
-    void LeftOf(wxWindow * otherWin, int margin = 0);
+    void LeftOf(wxWindow* otherWin, int margin = 0);
 
     /**
         Constrains this edge or dimension to be to a percentage of the given window,
         with an
         optional margin.
     */
-    void PercentOf(wxWindow * otherWin, wxEdge edge, int per);
+    void PercentOf(wxWindow* otherWin, wxEdge edge, int per);
 
     /**
         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.
     */
-    void RightOf(wxWindow * otherWin, int margin = 0);
+    void RightOf(wxWindow* otherWin, int margin = 0);
 
     /**
         Constrains this edge or dimension to be to the same as the edge of the given
         window, with an
         optional margin.
     */
-    void SameAs(wxWindow * otherWin, wxEdge edge, int margin = 0);
+    void SameAs(wxWindow* otherWin, wxEdge edge, int margin = 0);
 
     /**
         Sets the properties of the constraint. Normally called by one of the convenience
         functions such as Above, RightOf, SameAs.
     */
-#define void Set(wxRelationship rel, wxWindow * otherWin,
+    void Set(wxRelationship rel, wxWindow* otherWin,
              wxEdge otherEdge, int value = 0,
-             int margin = 0)     /* implementation is private */
+             int margin = 0);
 
     /**
         Sets this edge or dimension to be unconstrained, that is, dependent on
@@ -195,20 +179,21 @@ public:
 };
 
 
+
 /**
     @class wxLayoutConstraints
     @wxheader{layout.h}
-    
-    @b Note: constraints are now deprecated and you should use sizers instead.
-    
+
+    @b 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.
-    
+
     The class consists of the following eight constraints of class
     wxIndividualLayoutConstraint,
     some or all of which should be accessed directly to set the appropriate
     constraints.
-    
+
      @b left: represents the left hand edge of the window
      @b right: represents the right hand edge of the window
      @b top: represents the top edge of the window
@@ -217,7 +202,7 @@ public:
      @b height: represents the height of the window
      @b centreX: represents the horizontal centre point of the window
      @b 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.
@@ -226,21 +211,20 @@ public:
     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.
-    
+
     @b wxPerl note: In wxPerl the constraints are accessed as
-    
+
     @code
     constraint = Wx::LayoutConstraints-new();
       constraint-centreX-AsIs();
       constraint-centreY-Unconstrained();
     @endcode
-    
-    
+
+
     @library{wxcore}
     @category{winlayout}
-    
-    @seealso
-    @ref overview_constraintsoverview "Overview and examples",
+
+    @see @ref overview_constraintsoverview "Overview and examples",
     wxIndividualLayoutConstraint, wxWindow::SetConstraints
 */
 class wxLayoutConstraints : public wxObject
@@ -253,56 +237,49 @@ public:
 
     /**
         wxIndividualLayoutConstraint bottom
-        
         Constraint for the bottom edge.
     */
 
 
     /**
         wxIndividualLayoutConstraint centreX
-        
         Constraint for the horizontal centre point.
     */
 
 
     /**
         wxIndividualLayoutConstraint centreY
-        
         Constraint for the vertical centre point.
     */
 
 
     /**
         wxIndividualLayoutConstraint height
-        
         Constraint for the height.
     */
 
 
     /**
         wxIndividualLayoutConstraint left
-        
         Constraint for the left-hand edge.
     */
 
 
     /**
         wxIndividualLayoutConstraint right
-        
         Constraint for the right-hand edge.
     */
 
 
     /**
         wxIndividualLayoutConstraint top
-        
         Constraint for the top edge.
     */
 
 
     /**
         wxIndividualLayoutConstraint width
-        
         Constraint for the width.
     */
 };
+