|
1 /**************************************************************************** |
|
2 ** |
|
3 ** Copyright (C) 2008-2010 Nokia Corporation and/or its subsidiary(-ies). |
|
4 ** All rights reserved. |
|
5 ** Contact: Nokia Corporation (developer.feedback@nokia.com) |
|
6 ** |
|
7 ** This file is part of the HbWidgets module of the UI Extensions for Mobile. |
|
8 ** |
|
9 ** GNU Lesser General Public License Usage |
|
10 ** This file may be used under the terms of the GNU Lesser General Public |
|
11 ** License version 2.1 as published by the Free Software Foundation and |
|
12 ** appearing in the file LICENSE.LGPL included in the packaging of this file. |
|
13 ** Please review the following information to ensure the GNU Lesser General |
|
14 ** Public License version 2.1 requirements will be met: |
|
15 ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. |
|
16 ** |
|
17 ** In addition, as a special exception, Nokia gives you certain additional |
|
18 ** rights. These rights are described in the Nokia Qt LGPL Exception |
|
19 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. |
|
20 ** |
|
21 ** If you have questions regarding the use of this file, please contact |
|
22 ** Nokia at developer.feedback@nokia.com. |
|
23 ** |
|
24 ****************************************************************************/ |
|
25 |
|
26 #ifndef HBSLIDER_H |
|
27 #define HBSLIDER_H |
|
28 |
|
29 #include <hbwidget.h> |
|
30 |
|
31 class HbSliderPrivate; |
|
32 |
|
33 class HB_WIDGETS_EXPORT HbSlider : public HbWidget |
|
34 { |
|
35 Q_OBJECT |
|
36 Q_PROPERTY(int maximum READ maximum WRITE setMaximum) |
|
37 Q_PROPERTY(int minimum READ minimum WRITE setMinimum) |
|
38 Q_PROPERTY(Qt::Orientation orientation READ orientation WRITE setOrientation) |
|
39 Q_PROPERTY(int pageStep READ pageStep WRITE setPageStep) |
|
40 Q_PROPERTY(int singleStep READ singleStep WRITE setSingleStep) |
|
41 Q_PROPERTY(int sliderPosition READ sliderPosition WRITE setSliderPosition) |
|
42 Q_PROPERTY(bool tracking READ hasTracking WRITE setTracking) |
|
43 Q_PROPERTY(int value READ value WRITE setValue USER true) |
|
44 Q_PROPERTY(Hb::SliderTickPositions tickPosition READ tickPosition WRITE setTickPosition) // does not work in armv5 |
|
45 Q_PROPERTY(int majorTickInterval READ majorTickInterval WRITE setMajorTickInterval) |
|
46 Q_PROPERTY(int minorTickInterval READ minorTickInterval WRITE setMinorTickInterval) |
|
47 Q_PROPERTY(QStringList majorTickLabels READ majorTickLabels WRITE setMajorTickLabels) |
|
48 Q_PROPERTY(QStringList minorTickLabels READ minorTickLabels WRITE setMinorTickLabels) |
|
49 Q_PROPERTY(SnappingMode snappingMode READ snappingMode WRITE setSnappingMode) |
|
50 Q_PROPERTY(bool iconCheckable READ isIconCheckable WRITE setIconCheckable) |
|
51 Q_PROPERTY(bool iconChecked READ isIconChecked WRITE setIconChecked) |
|
52 Q_PROPERTY(QString text READ text WRITE setText) |
|
53 Q_PROPERTY(bool invertedAppearance READ invertedAppearance WRITE setInvertedAppearance) |
|
54 Q_PROPERTY(bool toolTipVisible READ isToolTipVisible WRITE setToolTipVisible) |
|
55 Q_PROPERTY(Qt::Alignment toolTipAlignment READ toolTipAlignment WRITE setToolTipAlignment) |
|
56 Q_PROPERTY(bool iconEnabled READ isIconEnabled WRITE setIconEnabled) |
|
57 Q_PROPERTY(QString handleIcon READ handleIcon WRITE setHandleIcon) |
|
58 Q_PROPERTY(bool trackFilled READ isTrackFilled WRITE setTrackFilled) |
|
59 Q_PROPERTY(QList<QVariant> sliderElements READ sliderElements WRITE setSliderElements) |
|
60 Q_PROPERTY(QMap elementIcons READ elementIcons WRITE setElementIcons) |
|
61 |
|
62 Q_ENUMS(SliderElement SnappingMode) |
|
63 |
|
64 public: |
|
65 explicit HbSlider(QGraphicsItem *parent = 0); |
|
66 explicit HbSlider(Qt::Orientation orientation, QGraphicsItem *parent = 0); |
|
67 virtual ~HbSlider(); |
|
68 |
|
69 enum SliderElement { |
|
70 IncreaseElement, |
|
71 TrackElement, |
|
72 DecreaseElement, |
|
73 IconElement, |
|
74 TextElement |
|
75 }; |
|
76 |
|
77 enum SnappingMode { |
|
78 NoSnapping, |
|
79 MajorTickSnapping, |
|
80 MinorTickSnapping |
|
81 }; |
|
82 |
|
83 void setMaximum(int max); |
|
84 int maximum() const; |
|
85 |
|
86 void setMinimum(int min); |
|
87 int minimum() const; |
|
88 |
|
89 Qt::Orientation orientation() const; |
|
90 |
|
91 void setPageStep(int step); |
|
92 int pageStep() const; |
|
93 |
|
94 void setSingleStep(int step); |
|
95 int singleStep() const; |
|
96 |
|
97 void setSliderPosition(int pos); |
|
98 int sliderPosition() const; |
|
99 |
|
100 void setTracking(bool enable); |
|
101 bool hasTracking() const; |
|
102 |
|
103 int value() const; |
|
104 |
|
105 void setMajorTickInterval(int interval); |
|
106 int majorTickInterval() const; |
|
107 |
|
108 void setMinorTickInterval(int interval); |
|
109 int minorTickInterval() const; |
|
110 |
|
111 void setMajorTickLabels(const QStringList &majorTickLabels); |
|
112 QStringList majorTickLabels() const; |
|
113 |
|
114 void setMinorTickLabels(const QStringList &minorTickLabels); |
|
115 QStringList minorTickLabels() const; |
|
116 |
|
117 void setSnappingMode(SnappingMode mode); |
|
118 SnappingMode snappingMode() const; |
|
119 |
|
120 void setIconCheckable(bool checkable); |
|
121 bool isIconCheckable() const; |
|
122 |
|
123 void setIconChecked(bool checked); |
|
124 bool isIconChecked() const; |
|
125 |
|
126 QString text() const; |
|
127 |
|
128 void setInvertedAppearance(bool inverted); |
|
129 bool invertedAppearance() const; |
|
130 |
|
131 virtual void setToolTipVisible(bool); |
|
132 bool isToolTipVisible() const; |
|
133 |
|
134 Qt::Alignment toolTipAlignment() const; |
|
135 void setToolTipAlignment(Qt::Alignment); |
|
136 |
|
137 void setRange(int min, int max); |
|
138 |
|
139 void setTickPosition(Hb::SliderTickPositions position); |
|
140 Hb::SliderTickPositions tickPosition() const; |
|
141 |
|
142 void setElements(const QList<SliderElement> &elements); |
|
143 QList<SliderElement> elements() const; |
|
144 |
|
145 void setIcon(SliderElement element, const HbIcon &icon); |
|
146 HbIcon icon(SliderElement element) const; |
|
147 |
|
148 void setElementIcon(SliderElement element, const HbIcon &icon); |
|
149 HbIcon elementIcon(SliderElement element) const; |
|
150 |
|
151 void setElementIcons(const QMap<QString,QVariant> &elements); |
|
152 QMap<QString,QVariant> elementIcons( )const; |
|
153 |
|
154 void setSliderElements(const QList<QVariant> &elements); |
|
155 QList<QVariant> sliderElements() const; |
|
156 |
|
157 |
|
158 bool isIconEnabled() const; |
|
159 void setIconEnabled(bool enabled); |
|
160 |
|
161 enum { Type = Hb::ItemType_Slider }; |
|
162 int type() const { return Type; } |
|
163 |
|
164 void setHandleIcon(const QString& handlePath ); |
|
165 QString handleIcon() const; |
|
166 |
|
167 void setTrackFilled(bool trackVisible = true ); |
|
168 bool isTrackFilled() const; |
|
169 |
|
170 virtual QGraphicsItem * primitive(HbStyle::Primitive primitive) const; |
|
171 |
|
172 public slots: |
|
173 void setOrientation(Qt::Orientation orientation); |
|
174 void setValue(int value); |
|
175 void setText(const QString &text); |
|
176 void updatePrimitives(); |
|
177 |
|
178 signals: |
|
179 void valueChanged(int value); |
|
180 void sliderPressed(); |
|
181 void sliderReleased(); |
|
182 void sliderMoved(int value); |
|
183 void rangeChanged(int min, int max); |
|
184 |
|
185 void iconPressed(); |
|
186 void iconReleased(); |
|
187 void iconClicked(); |
|
188 void iconToggled(bool checked); |
|
189 void textClicked(); |
|
190 |
|
191 protected: |
|
192 HbSlider(HbSliderPrivate &dd, QGraphicsItem *parent); |
|
193 virtual void mousePressEvent(QGraphicsSceneMouseEvent *event); |
|
194 virtual void mouseReleaseEvent(QGraphicsSceneMouseEvent *event); |
|
195 virtual QVariant itemChange(GraphicsItemChange change, const QVariant &value); |
|
196 virtual void focusInEvent(QFocusEvent *event); |
|
197 |
|
198 |
|
199 |
|
200 private: |
|
201 Q_DECLARE_PRIVATE_D(d_ptr, HbSlider) |
|
202 Q_DISABLE_COPY(HbSlider) |
|
203 #ifdef HB_EFFECTS |
|
204 Q_PRIVATE_SLOT(d_func(), void _q_startIconPressedEffect()) |
|
205 Q_PRIVATE_SLOT(d_func(), void _q_startIconReleasedEffect()) |
|
206 Q_PRIVATE_SLOT(d_func(), void _q_startTextClickEffect()) |
|
207 #endif |
|
208 }; |
|
209 |
|
210 #endif // HBSLIDER_H |