X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/328f5751e8a06727b137189fe04891a9f43bfc8b..cde80c9284b64d611e8cf4a7565de40aa0acce81:/interface/position.h

diff --git a/interface/position.h b/interface/position.h
index 2813de6c23..ba5dfbd499 100644
--- a/interface/position.h
+++ b/interface/position.h
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        position.h
-// Purpose:     documentation for wxPosition class
+// Purpose:     interface of wxPosition
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
@@ -11,26 +11,30 @@
     @wxheader{position.h}
 
     This class represents the position of an item in any kind of grid of rows and
-    columns such as wxGridBagSizer, or
-    wxHVScrolledWindow.
+    columns such as wxGridBagSizer, or wxHVScrolledWindow.
+
+    @todo rename this class to wxItemPosition or such, wxPosition is too generic
 
     @library{wxbase}
-    @category{FIXME}
+    @category{data}
 
-    @seealso
-    wxPoint, wxSize
+    @see wxPoint, wxSize
 */
 class wxPosition
 {
 public:
-    //@{
+
     /**
-        Construct a new wxPosition, optionally setting the row and column. The
-        default value is (0, 0).
+        Construct a new wxPosition, setting the row and column to the
+        default value of (0, 0).
     */
     wxPosition();
+
+    /**
+        Construct a new wxPosition, setting the row and column to the
+        value of (@a row, @a col).
+    */
     wxPosition(int row, int col);
-    //@}
 
     /**
         A synonym for GetColumn().
@@ -47,22 +51,6 @@ public:
     */
     int GetRow() const;
 
-    //@{
-    /**
-        
-    */
-    bool operator ==(const wxPosition& p) const;
-    const bool operator !=(const wxPosition& p) const;
-    const wxPosition&  operator +=(const wxPosition& p) const;
-    wxPosition operator -=(const wxPosition& p) const;
-    wxPosition operator +=(const wxSize& s) const;
-    wxPosition operator -=(const wxSize& s) const;
-    wxPosition operator +(const wxPosition& p) const;
-    const wxPosition  operator -(const wxPosition& p) const;
-    const wxPosition  operator +(const wxSize& s) const;
-    const wxPosition  operator -(const wxSize& s) const;
-    //@}
-
     /**
         A synonym for SetColumn().
     */
@@ -77,4 +65,23 @@ public:
         Set a new row value.
     */
     void SetRow(int row);
+
+
+    /**
+        @name Miscellaneous operators
+
+        @{
+    */
+    bool operator ==(const wxPosition& p) const;
+    bool operator !=(const wxPosition& p) const;
+    wxPosition& operator +=(const wxPosition& p) const;
+    wxPosition& operator -=(const wxPosition& p) const;
+    wxPosition& operator +=(const wxSize& s) const;
+    wxPosition& operator -=(const wxSize& s) const;
+    wxPosition& operator +(const wxPosition& p) const;
+    wxPosition& operator -(const wxPosition& p) const;
+    wxPosition& operator +(const wxSize& s) const;
+    wxPosition& operator -(const wxSize& s) const;
+    //@}
 };
+