1
<?xml version="1.0" encoding="iso-8859-1"?>
3
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
4
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5
<!-- /tmp/qt-4.0.0-espenr-1119621036935/qt-x11-opensource-desktop-4.0.0/src/gui/widgets/qabstractslider.cpp -->
7
<title>Qt 4.0: QAbstractSlider Class Reference</title>
8
<style>h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }
9
a:link { color: #004faf; text-decoration: none }
10
a:visited { color: #672967; text-decoration: none }
11
td.postheader { font-family: sans-serif }
12
tr.address { font-family: sans-serif }
13
body { background: #ffffff; color: black; }</style>
16
<table border="0" cellpadding="0" cellspacing="0" width="100%">
18
<td align="left" valign="top" width="32"><img src="images/qt-logo.png" align="left" width="32" height="32" border="0" /></td>
19
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="mainclasses.html"><font color="#004faf">Main Classes</font></a> · <a href="annotated.html"><font color="#004faf">Annotated</font></a> · <a href="groups.html"><font color="#004faf">Grouped Classes</font></a> · <a href="functions.html"><font color="#004faf">Functions</font></a></td>
20
<td align="right" valign="top" width="230"><img src="images/trolltech-logo.png" align="right" width="203" height="32" border="0" /></td></tr></table><h1 align="center">QAbstractSlider Class Reference</h1>
21
<p>The QAbstractSlider class provides an integer value within a range. <a href="#details">More...</a></p>
22
<pre>#include <QAbstractSlider></pre><p>Part of the <a href="qtgui.html">QtGui</a> module.</p>
23
<p>Inherits <a href="qwidget.html">QWidget</a>.</p>
24
<p>Inherited by <a href="qdial.html">QDial</a>, <a href="qscrollbar.html">QScrollBar</a>, and <a href="qslider.html">QSlider</a>.</p>
26
<li><a href="qabstractslider-members.html">List of all members, including inherited members</a></li>
27
<li><a href="qabstractslider-qt3.html">Qt 3 support members</a></li>
29
<a name="public-types"></a>
32
<li><div class="fn"/>enum <b><a href="qabstractslider.html#SliderAction-enum">SliderAction</a></b> { SliderNoAction, SliderSingleStepAdd, SliderSingleStepSub, SliderPageStepAdd, ..., SliderMove }</li>
34
<a name="properties"></a>
36
<table width="100%" border="0" cellpadding="0" cellspacing="0">
37
<tr><td width="45%" valign="top"><ul>
38
<li><div class="fn"/><b><a href="qabstractslider.html#invertedAppearance-prop">invertedAppearance</a></b> : bool</li>
39
<li><div class="fn"/><b><a href="qabstractslider.html#invertedControls-prop">invertedControls</a></b> : bool</li>
40
<li><div class="fn"/><b><a href="qabstractslider.html#maximum-prop">maximum</a></b> : int</li>
41
<li><div class="fn"/><b><a href="qabstractslider.html#minimum-prop">minimum</a></b> : int</li>
42
<li><div class="fn"/><b><a href="qabstractslider.html#orientation-prop">orientation</a></b> : Qt::Orientation</li>
43
<li><div class="fn"/><b><a href="qabstractslider.html#pageStep-prop">pageStep</a></b> : int</li>
44
</ul></td><td valign="top"><ul>
45
<li><div class="fn"/><b><a href="qabstractslider.html#singleStep-prop">singleStep</a></b> : int</li>
46
<li><div class="fn"/><b><a href="qabstractslider.html#sliderDown-prop">sliderDown</a></b> : bool</li>
47
<li><div class="fn"/><b><a href="qabstractslider.html#sliderPosition-prop">sliderPosition</a></b> : int</li>
48
<li><div class="fn"/><b><a href="qabstractslider.html#tracking-prop">tracking</a></b> : bool</li>
49
<li><div class="fn"/><b><a href="qabstractslider.html#value-prop">value</a></b> : int</li>
54
<li><div class="fn"/>52 properties inherited from <a href="qwidget.html#properties">QWidget</a></li>
55
<li><div class="fn"/>1 property inherited from <a href="qobject.html#properties">QObject</a></li>
57
<a name="public-functions"></a>
58
<h3>Public Functions</h3>
60
<li><div class="fn"/><b><a href="qabstractslider.html#QAbstractSlider">QAbstractSlider</a></b> ( QWidget * <i>parent</i> = 0 )</li>
61
<li><div class="fn"/><b><a href="qabstractslider.html#dtor.QAbstractSlider">~QAbstractSlider</a></b> ()</li>
62
<li><div class="fn"/>bool <b><a href="qabstractslider.html#tracking-prop">hasTracking</a></b> () const</li>
63
<li><div class="fn"/>bool <b><a href="qabstractslider.html#invertedAppearance-prop">invertedAppearance</a></b> () const</li>
64
<li><div class="fn"/>bool <b><a href="qabstractslider.html#invertedControls-prop">invertedControls</a></b> () const</li>
65
<li><div class="fn"/>bool <b><a href="qabstractslider.html#sliderDown-prop">isSliderDown</a></b> () const</li>
66
<li><div class="fn"/>int <b><a href="qabstractslider.html#maximum-prop">maximum</a></b> () const</li>
67
<li><div class="fn"/>int <b><a href="qabstractslider.html#minimum-prop">minimum</a></b> () const</li>
68
<li><div class="fn"/>Qt::Orientation <b><a href="qabstractslider.html#orientation-prop">orientation</a></b> () const</li>
69
<li><div class="fn"/>int <b><a href="qabstractslider.html#pageStep-prop">pageStep</a></b> () const</li>
70
<li><div class="fn"/>void <b><a href="qabstractslider.html#invertedAppearance-prop">setInvertedAppearance</a></b> ( bool )</li>
71
<li><div class="fn"/>void <b><a href="qabstractslider.html#invertedControls-prop">setInvertedControls</a></b> ( bool )</li>
72
<li><div class="fn"/>void <b><a href="qabstractslider.html#maximum-prop">setMaximum</a></b> ( int )</li>
73
<li><div class="fn"/>void <b><a href="qabstractslider.html#minimum-prop">setMinimum</a></b> ( int )</li>
74
<li><div class="fn"/>void <b><a href="qabstractslider.html#pageStep-prop">setPageStep</a></b> ( int )</li>
75
<li><div class="fn"/>void <b><a href="qabstractslider.html#setRange">setRange</a></b> ( int <i>min</i>, int <i>max</i> )</li>
76
<li><div class="fn"/>void <b><a href="qabstractslider.html#singleStep-prop">setSingleStep</a></b> ( int )</li>
77
<li><div class="fn"/>void <b><a href="qabstractslider.html#sliderDown-prop">setSliderDown</a></b> ( bool )</li>
78
<li><div class="fn"/>void <b><a href="qabstractslider.html#sliderPosition-prop">setSliderPosition</a></b> ( int )</li>
79
<li><div class="fn"/>void <b><a href="qabstractslider.html#tracking-prop">setTracking</a></b> ( bool <i>enable</i> )</li>
80
<li><div class="fn"/>int <b><a href="qabstractslider.html#singleStep-prop">singleStep</a></b> () const</li>
81
<li><div class="fn"/>int <b><a href="qabstractslider.html#sliderPosition-prop">sliderPosition</a></b> () const</li>
82
<li><div class="fn"/>void <b><a href="qabstractslider.html#triggerAction">triggerAction</a></b> ( SliderAction <i>action</i> )</li>
83
<li><div class="fn"/>int <b><a href="qabstractslider.html#value-prop">value</a></b> () const</li>
86
<li><div class="fn"/>183 public functions inherited from <a href="qwidget.html#public-functions">QWidget</a></li>
87
<li><div class="fn"/>28 public functions inherited from <a href="qobject.html#public-functions">QObject</a></li>
88
<li><div class="fn"/>10 public functions inherited from <a href="qpaintdevice.html#public-functions">QPaintDevice</a></li>
90
<a name="public-slots"></a>
93
<li><div class="fn"/>void <b><a href="qabstractslider.html#orientation-prop">setOrientation</a></b> ( Qt::Orientation )</li>
94
<li><div class="fn"/>void <b><a href="qabstractslider.html#value-prop">setValue</a></b> ( int )</li>
97
<li><div class="fn"/>17 public slots inherited from <a href="qwidget.html#public-slots">QWidget</a></li>
98
<li><div class="fn"/>1 public slot inherited from <a href="qobject.html#public-slots">QObject</a></li>
100
<a name="signals"></a>
103
<li><div class="fn"/>void <b><a href="qabstractslider.html#actionTriggered">actionTriggered</a></b> ( int <i>action</i> )</li>
104
<li><div class="fn"/>void <b><a href="qabstractslider.html#rangeChanged">rangeChanged</a></b> ( int <i>min</i>, int <i>max</i> )</li>
105
<li><div class="fn"/>void <b><a href="qabstractslider.html#sliderMoved">sliderMoved</a></b> ( int <i>value</i> )</li>
106
<li><div class="fn"/>void <b><a href="qabstractslider.html#sliderPressed">sliderPressed</a></b> ()</li>
107
<li><div class="fn"/>void <b><a href="qabstractslider.html#sliderReleased">sliderReleased</a></b> ()</li>
108
<li><div class="fn"/>void <b><a href="qabstractslider.html#valueChanged">valueChanged</a></b> ( int <i>value</i> )</li>
111
<li><div class="fn"/>1 signal inherited from <a href="qwidget.html#signals">QWidget</a></li>
112
<li><div class="fn"/>1 signal inherited from <a href="qobject.html#signals">QObject</a></li>
114
<a name="protected-types"></a>
115
<h3>Protected Types</h3>
117
<li><div class="fn"/>enum <b><a href="qabstractslider.html#SliderChange-enum">SliderChange</a></b> { SliderRangeChange, SliderOrientationChange, SliderStepsChange, SliderValueChange }</li>
119
<a name="protected-functions"></a>
120
<h3>Protected Functions</h3>
122
<li><div class="fn"/>SliderAction <b><a href="qabstractslider.html#repeatAction">repeatAction</a></b> () const</li>
123
<li><div class="fn"/>void <b><a href="qabstractslider.html#setRepeatAction">setRepeatAction</a></b> ( SliderAction <i>action</i>, int <i>thresholdTime</i> = 500, int <i>repeatTime</i> = 50 )</li>
124
<li><div class="fn"/>virtual void <b><a href="qabstractslider.html#sliderChange">sliderChange</a></b> ( SliderChange <i>change</i> )</li>
127
<li><div class="fn"/>39 protected functions inherited from <a href="qwidget.html#protected-functions">QWidget</a></li>
128
<li><div class="fn"/>7 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
130
<h3>Additional Inherited Members</h3>
132
<li><div class="fn"/>4 static public members inherited from <a href="qwidget.html#static-public-members">QWidget</a></li>
133
<li><div class="fn"/>4 static public members inherited from <a href="qobject.html#static-public-members">QObject</a></li>
135
<a name="details"></a>
137
<h2>Detailed Description</h2>
138
<p>The QAbstractSlider class provides an integer value within a range.</p>
139
<p>The class is designed as a common super class for widgets like <a href="qscrollbar.html">QScrollBar</a>, <a href="qslider.html">QSlider</a> and <a href="qdial.html">QDial</a>.</p>
140
<p>Here are the main properties of the class:</p>
142
<li><a href="qabstractslider.html#value-prop">value</a>: The bounded integer that QAbstractSlider maintains.</li>
143
<li><a href="qabstractslider.html#minimum-prop">minimum</a>: The lowest possible value.</li>
144
<li><a href="qabstractslider.html#maximum-prop">maximum</a>: The highest possible value.</li>
145
<li><a href="qabstractslider.html#singleStep-prop">singleStep</a>: The smaller of two natural steps that an abstract sliders provides and typically corresponds to the user pressing an arrow key.</li>
146
<li><a href="qabstractslider.html#pageStep-prop">pageStep</a>: The larger of two natural steps that an abstract slider provides and typically corresponds to the user pressing PageUp or PageDown.</li>
147
<li><a href="qabstractslider.html#tracking-prop">tracking</a>: Whether slider tracking is enabled.</li>
148
<li><a href="qabstractslider.html#sliderPosition-prop">sliderPosition</a>: The current position of the slider. If <a href="qabstractslider.html#tracking-prop">tracking</a> is enabled (the default), this is identical to <a href="qabstractslider.html#value-prop">value</a>.</li>
150
<p>Unity (1) may be viewed as a third step size. <a href="qabstractslider.html#value-prop">setValue</a>() lets you set the current value to any integer in the allowed range, not just <a href="qabstractslider.html#minimum-prop">minimum</a>() + <i>n</i> * <a href="qabstractslider.html#singleStep-prop">singleStep</a>() for integer values of <i>n</i>. Some widgets may allow the user to set any value at all; others may just provide multiples of <a href="qabstractslider.html#singleStep-prop">singleStep</a>() or <a href="qabstractslider.html#pageStep-prop">pageStep</a>().</p>
151
<p>QAbstractSlider emits a comprehensive set of signals:</p>
152
<table align="center" cellpadding="2" cellspacing="1" border="0">
153
<tr valign="top" bgcolor="#a2c511"><th>Signal</th><th>Emitted when</th></tr>
154
<tr valign="top" bgcolor="#f0f0f0"><td><a href="qabstractslider.html#valueChanged">valueChanged</a>()</td><td>the value has changed. The <a href="qabstractslider.html#tracking-prop">tracking</a> determines whether this signal is emitted during user interaction.</td></tr>
155
<tr valign="top" bgcolor="#e0e0e0"><td><a href="qabstractslider.html#sliderPressed">sliderPressed</a>()</td><td>the user starts to drag the slider.</td></tr>
156
<tr valign="top" bgcolor="#f0f0f0"><td><a href="qabstractslider.html#sliderMoved">sliderMoved</a>()</td><td>the user drags the slider.</td></tr>
157
<tr valign="top" bgcolor="#e0e0e0"><td><a href="qabstractslider.html#sliderReleased">sliderReleased</a>()</td><td>the user releases the slider.</td></tr>
158
<tr valign="top" bgcolor="#f0f0f0"><td><a href="qabstractslider.html#actionTriggered">actionTriggered</a>()</td><td>a slider action was triggerd.</td></tr>
159
<tr valign="top" bgcolor="#e0e0e0"><td><a href="qabstractslider.html#rangeChanged">rangeChanged</a>()</td><td>a the range has changed.</td></tr>
161
<p>QAbstractSlider provides a virtual <a href="qabstractslider.html#sliderChange">sliderChange</a>() function that is well suited for updating the on-screen representation of sliders. By calling <a href="qabstractslider.html#triggerAction">triggerAction</a>(), subclasses trigger slider actions. Two helper functions <a href="qstyle.html#sliderPositionFromValue">QStyle::sliderPositionFromValue</a>() and <a href="qstyle.html#sliderValueFromPosition">QStyle::sliderValueFromPosition</a>() help subclasses and styles to map screen coordinates to logical range values.</p>
163
<h2>Member Type Documentation</h2>
164
<h3 class="fn"><a name="SliderAction-enum"></a>enum QAbstractSlider::SliderAction</h3>
165
<table border="1" cellpadding="2" cellspacing="1" width="40%">
166
<tr><th width="60%">Constant</th><th width="40%">Value</th></tr>
167
<tr><td valign="top"><tt>QAbstractSlider::SliderNoAction</tt></td><td align="center" valign="top"><tt>0</tt></td></tr>
168
<tr><td valign="top"><tt>QAbstractSlider::SliderSingleStepAdd</tt></td><td align="center" valign="top"><tt>1</tt></td></tr>
169
<tr><td valign="top"><tt>QAbstractSlider::SliderSingleStepSub</tt></td><td align="center" valign="top"><tt>2</tt></td></tr>
170
<tr><td valign="top"><tt>QAbstractSlider::SliderPageStepAdd</tt></td><td align="center" valign="top"><tt>3</tt></td></tr>
171
<tr><td valign="top"><tt>QAbstractSlider::SliderPageStepSub</tt></td><td align="center" valign="top"><tt>4</tt></td></tr>
172
<tr><td valign="top"><tt>QAbstractSlider::SliderToMinimum</tt></td><td align="center" valign="top"><tt>5</tt></td></tr>
173
<tr><td valign="top"><tt>QAbstractSlider::SliderToMaximum</tt></td><td align="center" valign="top"><tt>6</tt></td></tr>
174
<tr><td valign="top"><tt>QAbstractSlider::SliderMove</tt></td><td align="center" valign="top"><tt>7</tt></td></tr>
176
<h3 class="fn"><a name="SliderChange-enum"></a>enum QAbstractSlider::SliderChange</h3>
177
<table border="1" cellpadding="2" cellspacing="1" width="40%">
178
<tr><th width="60%">Constant</th><th width="40%">Value</th></tr>
179
<tr><td valign="top"><tt>QAbstractSlider::SliderRangeChange</tt></td><td align="center" valign="top"><tt>0</tt></td></tr>
180
<tr><td valign="top"><tt>QAbstractSlider::SliderOrientationChange</tt></td><td align="center" valign="top"><tt>1</tt></td></tr>
181
<tr><td valign="top"><tt>QAbstractSlider::SliderStepsChange</tt></td><td align="center" valign="top"><tt>2</tt></td></tr>
182
<tr><td valign="top"><tt>QAbstractSlider::SliderValueChange</tt></td><td align="center" valign="top"><tt>3</tt></td></tr>
185
<h2>Property Documentation</h2>
186
<h3 class="fn"><a name="invertedAppearance-prop"></a>invertedAppearance : bool</h3>
187
<p>This property holds whether or not a slider shows its values inverted.</p>
188
<p>If this property is false (the default), the minimum and maximum will be shown in its classic position for the inherited widget. If the value is true, the minimum and maximum appear at their opposite location.</p>
189
<p>Access functions:</p>
191
<li><div class="fn"/><b>bool invertedAppearance () const</b></li>
192
<li><div class="fn"/><b>void setInvertedAppearance ( bool )</b></li>
194
<h3 class="fn"><a name="invertedControls-prop"></a>invertedControls : bool</h3>
195
<p>This property holds whether or not the slider inverts its wheel and key events.</p>
196
<p>If this property is false, scrolling the mouse wheel "up" and using keys like page up will increase the slider's value towards its maximum. Otherwise pressing page up will move value towards the slider's minimum.</p>
197
<p>Access functions:</p>
199
<li><div class="fn"/><b>bool invertedControls () const</b></li>
200
<li><div class="fn"/><b>void setInvertedControls ( bool )</b></li>
202
<h3 class="fn"><a name="maximum-prop"></a>maximum : int</h3>
203
<p>This property holds the slider's maximum value.</p>
204
<p>When setting this property, the <a href="qabstractslider.html#minimum-prop">minimum</a> is adjusted if necessary to ensure that the range remains valid. Also the slider's current value is adjusted to be within the new range.</p>
205
<p>Access functions:</p>
207
<li><div class="fn"/><b>int maximum () const</b></li>
208
<li><div class="fn"/><b>void setMaximum ( int )</b></li>
210
<h3 class="fn"><a name="minimum-prop"></a>minimum : int</h3>
211
<p>This property holds the sliders's minimum value.</p>
212
<p>When setting this property, the <a href="qabstractslider.html#maximum-prop">maximum</a> is adjusted if necessary to ensure that the range remains valid. Also the slider's current value is adjusted to be within the new range.</p>
213
<p>Access functions:</p>
215
<li><div class="fn"/><b>int minimum () const</b></li>
216
<li><div class="fn"/><b>void setMinimum ( int )</b></li>
218
<h3 class="fn"><a name="orientation-prop"></a>orientation : <a href="qt.html#Orientation-enum">Qt::Orientation</a></h3>
219
<p>This property holds the orientation of the slider.</p>
220
<p>The orientation must be <a href="qt.html#Orientation-enum">Qt::Vertical</a> (the default) or <a href="qt.html#Orientation-enum">Qt::Horizontal</a>.</p>
221
<p>Access functions:</p>
223
<li><div class="fn"/><b>Qt::Orientation orientation () const</b></li>
224
<li><div class="fn"/><b>void setOrientation ( Qt::Orientation )</b></li>
226
<h3 class="fn"><a name="pageStep-prop"></a>pageStep : int</h3>
227
<p>This property holds the page step.</p>
228
<p>The larger of two natural steps that an abstract slider provides and typically corresponds to the user pressing PageUp or PageDown.</p>
229
<p>Access functions:</p>
231
<li><div class="fn"/><b>int pageStep () const</b></li>
232
<li><div class="fn"/><b>void setPageStep ( int )</b></li>
234
<p>See also <a href="qabstractslider.html#singleStep-prop">singleStep</a>.</p>
235
<h3 class="fn"><a name="singleStep-prop"></a>singleStep : int</h3>
236
<p>This property holds the single step.</p>
237
<p>The smaller of two natural steps that an abstract sliders provides and typically corresponds to the user pressing an arrow key.</p>
238
<p>Access functions:</p>
240
<li><div class="fn"/><b>int singleStep () const</b></li>
241
<li><div class="fn"/><b>void setSingleStep ( int )</b></li>
243
<p>See also <a href="qabstractslider.html#pageStep-prop">pageStep</a>.</p>
244
<h3 class="fn"><a name="sliderDown-prop"></a>sliderDown : bool</h3>
245
<p>This property holds whether the slider is pressed down.</p>
246
<p>The property is set by subclasses in order to let the abstract slider know whether or not <a href="qabstractslider.html#tracking-prop">tracking</a> has any effect.</p>
247
<p>Changing the slider down property emits the <a href="qabstractslider.html#sliderPressed">sliderPressed</a>() and <a href="qabstractslider.html#sliderReleased">sliderReleased</a>() signals.</p>
248
<p>Access functions:</p>
250
<li><div class="fn"/><b>bool isSliderDown () const</b></li>
251
<li><div class="fn"/><b>void setSliderDown ( bool )</b></li>
253
<h3 class="fn"><a name="sliderPosition-prop"></a>sliderPosition : int</h3>
254
<p>This property holds the current slider position.</p>
255
<p>If <a href="qabstractslider.html#tracking-prop">tracking</a> is enabled (the default), this is identical to <a href="qabstractslider.html#value-prop">value</a>.</p>
256
<p>Access functions:</p>
258
<li><div class="fn"/><b>int sliderPosition () const</b></li>
259
<li><div class="fn"/><b>void setSliderPosition ( int )</b></li>
261
<h3 class="fn"><a name="tracking-prop"></a>tracking : bool</h3>
262
<p>This property holds whether slider tracking is enabled.</p>
263
<p>If tracking is enabled (the default), the slider emits the <a href="qabstractslider.html#valueChanged">valueChanged</a>() signal while the slider is being dragged. If tracking is disabled, the slider emits the <a href="qabstractslider.html#valueChanged">valueChanged</a>() signal only when the user releases the slider.</p>
264
<p>Access functions:</p>
266
<li><div class="fn"/><b>bool hasTracking () const</b></li>
267
<li><div class="fn"/><b>void setTracking ( bool <i>enable</i> )</b></li>
269
<p>See also <a href="qabstractslider.html#sliderDown-prop">sliderDown</a>.</p>
270
<h3 class="fn"><a name="value-prop"></a>value : int</h3>
271
<p>This property holds the slider's current value.</p>
272
<p>The slider forces the value to be within the legal range: <a href="qabstractslider.html#minimum-prop">minimum</a> <= <tt>value</tt> <= <a href="qabstractslider.html#maximum-prop">maximum</a>.</p>
273
<p>Changing the value also changes the <a href="qabstractslider.html#sliderPosition-prop">sliderPosition</a>.</p>
274
<p>Access functions:</p>
276
<li><div class="fn"/><b>int value () const</b></li>
277
<li><div class="fn"/><b>void setValue ( int )</b></li>
280
<h2>Member Function Documentation</h2>
281
<h3 class="fn"><a name="QAbstractSlider"></a>QAbstractSlider::QAbstractSlider ( <a href="qwidget.html">QWidget</a> * <i>parent</i> = 0 )</h3>
282
<p>Constructs an abstract slider.</p>
283
<p>The <i>parent</i> arguments is sent to the <a href="qwidget.html">QWidget</a> constructor.</p>
284
<p>The <a href="qabstractslider.html#minimum-prop">minimum</a> defaults to 0, the <a href="qabstractslider.html#maximum-prop">maximum</a> to 99, with a <a href="qabstractslider.html#singleStep-prop">singleStep</a> size of 1 and a <a href="qabstractslider.html#pageStep-prop">pageStep</a> size of 10, and an initial <a href="qabstractslider.html#value-prop">value</a> of 0.</p>
285
<h3 class="fn"><a name="dtor.QAbstractSlider"></a>QAbstractSlider::~QAbstractSlider ()</h3>
286
<p>Destroys the slider.</p>
287
<h3 class="fn"><a name="actionTriggered"></a>void QAbstractSlider::actionTriggered ( int <i>action</i> ) <tt> [signal]</tt></h3>
288
<p>This signal is emitted when the slider action <i>action</i> is triggered. Actions are <tt>SliderSingleStepAdd</tt>, <tt>SliderSingleStepSub</tt>, <tt>SliderPageStepAdd</tt>, <tt>SliderPageStepSub</tt>, <tt>SliderToMinimum</tt>, <tt>SliderToMaximum</tt>, and <tt>SliderMove</tt>.</p>
289
<p>When the signal is emitted, the <a href="qabstractslider.html#sliderPosition-prop">sliderPosition</a> has been adjusted according to the action, but the <a href="qabstractslider.html#value-prop">value</a> has not yet been propagated (meaning the <a href="qabstractslider.html#valueChanged">valueChanged</a>() signal was not yet emitted), and the visual display has not been updated. In slots connected to this signal you can thus safely adjust any action by calling <a href="qabstractslider.html#sliderPosition-prop">setSliderPosition</a>() yourself, based on both the action and the slider's value.</p>
290
<p>See also <a href="qabstractslider.html#triggerAction">triggerAction</a>().</p>
291
<h3 class="fn"><a name="rangeChanged"></a>void QAbstractSlider::rangeChanged ( int <i>min</i>, int <i>max</i> ) <tt> [signal]</tt></h3>
292
<p>This signal is emitted when the slider range has changed, with <i>min</i> being the new minimum, and <i>max</i> being the new maximum.</p>
293
<p>See also <a href="qabstractslider.html#minimum-prop">minimum</a> and <a href="qabstractslider.html#maximum-prop">maximum</a>.</p>
294
<h3 class="fn"><a name="repeatAction"></a><a href="qabstractslider.html#SliderAction-enum">SliderAction</a> QAbstractSlider::repeatAction () const <tt> [protected]</tt></h3>
295
<p>Returns the current repeat action.</p>
296
<p>See also <a href="qabstractslider.html#setRepeatAction">setRepeatAction</a>().</p>
297
<h3 class="fn"><a name="setRange"></a>void QAbstractSlider::setRange ( int <i>min</i>, int <i>max</i> )</h3>
298
<p>Sets the slider's minimum to <i>min</i> and its maximum to <i>max</i>.</p>
299
<p>If <i>max</i> is smaller than <i>min</i>, <i>min</i> becomes the only legal value.</p>
300
<p>See also <a href="qabstractslider.html#minimum-prop">minimum</a> and <a href="qabstractslider.html#maximum-prop">maximum</a>.</p>
301
<h3 class="fn"><a name="setRepeatAction"></a>void QAbstractSlider::setRepeatAction ( <a href="qabstractslider.html#SliderAction-enum">SliderAction</a> <i>action</i>, int <i>thresholdTime</i> = 500, int <i>repeatTime</i> = 50 ) <tt> [protected]</tt></h3>
302
<p>Sets action <i>action</i> to be triggered repetitively in intervals of <i>repeatTime</i>, after an initial delay of <i>thresholdTime</i>.</p>
303
<p>See also <a href="qabstractslider.html#triggerAction">triggerAction</a>() and <a href="qabstractslider.html#repeatAction">repeatAction</a>().</p>
304
<h3 class="fn"><a name="sliderChange"></a>void QAbstractSlider::sliderChange ( <a href="qabstractslider.html#SliderChange-enum">SliderChange</a> <i>change</i> ) <tt> [virtual protected]</tt></h3>
305
<p>Reimplement this virtual function to track slider changes such as <tt>SliderRangeChange</tt>, <tt>SliderOrientationChange</tt>, <tt>SliderStepsChange</tt>, or <tt>SliderValueChange</tt>. The default implementation only updates the display and ignores the <i>change</i> parameter.</p>
306
<h3 class="fn"><a name="sliderMoved"></a>void QAbstractSlider::sliderMoved ( int <i>value</i> ) <tt> [signal]</tt></h3>
307
<p>This signal is emitted when the slider is dragged by the user, with the new slider <i>value</i> as an argument.</p>
308
<p>This signal is emitted even when tracking is turned off.</p>
309
<p>See also <a href="qabstractslider.html#tracking-prop">setTracking</a>() and <a href="qabstractslider.html#valueChanged">valueChanged</a>().</p>
310
<h3 class="fn"><a name="sliderPressed"></a>void QAbstractSlider::sliderPressed () <tt> [signal]</tt></h3>
311
<p>This signal is emitted when the user presses the slider with the mouse.</p>
312
<h3 class="fn"><a name="sliderReleased"></a>void QAbstractSlider::sliderReleased () <tt> [signal]</tt></h3>
313
<p>This signal is emitted when the user releases the slider with the mouse.</p>
314
<h3 class="fn"><a name="triggerAction"></a>void QAbstractSlider::triggerAction ( <a href="qabstractslider.html#SliderAction-enum">SliderAction</a> <i>action</i> )</h3>
315
<p>Triggers a slider <i>action</i>. Possible actions are <tt>SliderSingleStepAdd</tt>, <tt>SliderSingleStepSub</tt>, <tt>SliderPageStepAdd</tt>, <tt>SliderPageStepSub</tt>, <tt>SliderToMinimum</tt>, <tt>SliderToMaximum</tt>, and <tt>SliderMove</tt>.</p>
316
<p>See also <a href="qabstractslider.html#actionTriggered">actionTriggered</a>().</p>
317
<h3 class="fn"><a name="valueChanged"></a>void QAbstractSlider::valueChanged ( int <i>value</i> ) <tt> [signal]</tt></h3>
318
<p>This signal is emitted when the slider value has changed, with the new slider <i>value</i> as argument.</p>
319
<p /><address><hr /><div align="center">
320
<table width="100%" cellspacing="0" border="0"><tr class="address">
321
<td width="30%">Copyright © 2005 <a href="trolltech.html">Trolltech</a></td>
322
<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>
323
<td width="30%" align="right"><div align="right">Qt 4.0.0</div></td>
324
</tr></table></div></address></body>
added
removed
doc/html/qabstractslider.html
