1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
|
/*************************************************************************
*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* Copyright 2000, 2010 Oracle and/or its affiliates.
*
* OpenOffice.org - a multi-platform office productivity suite
*
* This file is part of OpenOffice.org.
*
* OpenOffice.org is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License version 3
* only, as published by the Free Software Foundation.
*
* OpenOffice.org is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License version 3 for more details
* (a copy is included in the LICENSE file that accompanied this code).
*
* You should have received a copy of the GNU Lesser General Public License
* version 3 along with OpenOffice.org. If not, see
* <http://www.openoffice.org/license.html>
* for a copy of the LGPLv3 License.
*
************************************************************************/
#ifndef SD_SLIDESORTER_SLIDE_SORTER_SCROLL_BAR_MANAGER_HXX
#define SD_SLIDESORTER_SLIDE_SORTER_SCROLL_BAR_MANAGER_HXX
#include <tools/link.hxx>
#include <tools/gen.hxx>
#include <vcl/timer.hxx>
#include <boost/shared_ptr.hpp>
class Point;
class Rectangle;
class ScrollBar;
class ScrollBarBox;
class Window;
namespace sd {
class Window;
}
namespace sd { namespace slidesorter {
class SlideSorter;
} }
namespace sd { namespace slidesorter { namespace controller {
/** Manage the horizontal and vertical scroll bars. Listen for events, set
their sizes, place them in the window, determine their visibilities.
<p>Handle auto scrolling, i.e. the scrolling of the window when the
mouse comes near the window border while dragging a selection.</p>
<p>In order to make the slide sorter be used in the task pane with its
own vertical scrollbars the vertical scrollbar of the use of the slide
sorter is optional. When using it the available area in a window is
used and the vertical scrollbar is displayed when that area is not large
enough. When the vertical scrollbar is not used then the available area
is assumed to be modifiable. In that case the PlaceScrollBars() method
may return an area larger than the one given.<p>
*/
class ScrollBarManager
{
public:
/** Create a new scroll bar manager that manages three controls: the
horizontal scroll bar, the vertical scroll bar, and the little
window that fills the gap at the bottom right corner that is left
between the two scroll bars. Call LateInitialization() after
constructing a new object.
*/
ScrollBarManager (SlideSorter& rSlideSorter);
~ScrollBarManager (void);
/** Call this method after constructing a new object of this class.
*/
void LateInitialization (void);
/** Register listeners at the scroll bars. This method is called after
startup of a new slide sorter object or after a reactivation of a
slide sorter that for example is taken from a cache.
*/
void Connect (void);
/** Remove listeners from the scroll bars. This method is called whent
the slide sorter is destroyed or when it is suspended, e.g. put
into a cache for later reuse.
*/
void Disconnect (void);
/** Set up the scroll bar, i.e. thumb size and position. Call this
method when the content of the browser window changed, i.e. pages
were inserted or deleted, the layout or the zoom factor has
changed.
@param bResetThumbPosition
When <TRUE/> then set the thumb position to position 0. This is
done when e.g. switching between master page mode and draw mode.
@param bScrollToCurrentPosition
When <TRUE/> then scroll the window to the new offset that is
defined by the scroll bars. Otherwise the new offset is simply
set and the whole window is repainted.
*/
void UpdateScrollBars (
bool bResetThumbPosition = false,
bool bScrollToCurrentPosition = true);
/** Place the scroll bars inside the given area. When the available
area is not large enough for the content to display the resulting
behaviour depends on the mbUseVerticalScrollBar flag. When it is
set to true then a vertical scroll bar is shown. Otherwise the
height of the returned area is enlarged so that the content fits
into it.
@param rAvailableArea
The scroll bars will be placed inside this rectangle. It is
expected to be given in pixel relative to its parent.
@return
Returns the space that remains after the scroll bars are
placed. When the mbUseVerticalScrollBar flag is false then the
returned rectangle may be larger than the given one.
*/
Rectangle PlaceScrollBars (const Rectangle& rAvailableArea);
/** Update the vertical scroll bar so that the visible area has the
given top value.
*/
void SetTop (const sal_Int32 nTop);
/** Update the horizontal scroll bar so that the visible area has the
given left value.
*/
void SetLeft (const sal_Int32 nLeft);
/** Return the width of the vertical scroll bar, which--when
shown--should be fixed in contrast to its height.
@return
Returns 0 when the vertical scroll bar is not shown or does not
exist, otherwise its width in pixel is returned.
*/
int GetVerticalScrollBarWidth (void) const;
/** Return the height of the horizontal scroll bar, which--when
shown--should be fixed in contrast to its width.
@return
Returns 0 when the vertical scroll bar is not shown or does not
exist, otherwise its height in pixel is returned.
*/
int GetHorizontalScrollBarHeight (void) const;
/** Call this method to scroll a window while the mouse is in dragging a
selection. If the mouse is near the window border or is outside the
window then scroll the window accordingly.
@return
When the window is scrolled then this method returns <TRUE/>.
When the window is not changed then <FALSE/> is returned.
*/
bool AutoScroll (const Point& rMouseWindowPosition);
void StopAutoScroll (void);
private:
SlideSorter& mrSlideSorter;
/** The horizontal scroll bar. Note that is used but not owned by
objects of this class. It is given to the constructor.
*/
::boost::shared_ptr<ScrollBar> mpHorizontalScrollBar;
/** The vertical scroll bar. Note that is used but not owned by
objects of this class. It is given to the constructor.
*/
::boost::shared_ptr<ScrollBar> mpVerticalScrollBar;
/// Relative horizontal position of the visible area in the view.
double mnHorizontalPosition;
/// Relative vertical position of the visible area in the view.
double mnVerticalPosition;
/** The width and height of the border at the inside of the window which
when entered while in drag mode leads to a scrolling of the window.
*/
Size maScrollBorder;
double mnHorizontalScrollFactor;
double mnVerticalScrollFactor;
/** The only task of this little window is to paint the little square at
the bottom right corner left by the two scroll bars (when both are
visible).
*/
::boost::shared_ptr<ScrollBarBox> mpScrollBarFiller;
/** The auto scroll timer is used for keep scrolling the window when the
mouse reaches its border while dragging a selection. When the mouse
is not moved the timer issues events to keep scrolling.
*/
Timer maAutoScrollTimer;
Size maAutoScrollOffset;
/** The content window is the one whose view port is controlled by the
scroll bars.
*/
::boost::shared_ptr<sd::Window> mpContentWindow;
void SetWindowOrigin (
double nHorizontalPosition,
double nVerticalPosition);
/** Determine the visibility of the scroll bars so that the window
content is not clipped in any dimension without showing a scroll
bar.
@param rAvailableArea
The area in which the scroll bars, the scroll bar filler, and
the SlideSorterView will be placed.
@return
The area that is enclosed by the scroll bars is returned. It
will be filled with the SlideSorterView.
*/
Rectangle DetermineScrollBarVisibilities (const Rectangle& rAvailableArea);
/** Typically called by DetermineScrollBarVisibilities() this method
tests a specific configuration of the two scroll bars being visible
or hidden.
@return
When the window content can be shown with only being clipped in
an orientation where the scroll bar would be shown then <TRUE/>
is returned.
*/
bool TestScrollBarVisibilities (
bool bHorizontalScrollBarVisible,
bool bVerticalScrollBarVisible,
const Rectangle& rAvailableArea);
void CalcAutoScrollOffset (const Point& rMouseWindowPosition);
bool RepeatAutoScroll (void);
DECL_LINK(HorizontalScrollBarHandler, ScrollBar*);
DECL_LINK(VerticalScrollBarHandler, ScrollBar*);
DECL_LINK(AutoScrollTimeoutHandler, Timer*);
void PlaceHorizontalScrollBar (const Rectangle& aArea);
void PlaceVerticalScrollBar (const Rectangle& aArea);
void PlaceFiller (const Rectangle& aArea);
};
} } } // end of namespace ::sd::slidesorter::controller
#endif
|
