1 /****************************************************************************
2 **
3 ** Copyright (C) 2016 The Qt Company Ltd.
4 ** Contact: https://www.qt.io/licensing/
5 **
6 ** This file is part of the QtWidgets module of the Qt Toolkit.
7 **
8 ** $QT_BEGIN_LICENSE:LGPL$
9 ** Commercial License Usage
10 ** Licensees holding valid commercial Qt licenses may use this file in
11 ** accordance with the commercial license agreement provided with the
12 ** Software or, alternatively, in accordance with the terms contained in
13 ** a written agreement between you and The Qt Company. For licensing terms
14 ** and conditions see https://www.qt.io/terms-conditions. For further
15 ** information use the contact form at https://www.qt.io/contact-us.
16 **
17 ** GNU Lesser General Public License Usage
18 ** Alternatively, this file may be used under the terms of the GNU Lesser
19 ** General Public License version 3 as published by the Free Software
20 ** Foundation and appearing in the file LICENSE.LGPL3 included in the
21 ** packaging of this file. Please review the following information to
22 ** ensure the GNU Lesser General Public License version 3 requirements
23 ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
24 **
25 ** GNU General Public License Usage
26 ** Alternatively, this file may be used under the terms of the GNU
27 ** General Public License version 2.0 or (at your option) the GNU General
28 ** Public license version 3 or any later version approved by the KDE Free
29 ** Qt Foundation. The licenses are as published by the Free Software
30 ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
31 ** included in the packaging of this file. Please review the following
32 ** information to ensure the GNU General Public License requirements will
33 ** be met: https://www.gnu.org/licenses/gpl-2.0.html and
34 ** https://www.gnu.org/licenses/gpl-3.0.html.
35 **
36 ** $QT_END_LICENSE$
37 **
38 ****************************************************************************/
39 
40 #ifndef QABSTRACTSLIDER_P_H
41 #define QABSTRACTSLIDER_P_H
42 
43 //
44 //  W A R N I N G
45 //  -------------
46 //
47 // This file is not part of the Qt API.  It exists purely as an
48 // implementation detail.  This header file may change from version to
49 // version without notice, or even be removed.
50 //
51 // We mean it.
52 //
53 
54 #include <QtWidgets/private/qtwidgetsglobal_p.h>
55 #include "QtCore/qbasictimer.h"
56 #include "QtCore/qelapsedtimer.h"
57 #include "private/qwidget_p.h"
58 #include "qstyle.h"
59 
60 QT_REQUIRE_CONFIG(abstractslider);
61 
62 QT_BEGIN_NAMESPACE
63 
64 class QAbstractSliderPrivate : public QWidgetPrivate
65 {
66     Q_DECLARE_PUBLIC(QAbstractSlider)
67 public:
68     QAbstractSliderPrivate();
69     ~QAbstractSliderPrivate();
70 
71     void setSteps(int single, int page);
72 
73     int minimum, maximum, pageStep, value, position, pressValue;
74 
75     /**
76      * Call effectiveSingleStep() when changing the slider value.
77      */
78     int singleStep;
79     int singleStepFromItemView; // If we have itemViews we track the views preferred singleStep value.
80     bool viewMayChangeSingleStep;
81 
82     float offset_accumulated;
83     uint tracking : 1;
84     uint blocktracking :1;
85     uint pressed : 1;
86     uint invertedAppearance : 1;
87     uint invertedControls : 1;
88     Qt::Orientation orientation;
89 
90     QBasicTimer repeatActionTimer;
91     int repeatActionTime;
92     QAbstractSlider::SliderAction repeatAction;
93 
94 #ifdef QT_KEYPAD_NAVIGATION
95     int origValue;
96 
97     /**
98      */
99     bool isAutoRepeating;
100 
101     /**
102      * When we're auto repeating, we multiply singleStep with this value to
103      * get our effective step.
104      */
105     qreal repeatMultiplier;
106 
107     /**
108      * The time of when the first auto repeating key press event occurs.
109      */
110     QElapsedTimer firstRepeat;
111 
112 #endif
113 
effectiveSingleStep()114     inline int effectiveSingleStep() const
115     {
116         return singleStep
117 #ifdef QT_KEYPAD_NAVIGATION
118         * repeatMultiplier
119 #endif
120         ;
121     }
122     void itemviewChangeSingleStep(int step);
123 
bound(int val)124     virtual int bound(int val) const { return qMax(minimum, qMin(maximum, val)); }
overflowSafeAdd(int add)125     inline int overflowSafeAdd(int add) const
126     {
127         int newValue = value + add;
128         if (add > 0 && newValue < value)
129             newValue = maximum;
130         else if (add < 0 && newValue > value)
131             newValue = minimum;
132         return newValue;
133     }
setAdjustedSliderPosition(int position)134     inline void setAdjustedSliderPosition(int position)
135     {
136         Q_Q(QAbstractSlider);
137         if (q->style()->styleHint(QStyle::SH_Slider_StopMouseOverSlider, nullptr, q)) {
138             if ((position > pressValue - 2 * pageStep) && (position < pressValue + 2 * pageStep)) {
139                 repeatAction = QAbstractSlider::SliderNoAction;
140                 q->setSliderPosition(pressValue);
141                 return;
142             }
143         }
144         q->triggerAction(repeatAction);
145     }
146     bool scrollByDelta(Qt::Orientation orientation, Qt::KeyboardModifiers modifiers, int delta);
147 };
148 
149 QT_END_NAMESPACE
150 
151 #endif // QABSTRACTSLIDER_P_H
152