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
|
/*
* Copyright (C) 2004, 2006, 2014 Apple Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
* OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
#ifndef Scrollbar_h
#define Scrollbar_h
#include "ScrollbarThemeClient.h"
#include "ScrollTypes.h"
#include "Timer.h"
#include "Widget.h"
#include <wtf/PassRefPtr.h>
namespace WebCore {
class GraphicsContext;
class IntRect;
class PlatformMouseEvent;
class ScrollableArea;
class ScrollbarTheme;
class Scrollbar : public Widget,
public ScrollbarThemeClient {
public:
// Must be implemented by platforms that can't simply use the Scrollbar base class. Right now the only platform that is not using the base class is GTK.
WEBCORE_EXPORT static PassRefPtr<Scrollbar> createNativeScrollbar(ScrollableArea*, ScrollbarOrientation orientation, ScrollbarControlSize size);
virtual ~Scrollbar();
// ScrollbarThemeClient implementation.
virtual int x() const override { return Widget::x(); }
virtual int y() const override { return Widget::y(); }
virtual int width() const override { return Widget::width(); }
virtual int height() const override { return Widget::height(); }
virtual IntSize size() const override { return Widget::size(); }
virtual IntPoint location() const override { return Widget::location(); }
virtual ScrollView* parent() const override { return Widget::parent(); }
virtual ScrollView* root() const override { return Widget::root(); }
virtual void setFrameRect(const IntRect&) override;
virtual IntRect frameRect() const override { return Widget::frameRect(); }
virtual void invalidate() override { Widget::invalidate(); }
virtual void invalidateRect(const IntRect&) override;
virtual ScrollbarOverlayStyle scrollbarOverlayStyle() const override;
virtual bool isScrollableAreaActive() const override;
virtual bool isScrollViewScrollbar() const override;
virtual IntPoint convertFromContainingWindow(const IntPoint& windowPoint) override { return Widget::convertFromContainingWindow(windowPoint); }
virtual bool isCustomScrollbar() const override final { return m_isCustomScrollbar; }
virtual ScrollbarOrientation orientation() const override { return m_orientation; }
virtual int value() const override { return lroundf(m_currentPos); }
virtual float currentPos() const override { return m_currentPos; }
virtual int visibleSize() const override { return m_visibleSize; }
virtual int totalSize() const override { return m_totalSize; }
virtual int maximum() const override { return m_totalSize - m_visibleSize; }
virtual ScrollbarControlSize controlSize() const override { return m_controlSize; }
virtual int lineStep() const override { return m_lineStep; }
virtual int pageStep() const override { return m_pageStep; }
virtual ScrollbarPart pressedPart() const override { return m_pressedPart; }
virtual ScrollbarPart hoveredPart() const override { return m_hoveredPart; }
virtual void styleChanged() override { }
virtual bool enabled() const override { return m_enabled; }
virtual void setEnabled(bool) override;
// Called by the ScrollableArea when the scroll offset changes.
void offsetDidChange();
static int pixelsPerLineStep() { return 40; }
static float minFractionToStepWhenPaging() { return 0.8; }
WEBCORE_EXPORT static int maxOverlapBetweenPages();
static int pageStep(int viewWidthOrHeight, int contentWidthOrHeight) { return std::max(std::max<int>(lroundf(viewWidthOrHeight * Scrollbar::minFractionToStepWhenPaging()), lroundf(contentWidthOrHeight - Scrollbar::maxOverlapBetweenPages())), 1); }
static int pageStep(int viewWidthOrHeight) { return pageStep(viewWidthOrHeight, viewWidthOrHeight); }
static float pageStepDelta(int widthOrHeight) { return std::max(std::max(static_cast<float>(widthOrHeight) * Scrollbar::minFractionToStepWhenPaging(), static_cast<float>(widthOrHeight) - Scrollbar::maxOverlapBetweenPages()), 1.0f); }
void disconnectFromScrollableArea() { m_scrollableArea = 0; }
ScrollableArea* scrollableArea() const { return m_scrollableArea; }
int pressedPos() const { return m_pressedPos; }
float pixelStep() const { return m_pixelStep; }
virtual void setHoveredPart(ScrollbarPart);
virtual void setPressedPart(ScrollbarPart);
WEBCORE_EXPORT void setSteps(int lineStep, int pageStep, int pixelsPerStep = 1);
WEBCORE_EXPORT void setProportion(int visibleSize, int totalSize);
void setPressedPos(int p) { m_pressedPos = p; }
virtual void paint(GraphicsContext*, const IntRect& damageRect) override;
virtual bool isOverlayScrollbar() const override;
bool shouldParticipateInHitTesting();
bool isWindowActive() const;
// These methods are used for platform scrollbars to give :hover feedback. They will not get called
// when the mouse went down in a scrollbar, since it is assumed the scrollbar will start
// grabbing all events in that case anyway.
#if !PLATFORM(IOS)
WEBCORE_EXPORT bool mouseMoved(const PlatformMouseEvent&);
#endif
WEBCORE_EXPORT void mouseEntered();
WEBCORE_EXPORT bool mouseExited();
// Used by some platform scrollbars to know when they've been released from capture.
WEBCORE_EXPORT bool mouseUp(const PlatformMouseEvent&);
WEBCORE_EXPORT bool mouseDown(const PlatformMouseEvent&);
ScrollbarTheme* theme() const { return m_theme; }
virtual void setParent(ScrollView*) override;
bool suppressInvalidation() const { return m_suppressInvalidation; }
void setSuppressInvalidation(bool s) { m_suppressInvalidation = s; }
virtual IntRect convertToContainingView(const IntRect&) const override;
virtual IntRect convertFromContainingView(const IntRect&) const override;
virtual IntPoint convertToContainingView(const IntPoint&) const override;
virtual IntPoint convertFromContainingView(const IntPoint&) const override;
void moveThumb(int pos, bool draggingDocument = false);
virtual bool isAlphaLocked() const override { return m_isAlphaLocked; }
virtual void setIsAlphaLocked(bool flag) override { m_isAlphaLocked = flag; }
virtual bool supportsUpdateOnSecondaryThread() const;
protected:
Scrollbar(ScrollableArea*, ScrollbarOrientation, ScrollbarControlSize, ScrollbarTheme* = 0, bool isCustomScrollbar = false);
void updateThumb();
virtual void updateThumbPosition();
virtual void updateThumbProportion();
void autoscrollTimerFired(Timer<Scrollbar>&);
void startTimerIfNeeded(double delay);
void stopTimerIfNeeded();
void autoscrollPressedPart(double delay);
ScrollDirection pressedPartScrollDirection();
ScrollGranularity pressedPartScrollGranularity();
ScrollableArea* m_scrollableArea;
ScrollbarOrientation m_orientation;
ScrollbarControlSize m_controlSize;
ScrollbarTheme* m_theme;
int m_visibleSize;
int m_totalSize;
float m_currentPos;
float m_dragOrigin;
int m_lineStep;
int m_pageStep;
float m_pixelStep;
ScrollbarPart m_hoveredPart;
ScrollbarPart m_pressedPart;
int m_pressedPos;
float m_scrollPos;
bool m_draggingDocument;
int m_documentDragPos;
bool m_enabled;
Timer<Scrollbar> m_scrollTimer;
bool m_overlapsResizer;
bool m_suppressInvalidation;
bool m_isAlphaLocked;
bool m_isCustomScrollbar;
private:
virtual bool isScrollbar() const override { return true; }
};
WIDGET_TYPE_CASTS(Scrollbar, isScrollbar());
} // namespace WebCore
#endif // Scrollbar_h
|
