revised m*h headers
[wxWidgets.git] / interface / wx / mousestate.h
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: wx/mousestate.h
3 // Purpose: documentation of wxMouseState
4 // Author: wxWidgets team
5 // Created: 2008-09-19
6 // RCS-ID: $Id$
7 // Licence: wxWindows license
8 /////////////////////////////////////////////////////////////////////////////
9
10
11 /**
12 @class wxMouseState
13
14 Represents the mouse state.
15
16 This class is used as a base class by wxMouseEvent and so its methods may
17 be used to obtain information about the mouse state for the mouse events.
18 It also inherits from wxKeyboardState and so carries information about the
19 keyboard state and not only the mouse one.
20
21 This class is implemented entirely inline in @<wx/mousestate.h@> and thus
22 has no linking requirements.
23
24 @nolibrary
25 @category{misc}
26
27 @see wxGetMouseState(), wxMouseEvent
28 */
29 class wxMouseState : public wxKeyboardState
30 {
31 public:
32 /**
33 Default constructor.
34 */
35 wxMouseState();
36
37 /**
38 Returns X coordinate of the physical mouse event position.
39 */
40 wxCoord GetX() const;
41
42 /**
43 Returns Y coordinate of the physical mouse event position.
44 */
45 wxCoord GetY() const;
46
47 /**
48 Returns the physical mouse position.
49 */
50 wxPoint GetPosition() const;
51
52 /**
53 Returns @true if the left mouse button changed to down.
54 */
55 bool LeftDown() const;
56
57 /**
58 Returns @true if the middle mouse button changed to down.
59 */
60 bool MiddleDown() const;
61
62 /**
63 Returns @true if the right mouse button changed to down.
64 */
65 bool RightDown() const;
66
67 /**
68 Returns @true if the first extra button mouse button changed to down.
69 */
70 bool Aux1Down() const;
71
72 /**
73 Returns @true if the second extra button mouse button changed to down.
74 */
75 bool Aux2Down() const;
76 };
77
78