]>
Commit | Line | Data |
---|---|---|
1e6feb95 VZ |
1 | /////////////////////////////////////////////////////////////////////////////// |
2 | // Name: wx/univ/scrolbar.h | |
3 | // Purpose: wxScrollBar for wxUniversal | |
4 | // Author: Vadim Zeitlin | |
5 | // Modified by: | |
6 | // Created: 20.08.00 | |
7 | // RCS-ID: $Id$ | |
8 | // Copyright: (c) 2000 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr> | |
9 | // Licence: wxWindows license | |
10 | /////////////////////////////////////////////////////////////////////////////// | |
11 | ||
12 | #ifndef _WX_UNIV_SCROLBAR_H_ | |
13 | #define _WX_UNIV_SCROLBAR_H_ | |
14 | ||
15 | #ifdef __GNUG__ | |
16 | #pragma interface "univscrolbar.h" | |
17 | #endif | |
18 | ||
19 | class WXDLLEXPORT wxScrollTimer; | |
20 | ||
21 | #include "wx/univ/scrarrow.h" | |
22 | ||
23 | // ---------------------------------------------------------------------------- | |
24 | // the actions supported by this control | |
25 | // ---------------------------------------------------------------------------- | |
26 | ||
27 | // scroll the bar | |
28 | #define wxACTION_SCROLL_START _T("start") // to the beginning | |
29 | #define wxACTION_SCROLL_END _T("end") // to the end | |
30 | #define wxACTION_SCROLL_LINE_UP _T("lineup") // one line up/left | |
31 | #define wxACTION_SCROLL_PAGE_UP _T("pageup") // one page up/left | |
32 | #define wxACTION_SCROLL_LINE_DOWN _T("linedown") // one line down/right | |
33 | #define wxACTION_SCROLL_PAGE_DOWN _T("pagedown") // one page down/right | |
34 | ||
35 | // the scrollbar thumb may be dragged | |
36 | #define wxACTION_SCROLL_THUMB_DRAG _T("thumbdrag") | |
37 | #define wxACTION_SCROLL_THUMB_MOVE _T("thumbmove") | |
38 | #define wxACTION_SCROLL_THUMB_RELEASE _T("thumbrelease") | |
39 | ||
40 | // ---------------------------------------------------------------------------- | |
41 | // wxScrollBar | |
42 | // ---------------------------------------------------------------------------- | |
43 | ||
44 | class WXDLLEXPORT wxScrollBar : public wxScrollBarBase, | |
45 | public wxControlWithArrows | |
46 | { | |
47 | public: | |
48 | // scrollbar elements: they correspond to wxHT_SCROLLBAR_XXX constants but | |
49 | // start from 0 which allows to use them as array indices | |
50 | enum Element | |
51 | { | |
52 | Element_Arrow_Line_1, | |
53 | Element_Arrow_Line_2, | |
54 | Element_Arrow_Page_1, | |
55 | Element_Arrow_Page_2, | |
56 | Element_Thumb, | |
57 | Element_Bar_1, | |
58 | Element_Bar_2, | |
59 | Element_Max | |
60 | }; | |
61 | ||
62 | wxScrollBar(); | |
63 | wxScrollBar(wxWindow *parent, | |
64 | wxWindowID id, | |
65 | const wxPoint& pos = wxDefaultPosition, | |
66 | const wxSize& size = wxDefaultSize, | |
67 | long style = wxSB_HORIZONTAL, | |
68 | const wxValidator& validator = wxDefaultValidator, | |
69 | const wxString& name = wxScrollBarNameStr); | |
70 | ||
71 | bool Create(wxWindow *parent, | |
72 | wxWindowID id, | |
73 | const wxPoint& pos = wxDefaultPosition, | |
74 | const wxSize& size = wxDefaultSize, | |
75 | long style = wxSB_HORIZONTAL, | |
76 | const wxValidator& validator = wxDefaultValidator, | |
77 | const wxString& name = wxScrollBarNameStr); | |
78 | ||
79 | virtual ~wxScrollBar(); | |
80 | ||
81 | // implement base class pure virtuals | |
82 | virtual int GetThumbPosition() const; | |
83 | virtual int GetThumbSize() const; | |
84 | virtual int GetPageSize() const; | |
85 | virtual int GetRange() const; | |
86 | ||
87 | virtual void SetThumbPosition(int thumbPos); | |
88 | virtual void SetScrollbar(int position, int thumbSize, | |
89 | int range, int pageSize, | |
90 | bool refresh = TRUE); | |
91 | ||
92 | // wxScrollBar actions | |
93 | void ScrollToStart(); | |
94 | void ScrollToEnd(); | |
95 | void ScrollLines(int nLines); | |
96 | void ScrollPages(int nPages); | |
97 | ||
98 | virtual bool PerformAction(const wxControlAction& action, | |
99 | long numArg = 0, | |
100 | const wxString& strArg = wxEmptyString); | |
101 | ||
102 | // wxScrollBar sub elements state (combination of wxCONTROL_XXX) | |
103 | void SetState(Element which, int flags); | |
104 | int GetState(Element which) const; | |
105 | ||
106 | // implement wxControlWithArrows methods | |
107 | virtual wxRenderer *GetRenderer() const { return m_renderer; } | |
108 | virtual wxWindow *GetWindow() { return this; } | |
109 | virtual bool IsVertical() const { return wxScrollBarBase::IsVertical(); } | |
110 | virtual int GetArrowState(wxScrollArrows::Arrow arrow) const; | |
111 | virtual void SetArrowFlag(wxScrollArrows::Arrow arrow, int flag, bool set); | |
112 | virtual bool OnArrow(wxScrollArrows::Arrow arrow); | |
113 | virtual wxScrollArrows::Arrow HitTest(const wxPoint& pt) const; | |
114 | ||
115 | // for wxControlRenderer::DrawScrollbar() only | |
116 | const wxScrollArrows& GetArrows() const { return m_arrows; } | |
117 | ||
118 | protected: | |
119 | virtual wxSize DoGetBestClientSize() const; | |
120 | virtual void DoDraw(wxControlRenderer *renderer); | |
121 | virtual wxBorder GetDefaultBorder() const { return wxBORDER_NONE; } | |
122 | ||
123 | // event handlers | |
124 | void OnIdle(wxIdleEvent& event); | |
125 | ||
126 | // SetThumbPosition() helper | |
127 | void DoSetThumb(int thumbPos); | |
128 | ||
129 | // common part of all ctors | |
130 | void Init(); | |
131 | ||
132 | private: | |
133 | // total range of the scrollbar in logical units | |
134 | int m_range; | |
135 | ||
136 | // the current and previous (after last refresh - this is used for | |
137 | // repainting optimisation) size of the thumb in logical units (from 0 to | |
138 | // m_range) and its position (from 0 to m_range - m_thumbSize) | |
139 | int m_thumbSize, | |
140 | m_thumbPos, | |
141 | m_thumbPosOld; | |
142 | ||
143 | // the page size, i.e. the number of lines by which to scroll when page | |
144 | // up/down action is performed | |
145 | int m_pageSize; | |
146 | ||
147 | // the state of the sub elements | |
148 | int m_elementsState[Element_Max]; | |
149 | ||
150 | // the dirty flag: if set, scrollbar must be updated | |
151 | bool m_dirty; | |
152 | ||
153 | // the object handling the arrows | |
154 | wxScrollArrows m_arrows; | |
155 | ||
156 | DECLARE_EVENT_TABLE() | |
157 | DECLARE_DYNAMIC_CLASS(wxScrollBar) | |
158 | }; | |
159 | ||
160 | // ---------------------------------------------------------------------------- | |
161 | // common scrollbar input handler: it manages clicks on the standard scrollbar | |
162 | // elements (line arrows, bar, thumb) | |
163 | // ---------------------------------------------------------------------------- | |
164 | ||
165 | class WXDLLEXPORT wxStdScrollBarInputHandler : public wxStdInputHandler | |
166 | { | |
167 | public: | |
168 | // constructor takes a renderer (used for scrollbar hit testing) and the | |
169 | // base handler to which all unhandled events are forwarded | |
170 | wxStdScrollBarInputHandler(wxRenderer *renderer, | |
171 | wxInputHandler *inphand); | |
172 | ||
173 | virtual bool HandleKey(wxControl *control, | |
174 | const wxKeyEvent& event, | |
175 | bool pressed); | |
176 | virtual bool HandleMouse(wxControl *control, | |
177 | const wxMouseEvent& event); | |
178 | virtual bool HandleMouseMove(wxControl *control, const wxMouseEvent& event); | |
179 | ||
180 | virtual ~wxStdScrollBarInputHandler(); | |
181 | ||
182 | // this method is called by wxScrollBarTimer only and may be overridden | |
183 | // | |
184 | // return TRUE to continue scrolling, FALSE to stop the timer | |
185 | virtual bool OnScrollTimer(wxScrollBar *scrollbar, | |
186 | const wxControlAction& action); | |
187 | ||
188 | protected: | |
189 | // the methods which must be overridden in the derived class | |
190 | ||
191 | // return TRUE if the mouse button can be used to activate scrollbar, FALSE | |
192 | // if not (only left mouse button can do it under Windows, any button under | |
193 | // GTK+) | |
194 | virtual bool IsAllowedButton(int button) = 0; | |
195 | ||
196 | // set or clear the specified flag on the scrollbar element corresponding | |
197 | // to m_htLast | |
198 | void SetElementState(wxScrollBar *scrollbar, int flag, bool doIt); | |
199 | ||
200 | // [un]highlight the scrollbar element corresponding to m_htLast | |
201 | virtual void Highlight(wxScrollBar *scrollbar, bool doIt) | |
202 | { SetElementState(scrollbar, wxCONTROL_CURRENT, doIt); } | |
203 | ||
204 | // [un]press the scrollbar element corresponding to m_htLast | |
205 | virtual void Press(wxScrollBar *scrollbar, bool doIt) | |
206 | { SetElementState(scrollbar, wxCONTROL_PRESSED, doIt); } | |
207 | ||
208 | // stop scrolling because we reached the end point | |
209 | void StopScrolling(wxScrollBar *scrollbar); | |
210 | ||
211 | // get the mouse coordinates in the scrollbar direction from the event | |
212 | wxCoord GetMouseCoord(const wxScrollBar *scrollbar, | |
213 | const wxMouseEvent& event) const; | |
214 | ||
215 | // generate a "thumb move" action for this mouse event | |
216 | void HandleThumbMove(wxScrollBar *scrollbar, const wxMouseEvent& event); | |
217 | ||
218 | // the window (scrollbar) which has capture or NULL and the flag telling if | |
219 | // the mouse is inside the element which captured it or not | |
220 | wxWindow *m_winCapture; | |
221 | bool m_winHasMouse; | |
222 | int m_btnCapture; // the mouse button which has captured mouse | |
223 | ||
224 | // the position where we started scrolling by page | |
225 | wxPoint m_ptStartScrolling; | |
226 | ||
227 | // one of wxHT_SCROLLBAR_XXX value: where has the mouse been last time? | |
228 | wxHitTest m_htLast; | |
229 | ||
230 | // the renderer (we use it only for hit testing) | |
231 | wxRenderer *m_renderer; | |
232 | ||
233 | // the offset of the top/left of the scrollbar relative to the mouse to | |
234 | // keep during the thumb drag | |
235 | int m_ofsMouse; | |
236 | ||
237 | // the timer for generating scroll events when the mouse stays pressed on | |
238 | // a scrollbar | |
239 | wxScrollTimer *m_timerScroll; | |
240 | }; | |
241 | ||
242 | #endif // _WX_UNIV_SCROLBAR_H_ | |
243 |