]>
Commit | Line | Data |
---|---|---|
0e097789 VZ |
1 | /////////////////////////////////////////////////////////////////////////////// |
2 | // Name: wx/mousestate.h | |
3 | // Purpose: Declaration of wxMouseState class | |
4 | // Author: Vadim Zeitlin | |
5 | // Created: 2008-09-19 (extracted from wx/utils.h) | |
6 | // RCS-ID: $Id$ | |
7 | // Copyright: (c) 2008 Vadim Zeitlin <vadim@wxwidgets.org> | |
8 | // Licence: wxWindows licence | |
9 | /////////////////////////////////////////////////////////////////////////////// | |
10 | ||
11 | #ifndef _WX_MOUSESTATE_H_ | |
12 | #define _WX_MOUSESTATE_H_ | |
13 | ||
1c9039c3 | 14 | #include "wx/gdicmn.h" // for wxPoint |
0e097789 VZ |
15 | #include "wx/kbdstate.h" |
16 | ||
ab826fd8 VZ |
17 | // the symbolic names for the mouse buttons |
18 | enum wxMouseButton | |
19 | { | |
20 | wxMOUSE_BTN_ANY = -1, | |
21 | wxMOUSE_BTN_NONE = 0, | |
22 | wxMOUSE_BTN_LEFT = 1, | |
23 | wxMOUSE_BTN_MIDDLE = 2, | |
24 | wxMOUSE_BTN_RIGHT = 3, | |
25 | wxMOUSE_BTN_AUX1 = 4, | |
26 | wxMOUSE_BTN_AUX2 = 5, | |
27 | wxMOUSE_BTN_MAX | |
28 | }; | |
29 | ||
0e097789 VZ |
30 | // ---------------------------------------------------------------------------- |
31 | // wxMouseState contains the information about mouse position, buttons and also | |
32 | // key modifiers | |
33 | // ---------------------------------------------------------------------------- | |
34 | ||
35 | // wxMouseState is used to hold information about button and modifier state | |
36 | // and is what is returned from wxGetMouseState. | |
37 | class WXDLLIMPEXP_CORE wxMouseState : public wxKeyboardState | |
38 | { | |
39 | public: | |
40 | wxMouseState() | |
dfa569f0 VZ |
41 | : m_leftDown(false), m_middleDown(false), m_rightDown(false), |
42 | m_aux1Down(false), m_aux2Down(false), | |
43 | m_x(0), m_y(0) | |
0e097789 VZ |
44 | { |
45 | } | |
46 | ||
47 | // default copy ctor, assignment operator and dtor are ok | |
48 | ||
49 | ||
50 | // accessors for the mouse position | |
51 | wxCoord GetX() const { return m_x; } | |
52 | wxCoord GetY() const { return m_y; } | |
53 | wxPoint GetPosition() const { return wxPoint(m_x, m_y); } | |
ab826fd8 VZ |
54 | void GetPosition(wxCoord *x, wxCoord *y) const |
55 | { | |
56 | if ( x ) | |
57 | *x = m_x; | |
58 | if ( y ) | |
59 | *y = m_y; | |
60 | } | |
61 | ||
62 | // this overload is for compatibility only | |
63 | void GetPosition(long *x, long *y) const | |
64 | { | |
65 | if ( x ) | |
66 | *x = m_x; | |
67 | if ( y ) | |
68 | *y = m_y; | |
69 | } | |
0e097789 VZ |
70 | |
71 | // accessors for the pressed buttons | |
ab826fd8 VZ |
72 | bool LeftIsDown() const { return m_leftDown; } |
73 | bool MiddleIsDown() const { return m_middleDown; } | |
74 | bool RightIsDown() const { return m_rightDown; } | |
75 | bool Aux1IsDown() const { return m_aux1Down; } | |
76 | bool Aux2IsDown() const { return m_aux2Down; } | |
77 | ||
78 | bool ButtonIsDown(wxMouseButton but) const | |
79 | { | |
80 | switch ( but ) | |
81 | { | |
82 | default: | |
83 | wxFAIL_MSG(wxT("invalid parameter in wxMouseState::ButtonIsDown")); | |
84 | // fall through | |
85 | ||
86 | case wxMOUSE_BTN_ANY: | |
87 | return LeftIsDown() || MiddleIsDown() || RightIsDown() || | |
88 | Aux1IsDown() || Aux2IsDown(); | |
89 | ||
90 | case wxMOUSE_BTN_LEFT: | |
91 | return LeftIsDown(); | |
92 | ||
93 | case wxMOUSE_BTN_MIDDLE: | |
94 | return MiddleIsDown(); | |
95 | ||
96 | case wxMOUSE_BTN_RIGHT: | |
97 | return RightIsDown(); | |
98 | ||
99 | case wxMOUSE_BTN_AUX1: | |
100 | return Aux1IsDown(); | |
101 | ||
102 | case wxMOUSE_BTN_AUX2: | |
103 | return Aux2IsDown(); | |
104 | } | |
105 | } | |
106 | ||
0e097789 VZ |
107 | |
108 | // these functions are mostly used by wxWidgets itself | |
109 | void SetX(wxCoord x) { m_x = x; } | |
110 | void SetY(wxCoord y) { m_y = y; } | |
ab826fd8 | 111 | void SetPosition(wxPoint pos) { m_x = pos.x, m_y = pos.y; } |
0e097789 VZ |
112 | |
113 | void SetLeftDown(bool down) { m_leftDown = down; } | |
114 | void SetMiddleDown(bool down) { m_middleDown = down; } | |
115 | void SetRightDown(bool down) { m_rightDown = down; } | |
116 | void SetAux1Down(bool down) { m_aux1Down = down; } | |
117 | void SetAux2Down(bool down) { m_aux2Down = down; } | |
118 | ||
ab826fd8 VZ |
119 | // this mostly makes sense in the derived classes such as wxMouseEvent |
120 | void SetState(const wxMouseState& state) { *this = state; } | |
121 | ||
c1ea6afb VZ |
122 | // these functions are for compatibility only, they were used in 2.8 |
123 | // version of wxMouseState but their names are confusing as wxMouseEvent | |
124 | // has methods with the same names which do something quite different so | |
125 | // don't use them any more | |
126 | #ifdef WXWIN_COMPATIBILITY_2_8 | |
127 | wxDEPRECATED_INLINE(bool LeftDown() const, return LeftIsDown(); ) | |
128 | wxDEPRECATED_INLINE(bool MiddleDown() const, return MiddleIsDown(); ) | |
129 | wxDEPRECATED_INLINE(bool RightDown() const, return RightIsDown(); ) | |
130 | #endif // WXWIN_COMPATIBILITY_2_8 | |
ab826fd8 VZ |
131 | |
132 | // for compatibility reasons these variables are public as the code using | |
133 | // wxMouseEvent often uses them directly -- however they should not be | |
134 | // accessed directly in this class, use the accessors above instead | |
135 | // private: | |
0e097789 VZ |
136 | bool m_leftDown : 1; |
137 | bool m_middleDown : 1; | |
138 | bool m_rightDown : 1; | |
139 | bool m_aux1Down : 1; | |
140 | bool m_aux2Down : 1; | |
141 | ||
142 | wxCoord m_x, | |
143 | m_y; | |
144 | }; | |
145 | ||
146 | #endif // _WX_MOUSESTATE_H_ | |
147 |