make wxMouseState accessors const; document this class

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@53251 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

include/wx/utils.h

@@ -222,20 +222,20 @@ public:
           m_metaDown(false)
     {}
 
-    wxCoord     GetX() { return m_x; }
+    wxCoord GetX() const { return m_x; }
-    wxCoord     GetY() { return m_y; }
+    wxCoord GetY() const { return m_y; }
 
-    bool        LeftDown()    { return m_leftDown; }
+    bool LeftDown()    const { return m_leftDown; }
-    bool        MiddleDown()  { return m_middleDown; }
+    bool MiddleDown()  const { return m_middleDown; }
-    bool        RightDown()   { return m_rightDown; }
+    bool RightDown()   const { return m_rightDown; }
-    bool        Aux1Down()    { return m_aux1Down; }
+    bool Aux1Down()    const { return m_aux1Down; }
-    bool        Aux2Down()    { return m_aux2Down; }
+    bool Aux2Down()    const { return m_aux2Down; }
 
-    bool        ControlDown() { return m_controlDown; }
+    bool ControlDown() const { return m_controlDown; }
-    bool        ShiftDown()   { return m_shiftDown; }
+    bool ShiftDown()   const { return m_shiftDown; }
-    bool        AltDown()     { return m_altDown; }
+    bool AltDown()     const { return m_altDown; }
-    bool        MetaDown()    { return m_metaDown; }
+    bool MetaDown()    const { return m_metaDown; }
-    bool        CmdDown()
+    bool CmdDown() const
     {
 #if defined(__WXMAC__) || defined(__WXCOCOA__)
         return MetaDown();
@@ -259,8 +259,8 @@ public:
     void SetMetaDown(bool down)    { m_metaDown = down; }
 
 private:
-    wxCoord     m_x;
+    wxCoord m_x,
-    wxCoord     m_y;
+            m_y;
 
     bool m_leftDown     : 1;
     bool m_middleDown   : 1;

interface/utils.h

@@ -88,6 +88,49 @@ public:
 };
 
 
+/**
+    @class wxMouseState
+    @wxheader{utils.h}
+
+    Represents the mouse state.
+
+    The methods of this class generally mirror the corresponding methods of
+    wxMouseEvent.
+
+    @see wxGetMouseState()
+ */
+class wxMouseState
+{
+public:
+    /// Returns X coordinate of the physical mouse event position.
+    wxCoord GetX() const;
+
+    /// Returns Y coordinate of the physical mouse event position.
+    wxCoord GetY() const;
+
+    /// Returns @true if the left mouse button changed to down.
+    bool LeftDown() const;
+    /// Returns @true if the middle mouse button changed to down.
+    bool MiddleDown() const;
+    /// Returns @true if the right mouse button changed to down.
+    bool RightDown() const;
+    /// Returns @true if the first extra button mouse button changed to down.
+    bool Aux1Down() const;
+    /// Returns @true if the second extra button mouse button changed to down.
+    bool Aux2Down() const;
+
+    /// Returns @true if the control key is down.
+    bool ControlDown() const;
+    /// Returns @true if the shift key is down.
+    bool ShiftDown() const;
+    /// Returns @true if the alt key is down.
+    bool AltDown() const;
+    /// Returns @true if the meta key is down.
+    bool MetaDown() const;
+    /// Same as MetaDown() under Mac systems, ControlDown() for the others.
+    bool CmdDown() const;
+};
+
 
 // ============================================================================
 // Global functions/macros