[190] | 1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
---|
| 2 | <!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/widgets/qslider.cpp:61 -->
|
---|
| 3 | <html>
|
---|
| 4 | <head>
|
---|
| 5 | <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
---|
| 6 | <title>QSlider Class</title>
|
---|
| 7 | <style type="text/css"><!--
|
---|
| 8 | fn { margin-left: 1cm; text-indent: -1cm; }
|
---|
| 9 | a:link { color: #004faf; text-decoration: none }
|
---|
| 10 | a:visited { color: #672967; text-decoration: none }
|
---|
| 11 | body { background: #ffffff; color: black; }
|
---|
| 12 | --></style>
|
---|
| 13 | </head>
|
---|
| 14 | <body>
|
---|
| 15 |
|
---|
| 16 | <table border="0" cellpadding="0" cellspacing="0" width="100%">
|
---|
| 17 | <tr bgcolor="#E5E5E5">
|
---|
| 18 | <td valign=center>
|
---|
| 19 | <a href="index.html">
|
---|
| 20 | <font color="#004faf">Home</font></a>
|
---|
| 21 | | <a href="classes.html">
|
---|
| 22 | <font color="#004faf">All Classes</font></a>
|
---|
| 23 | | <a href="mainclasses.html">
|
---|
| 24 | <font color="#004faf">Main Classes</font></a>
|
---|
| 25 | | <a href="annotated.html">
|
---|
| 26 | <font color="#004faf">Annotated</font></a>
|
---|
| 27 | | <a href="groups.html">
|
---|
| 28 | <font color="#004faf">Grouped Classes</font></a>
|
---|
| 29 | | <a href="functions.html">
|
---|
| 30 | <font color="#004faf">Functions</font></a>
|
---|
| 31 | </td>
|
---|
| 32 | <td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>QSlider Class Reference</h1>
|
---|
| 33 |
|
---|
| 34 | <p>The QSlider widget provides a vertical or horizontal slider.
|
---|
| 35 | <a href="#details">More...</a>
|
---|
| 36 | <p><tt>#include <<a href="qslider-h.html">qslider.h</a>></tt>
|
---|
| 37 | <p>Inherits <a href="qwidget.html">QWidget</a> and <a href="qrangecontrol.html">QRangeControl</a>.
|
---|
| 38 | <p><a href="qslider-members.html">List of all member functions.</a>
|
---|
| 39 | <h2>Public Members</h2>
|
---|
| 40 | <ul>
|
---|
| 41 | <li class=fn>enum <a href="#TickSetting-enum"><b>TickSetting</b></a> { NoMarks = 0, Above = 1, Left = Above, Below = 2, Right = Below, Both = 3 }</li>
|
---|
| 42 | <li class=fn><a href="#QSlider"><b>QSlider</b></a> ( QWidget * parent, const char * name = 0 )</li>
|
---|
| 43 | <li class=fn><a href="#QSlider-2"><b>QSlider</b></a> ( Orientation orientation, QWidget * parent, const char * name = 0 )</li>
|
---|
| 44 | <li class=fn><a href="#QSlider-3"><b>QSlider</b></a> ( int minValue, int maxValue, int pageStep, int value, Orientation orientation, QWidget * parent, const char * name = 0 )</li>
|
---|
| 45 | <li class=fn><a href="#~QSlider"><b>~QSlider</b></a> ()</li>
|
---|
| 46 | <li class=fn>virtual void <a href="#setOrientation"><b>setOrientation</b></a> ( Orientation )</li>
|
---|
| 47 | <li class=fn>Orientation <a href="#orientation"><b>orientation</b></a> () const</li>
|
---|
| 48 | <li class=fn>virtual void <a href="#setTracking"><b>setTracking</b></a> ( bool enable )</li>
|
---|
| 49 | <li class=fn>bool <a href="#tracking"><b>tracking</b></a> () const</li>
|
---|
| 50 | <li class=fn>virtual void <a href="#setPalette"><b>setPalette</b></a> ( const QPalette & p )</li>
|
---|
| 51 | <li class=fn>int <a href="#sliderStart"><b>sliderStart</b></a> () const</li>
|
---|
| 52 | <li class=fn>QRect <a href="#sliderRect"><b>sliderRect</b></a> () const</li>
|
---|
| 53 | <li class=fn>virtual void <a href="#setTickmarks"><b>setTickmarks</b></a> ( TickSetting )</li>
|
---|
| 54 | <li class=fn>TickSetting <a href="#tickmarks"><b>tickmarks</b></a> () const</li>
|
---|
| 55 | <li class=fn>virtual void <a href="#setTickInterval"><b>setTickInterval</b></a> ( int )</li>
|
---|
| 56 | <li class=fn>int <a href="#tickInterval"><b>tickInterval</b></a> () const</li>
|
---|
| 57 | <li class=fn>int <a href="#minValue"><b>minValue</b></a> () const</li>
|
---|
| 58 | <li class=fn>int <a href="#maxValue"><b>maxValue</b></a> () const</li>
|
---|
| 59 | <li class=fn>void <a href="#setMinValue"><b>setMinValue</b></a> ( int )</li>
|
---|
| 60 | <li class=fn>void <a href="#setMaxValue"><b>setMaxValue</b></a> ( int )</li>
|
---|
| 61 | <li class=fn>int <a href="#lineStep"><b>lineStep</b></a> () const</li>
|
---|
| 62 | <li class=fn>int <a href="#pageStep"><b>pageStep</b></a> () const</li>
|
---|
| 63 | <li class=fn>void <a href="#setLineStep"><b>setLineStep</b></a> ( int )</li>
|
---|
| 64 | <li class=fn>void <a href="#setPageStep"><b>setPageStep</b></a> ( int )</li>
|
---|
| 65 | <li class=fn>int <a href="#value"><b>value</b></a> () const</li>
|
---|
| 66 | </ul>
|
---|
| 67 | <h2>Public Slots</h2>
|
---|
| 68 | <ul>
|
---|
| 69 | <li class=fn>virtual void <a href="#setValue"><b>setValue</b></a> ( int )</li>
|
---|
| 70 | <li class=fn>void <a href="#addStep"><b>addStep</b></a> ()</li>
|
---|
| 71 | <li class=fn>void <a href="#subtractStep"><b>subtractStep</b></a> ()</li>
|
---|
| 72 | </ul>
|
---|
| 73 | <h2>Signals</h2>
|
---|
| 74 | <ul>
|
---|
| 75 | <li class=fn>void <a href="#valueChanged"><b>valueChanged</b></a> ( int value )</li>
|
---|
| 76 | <li class=fn>void <a href="#sliderPressed"><b>sliderPressed</b></a> ()</li>
|
---|
| 77 | <li class=fn>void <a href="#sliderMoved"><b>sliderMoved</b></a> ( int value )</li>
|
---|
| 78 | <li class=fn>void <a href="#sliderReleased"><b>sliderReleased</b></a> ()</li>
|
---|
| 79 | </ul>
|
---|
| 80 | <h2>Important Inherited Members</h2>
|
---|
| 81 | <ul>
|
---|
| 82 | <li class=fn>void <a href="#setRange"><b>setRange</b></a> ( int minValue, int maxValue )</li>
|
---|
| 83 | </ul>
|
---|
| 84 | <h2>Properties</h2>
|
---|
| 85 | <ul>
|
---|
| 86 | <li class=fn>int <a href="#lineStep-prop"><b>lineStep</b></a> - the current line step</li>
|
---|
| 87 | <li class=fn>int <a href="#maxValue-prop"><b>maxValue</b></a> - the current maximum value of the slider</li>
|
---|
| 88 | <li class=fn>int <a href="#minValue-prop"><b>minValue</b></a> - the current minimum value of the slider</li>
|
---|
| 89 | <li class=fn>Orientation <a href="#orientation-prop"><b>orientation</b></a> - the slider's orientation</li>
|
---|
| 90 | <li class=fn>int <a href="#pageStep-prop"><b>pageStep</b></a> - the current page step</li>
|
---|
| 91 | <li class=fn>int <a href="#tickInterval-prop"><b>tickInterval</b></a> - the interval between tickmarks</li>
|
---|
| 92 | <li class=fn>TickSetting <a href="#tickmarks-prop"><b>tickmarks</b></a> - the tickmark settings for this slider</li>
|
---|
| 93 | <li class=fn>bool <a href="#tracking-prop"><b>tracking</b></a> - whether slider tracking is enabled</li>
|
---|
| 94 | <li class=fn>int <a href="#value-prop"><b>value</b></a> - the current slider value</li>
|
---|
| 95 | </ul>
|
---|
| 96 | <h2>Protected Members</h2>
|
---|
| 97 | <ul>
|
---|
| 98 | <li class=fn>virtual void <a href="#valueChange"><b>valueChange</b></a> ()</li>
|
---|
| 99 | <li class=fn>virtual void <a href="#rangeChange"><b>rangeChange</b></a> ()</li>
|
---|
| 100 | </ul>
|
---|
| 101 | <hr><a name="details"></a><h2>Detailed Description</h2>
|
---|
| 102 |
|
---|
| 103 |
|
---|
| 104 | The QSlider widget provides a vertical or horizontal slider.
|
---|
| 105 | <p>
|
---|
| 106 |
|
---|
| 107 | <p> The slider is the classic widget for controlling a bounded value.
|
---|
| 108 | It lets the user move a slider along a horizontal or vertical
|
---|
| 109 | groove and translates the slider's position into an integer value
|
---|
| 110 | within the legal range.
|
---|
| 111 | <p> QSlider inherits <a href="qrangecontrol.html">QRangeControl</a>, which provides the "integer" side
|
---|
| 112 | of the slider. <a href="qrangecontrol.html#setRange">setRange</a>() and <a href="#value">value</a>() are likely to be used by
|
---|
| 113 | practically all slider users; see the <a href="qrangecontrol.html">QRangeControl</a>
|
---|
| 114 | documentation for information about the many other functions that
|
---|
| 115 | class provides.
|
---|
| 116 | <p> The main functions offered by the slider itself are tickmark and
|
---|
| 117 | orientation control; you can use <a href="#setTickmarks">setTickmarks</a>() to indicate where
|
---|
| 118 | you want the tickmarks to be, <a href="#setTickInterval">setTickInterval</a>() to indicate how
|
---|
| 119 | many of them you want and <a href="#setOrientation">setOrientation</a>() to indicate whether the
|
---|
| 120 | slider is to be horizontal or vertical.
|
---|
| 121 | <p> A slider accepts focus on Tab and uses the mouse wheel and a
|
---|
| 122 | suitable keyboard interface.
|
---|
| 123 | <p> <img src=qslider-m.png> <img src=qslider-w.png>
|
---|
| 124 | <p>
|
---|
| 125 | <p> <p>See also <a href="qscrollbar.html">QScrollBar</a>, <a href="qspinbox.html">QSpinBox</a>, <a href="guibooks.html#fowler">GUI Design Handbook: Slider</a>, and <a href="basic.html">Basic Widgets</a>.
|
---|
| 126 |
|
---|
| 127 | <hr><h2>Member Type Documentation</h2>
|
---|
| 128 | <h3 class=fn><a name="TickSetting-enum"></a>QSlider::TickSetting</h3>
|
---|
| 129 |
|
---|
| 130 | <p> This enum specifies where the tickmarks are to be drawn relative
|
---|
| 131 | to the slider's groove and the handle the user moves.
|
---|
| 132 | <ul>
|
---|
| 133 | <li><tt>QSlider::NoMarks</tt> - do not draw any tickmarks.
|
---|
| 134 | <li><tt>QSlider::Both</tt> - draw tickmarks on both sides of the groove.
|
---|
| 135 | <li><tt>QSlider::Above</tt> - draw tickmarks above the (horizontal) slider
|
---|
| 136 | <li><tt>QSlider::Below</tt> - draw tickmarks below the (horizontal) slider
|
---|
| 137 | <li><tt>QSlider::Left</tt> - draw tickmarks to the left of the (vertical) slider
|
---|
| 138 | <li><tt>QSlider::Right</tt> - draw tickmarks to the right of the (vertical) slider
|
---|
| 139 | </ul>
|
---|
| 140 | <hr><h2>Member Function Documentation</h2>
|
---|
| 141 | <h3 class=fn><a name="QSlider"></a>QSlider::QSlider ( <a href="qwidget.html">QWidget</a> * parent, const char * name = 0 )
|
---|
| 142 | </h3>
|
---|
| 143 | Constructs a vertical slider.
|
---|
| 144 | <p> The <em>parent</em> and <em>name</em> arguments are sent on to the <a href="qwidget.html">QWidget</a>
|
---|
| 145 | constructor.
|
---|
| 146 |
|
---|
| 147 | <h3 class=fn><a name="QSlider-2"></a>QSlider::QSlider ( <a href="qt.html#Orientation-enum">Orientation</a> orientation, <a href="qwidget.html">QWidget</a> * parent, const char * name = 0 )
|
---|
| 148 | </h3>
|
---|
| 149 | Constructs a slider.
|
---|
| 150 | <p> The <em>orientation</em> must be <a href="qt.html#Orientation-enum">Qt::Vertical</a> or <a href="qt.html#Orientation-enum">Qt::Horizontal</a>.
|
---|
| 151 | <p> The <em>parent</em> and <em>name</em> arguments are sent on to the <a href="qwidget.html">QWidget</a>
|
---|
| 152 | constructor.
|
---|
| 153 |
|
---|
| 154 | <h3 class=fn><a name="QSlider-3"></a>QSlider::QSlider ( int minValue, int maxValue, int pageStep, int value, <a href="qt.html#Orientation-enum">Orientation</a> orientation, <a href="qwidget.html">QWidget</a> * parent, const char * name = 0 )
|
---|
| 155 | </h3>
|
---|
| 156 | Constructs a slider whose value can never be smaller than <em>minValue</em> or greater than <em>maxValue</em>, whose page step size is <em>pageStep</em> and whose value is initially <em>value</em> (which is
|
---|
| 157 | guaranteed to be in range using <a href="qrangecontrol.html#bound">bound</a>()).
|
---|
| 158 | <p> If <em>orientation</em> is <a href="qt.html#Orientation-enum">Qt::Vertical</a> the slider is vertical and if it
|
---|
| 159 | is <a href="qt.html#Orientation-enum">Qt::Horizontal</a> the slider is horizontal.
|
---|
| 160 | <p> The <em>parent</em> and <em>name</em> arguments are sent on to the <a href="qwidget.html">QWidget</a>
|
---|
| 161 | constructor.
|
---|
| 162 |
|
---|
| 163 | <h3 class=fn><a name="~QSlider"></a>QSlider::~QSlider ()
|
---|
| 164 | </h3>
|
---|
| 165 | Destructor.
|
---|
| 166 |
|
---|
| 167 | <h3 class=fn>void <a name="addStep"></a>QSlider::addStep ()<tt> [slot]</tt>
|
---|
| 168 | </h3>
|
---|
| 169 | Moves the slider one <a href="#pageStep">pageStep</a>() up or right.
|
---|
| 170 |
|
---|
| 171 | <h3 class=fn>int <a name="lineStep"></a>QSlider::lineStep () const
|
---|
| 172 | </h3><p>Returns the current line step.
|
---|
| 173 | See the <a href="qslider.html#lineStep-prop">"lineStep"</a> property for details.
|
---|
| 174 | <h3 class=fn>int <a name="maxValue"></a>QSlider::maxValue () const
|
---|
| 175 | </h3><p>Returns the current maximum value of the slider.
|
---|
| 176 | See the <a href="qslider.html#maxValue-prop">"maxValue"</a> property for details.
|
---|
| 177 | <h3 class=fn>int <a name="minValue"></a>QSlider::minValue () const
|
---|
| 178 | </h3><p>Returns the current minimum value of the slider.
|
---|
| 179 | See the <a href="qslider.html#minValue-prop">"minValue"</a> property for details.
|
---|
| 180 | <h3 class=fn><a href="qt.html#Orientation-enum">Orientation</a> <a name="orientation"></a>QSlider::orientation () const
|
---|
| 181 | </h3><p>Returns the slider's orientation.
|
---|
| 182 | See the <a href="qslider.html#orientation-prop">"orientation"</a> property for details.
|
---|
| 183 | <h3 class=fn>int <a name="pageStep"></a>QSlider::pageStep () const
|
---|
| 184 | </h3><p>Returns the current page step.
|
---|
| 185 | See the <a href="qslider.html#pageStep-prop">"pageStep"</a> property for details.
|
---|
| 186 | <h3 class=fn>void <a name="rangeChange"></a>QSlider::rangeChange ()<tt> [virtual protected]</tt>
|
---|
| 187 | </h3>
|
---|
| 188 | Implements the virtual <a href="qrangecontrol.html">QRangeControl</a> function.
|
---|
| 189 |
|
---|
| 190 | <p>Reimplemented from <a href="qrangecontrol.html#rangeChange">QRangeControl</a>.
|
---|
| 191 | <h3 class=fn>void <a name="setLineStep"></a>QSlider::setLineStep ( int )
|
---|
| 192 | </h3><p>Sets the current line step.
|
---|
| 193 | See the <a href="qslider.html#lineStep-prop">"lineStep"</a> property for details.
|
---|
| 194 | <h3 class=fn>void <a name="setMaxValue"></a>QSlider::setMaxValue ( int )
|
---|
| 195 | </h3><p>Sets the current maximum value of the slider.
|
---|
| 196 | See the <a href="qslider.html#maxValue-prop">"maxValue"</a> property for details.
|
---|
| 197 | <h3 class=fn>void <a name="setMinValue"></a>QSlider::setMinValue ( int )
|
---|
| 198 | </h3><p>Sets the current minimum value of the slider.
|
---|
| 199 | See the <a href="qslider.html#minValue-prop">"minValue"</a> property for details.
|
---|
| 200 | <h3 class=fn>void <a name="setOrientation"></a>QSlider::setOrientation ( <a href="qt.html#Orientation-enum">Orientation</a> )<tt> [virtual]</tt>
|
---|
| 201 | </h3><p>Sets the slider's orientation.
|
---|
| 202 | See the <a href="qslider.html#orientation-prop">"orientation"</a> property for details.
|
---|
| 203 | <h3 class=fn>void <a name="setPageStep"></a>QSlider::setPageStep ( int )
|
---|
| 204 | </h3><p>Sets the current page step.
|
---|
| 205 | See the <a href="qslider.html#pageStep-prop">"pageStep"</a> property for details.
|
---|
| 206 | <h3 class=fn>void <a name="setPalette"></a>QSlider::setPalette ( const <a href="qpalette.html">QPalette</a> & p )<tt> [virtual]</tt>
|
---|
| 207 | </h3>
|
---|
| 208 | Reimplements the virtual function <a href="qwidget.html#setPalette">QWidget::setPalette</a>().
|
---|
| 209 | <p> Sets the background color to the mid color for <a href="motif-extension.html#Motif">Motif</a> style sliders
|
---|
| 210 | using palette <em>p</em>.
|
---|
| 211 |
|
---|
| 212 | <p>Reimplemented from <a href="qwidget.html#setPalette">QWidget</a>.
|
---|
| 213 | <h3 class=fn>void <a name="setRange"></a>QRangeControl::setRange ( int minValue, int maxValue )
|
---|
| 214 | </h3>
|
---|
| 215 | Sets the range control's minimum value to <em>minValue</em> and its
|
---|
| 216 | maximum value to <em>maxValue</em>.
|
---|
| 217 | <p> Calls the virtual <a href="#rangeChange">rangeChange</a>() function if one or both of the new
|
---|
| 218 | minimum and maximum values are different from the previous
|
---|
| 219 | setting. Calls the virtual <a href="#valueChange">valueChange</a>() function if the current
|
---|
| 220 | value is adjusted because it was outside the new range.
|
---|
| 221 | <p> If <em>maxValue</em> is smaller than <em>minValue</em>, <em>minValue</em> becomes
|
---|
| 222 | the only legal value.
|
---|
| 223 | <p> <p>See also <a href="#minValue-prop">minValue</a> and <a href="#maxValue-prop">maxValue</a>.
|
---|
| 224 |
|
---|
| 225 | <p>Examples: <a href="listbox-example.html#x1441">listbox/listbox.cpp</a>, <a href="tutorial1-12.html#x2387">t12/lcdrange.cpp</a>, <a href="tutorial1-05.html#x2315">t5/main.cpp</a>, <a href="tutorial1-06.html#x2325">t6/main.cpp</a>, <a href="tutorial1-08.html#x2334">t8/lcdrange.cpp</a>, and <a href="xform-example.html#x1250">xform/xform.cpp</a>.
|
---|
| 226 | <h3 class=fn>void <a name="setTickInterval"></a>QSlider::setTickInterval ( int )<tt> [virtual]</tt>
|
---|
| 227 | </h3><p>Sets the interval between tickmarks.
|
---|
| 228 | See the <a href="qslider.html#tickInterval-prop">"tickInterval"</a> property for details.
|
---|
| 229 | <h3 class=fn>void <a name="setTickmarks"></a>QSlider::setTickmarks ( <a href="qslider.html#TickSetting-enum">TickSetting</a> )<tt> [virtual]</tt>
|
---|
| 230 | </h3><p>Sets the tickmark settings for this slider.
|
---|
| 231 | See the <a href="qslider.html#tickmarks-prop">"tickmarks"</a> property for details.
|
---|
| 232 | <h3 class=fn>void <a name="setTracking"></a>QSlider::setTracking ( bool enable )<tt> [virtual]</tt>
|
---|
| 233 | </h3><p>Sets whether slider tracking is enabled to <em>enable</em>.
|
---|
| 234 | See the <a href="qslider.html#tracking-prop">"tracking"</a> property for details.
|
---|
| 235 | <h3 class=fn>void <a name="setValue"></a>QSlider::setValue ( int )<tt> [virtual slot]</tt>
|
---|
| 236 | </h3><p>Sets the current slider value.
|
---|
| 237 | See the <a href="qslider.html#value-prop">"value"</a> property for details.
|
---|
| 238 | <h3 class=fn>void <a name="sliderMoved"></a>QSlider::sliderMoved ( int value )<tt> [signal]</tt>
|
---|
| 239 | </h3>
|
---|
| 240 |
|
---|
| 241 | <p> This signal is emitted when the slider is dragged, with the new
|
---|
| 242 | slider <em>value</em> as its argument.
|
---|
| 243 |
|
---|
| 244 | <h3 class=fn>void <a name="sliderPressed"></a>QSlider::sliderPressed ()<tt> [signal]</tt>
|
---|
| 245 | </h3>
|
---|
| 246 |
|
---|
| 247 | <p> This signal is emitted when the user presses the slider with the
|
---|
| 248 | mouse.
|
---|
| 249 |
|
---|
| 250 | <h3 class=fn><a href="qrect.html">QRect</a> <a name="sliderRect"></a>QSlider::sliderRect () const
|
---|
| 251 | </h3>
|
---|
| 252 | Returns the slider handle rectangle. (This is the visual marker
|
---|
| 253 | that the user can move.)
|
---|
| 254 |
|
---|
| 255 | <h3 class=fn>void <a name="sliderReleased"></a>QSlider::sliderReleased ()<tt> [signal]</tt>
|
---|
| 256 | </h3>
|
---|
| 257 |
|
---|
| 258 | <p> This signal is emitted when the user releases the slider with the mouse.
|
---|
| 259 |
|
---|
| 260 | <h3 class=fn>int <a name="sliderStart"></a>QSlider::sliderStart () const
|
---|
| 261 | </h3>
|
---|
| 262 |
|
---|
| 263 | <p> Returns the start position of the slider.
|
---|
| 264 |
|
---|
| 265 | <h3 class=fn>void <a name="subtractStep"></a>QSlider::subtractStep ()<tt> [slot]</tt>
|
---|
| 266 | </h3>
|
---|
| 267 | Moves the slider one <a href="#pageStep">pageStep</a>() down or left.
|
---|
| 268 |
|
---|
| 269 | <h3 class=fn>int <a name="tickInterval"></a>QSlider::tickInterval () const
|
---|
| 270 | </h3><p>Returns the interval between tickmarks.
|
---|
| 271 | See the <a href="qslider.html#tickInterval-prop">"tickInterval"</a> property for details.
|
---|
| 272 | <h3 class=fn><a href="qslider.html#TickSetting-enum">TickSetting</a> <a name="tickmarks"></a>QSlider::tickmarks () const
|
---|
| 273 | </h3><p>Returns the tickmark settings for this slider.
|
---|
| 274 | See the <a href="qslider.html#tickmarks-prop">"tickmarks"</a> property for details.
|
---|
| 275 | <h3 class=fn>bool <a name="tracking"></a>QSlider::tracking () const
|
---|
| 276 | </h3><p>Returns TRUE if slider tracking is enabled; otherwise returns FALSE.
|
---|
| 277 | See the <a href="qslider.html#tracking-prop">"tracking"</a> property for details.
|
---|
| 278 | <h3 class=fn>int <a name="value"></a>QSlider::value () const
|
---|
| 279 | </h3><p>Returns the current slider value.
|
---|
| 280 | See the <a href="qslider.html#value-prop">"value"</a> property for details.
|
---|
| 281 | <h3 class=fn>void <a name="valueChange"></a>QSlider::valueChange ()<tt> [virtual protected]</tt>
|
---|
| 282 | </h3>
|
---|
| 283 | Implements the virtual <a href="qrangecontrol.html">QRangeControl</a> function.
|
---|
| 284 |
|
---|
| 285 | <p>Reimplemented from <a href="qrangecontrol.html#valueChange">QRangeControl</a>.
|
---|
| 286 | <h3 class=fn>void <a name="valueChanged"></a>QSlider::valueChanged ( int value )<tt> [signal]</tt>
|
---|
| 287 | </h3>
|
---|
| 288 |
|
---|
| 289 | <p> This signal is emitted when the slider value is changed, with the
|
---|
| 290 | new slider <em>value</em> as its argument.
|
---|
| 291 |
|
---|
| 292 | <p>Examples: <a href="rangecontrols-example.html#x1386">rangecontrols/rangecontrols.cpp</a>, <a href="qaxserver-example-simple.html#x2528">simple/main.cpp</a>, <a href="tutorial1-12.html#x2389">t12/lcdrange.cpp</a>, <a href="tutorial1-05.html#x2317">t5/main.cpp</a>, <a href="tutorial1-06.html#x2327">t6/main.cpp</a>, <a href="tutorial1-07.html#x2333">t7/lcdrange.cpp</a>, and <a href="xform-example.html#x1263">xform/xform.cpp</a>.
|
---|
| 293 | <hr><h2>Property Documentation</h2>
|
---|
| 294 | <h3 class=fn>int <a name="lineStep-prop"></a>lineStep</h3>
|
---|
| 295 | <p>This property holds the current line step.
|
---|
| 296 | <p>When setting lineStep, the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function will be
|
---|
| 297 | called if the new line step is different from the previous
|
---|
| 298 | setting.
|
---|
| 299 | <p> <p>See also <a href="qrangecontrol.html#setSteps">setSteps</a>(), <a href="qrangecontrol.html#pageStep">QRangeControl::pageStep</a>(), and <a href="qrangecontrol.html#setRange">setRange</a>().
|
---|
| 300 |
|
---|
| 301 | <p>Set this property's value with <a href="#setLineStep">setLineStep</a>() and get this property's value with <a href="#lineStep">lineStep</a>().
|
---|
| 302 | <h3 class=fn>int <a name="maxValue-prop"></a>maxValue</h3>
|
---|
| 303 | <p>This property holds the current maximum value of the slider.
|
---|
| 304 | <p>When setting this property, the <a href="#minValue-prop">QSlider::minValue</a> is adjusted,
|
---|
| 305 | if necessary, to ensure that the range remains valid.
|
---|
| 306 | <p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>().
|
---|
| 307 |
|
---|
| 308 | <p>Set this property's value with <a href="#setMaxValue">setMaxValue</a>() and get this property's value with <a href="#maxValue">maxValue</a>().
|
---|
| 309 | <h3 class=fn>int <a name="minValue-prop"></a>minValue</h3>
|
---|
| 310 | <p>This property holds the current minimum value of the slider.
|
---|
| 311 | <p>When setting this property, the <a href="#maxValue-prop">QSlider::maxValue</a> is adjusted,
|
---|
| 312 | if necessary, to ensure that the range remains valid.
|
---|
| 313 | <p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>().
|
---|
| 314 |
|
---|
| 315 | <p>Set this property's value with <a href="#setMinValue">setMinValue</a>() and get this property's value with <a href="#minValue">minValue</a>().
|
---|
| 316 | <h3 class=fn><a href="qt.html#Orientation-enum">Orientation</a> <a name="orientation-prop"></a>orientation</h3>
|
---|
| 317 | <p>This property holds the slider's orientation.
|
---|
| 318 | <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>.
|
---|
| 319 |
|
---|
| 320 | <p>Set this property's value with <a href="#setOrientation">setOrientation</a>() and get this property's value with <a href="#orientation">orientation</a>().
|
---|
| 321 | <h3 class=fn>int <a name="pageStep-prop"></a>pageStep</h3>
|
---|
| 322 | <p>This property holds the current page step.
|
---|
| 323 | <p>When setting pageStep, the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function will be
|
---|
| 324 | called if the new page step is different from the previous
|
---|
| 325 | setting.
|
---|
| 326 | <p> <p>See also <a href="qrangecontrol.html#setSteps">QRangeControl::setSteps</a>(), <a href="#lineStep-prop">lineStep</a>, and <a href="qrangecontrol.html#setRange">setRange</a>().
|
---|
| 327 |
|
---|
| 328 | <p>Set this property's value with <a href="#setPageStep">setPageStep</a>() and get this property's value with <a href="#pageStep">pageStep</a>().
|
---|
| 329 | <h3 class=fn>int <a name="tickInterval-prop"></a>tickInterval</h3>
|
---|
| 330 | <p>This property holds the interval between tickmarks.
|
---|
| 331 | <p>This is a value interval, not a pixel interval. If it is 0, the
|
---|
| 332 | slider will choose between <a href="#lineStep">lineStep</a>() and <a href="#pageStep">pageStep</a>(). The initial
|
---|
| 333 | value of tickInterval is 0.
|
---|
| 334 | <p> <p>See also <a href="qrangecontrol.html#lineStep">QRangeControl::lineStep</a>() and <a href="qrangecontrol.html#pageStep">QRangeControl::pageStep</a>().
|
---|
| 335 |
|
---|
| 336 | <p>Set this property's value with <a href="#setTickInterval">setTickInterval</a>() and get this property's value with <a href="#tickInterval">tickInterval</a>().
|
---|
| 337 | <h3 class=fn><a href="qslider.html#TickSetting-enum">TickSetting</a> <a name="tickmarks-prop"></a>tickmarks</h3>
|
---|
| 338 | <p>This property holds the tickmark settings for this slider.
|
---|
| 339 | <p>The valid values are in <a href="#TickSetting-enum">QSlider::TickSetting</a>. The default is
|
---|
| 340 | <a href="#TickSetting-enum">NoMarks</a>.
|
---|
| 341 | <p> <p>See also <a href="#tickInterval-prop">tickInterval</a>.
|
---|
| 342 |
|
---|
| 343 | <p>Set this property's value with <a href="#setTickmarks">setTickmarks</a>() and get this property's value with <a href="#tickmarks">tickmarks</a>().
|
---|
| 344 | <h3 class=fn>bool <a name="tracking-prop"></a>tracking</h3>
|
---|
| 345 | <p>This property holds whether slider tracking is enabled.
|
---|
| 346 | <p>If tracking is enabled (the default), the slider emits the
|
---|
| 347 | <a href="#valueChanged">valueChanged</a>() signal whenever the slider is being dragged. If
|
---|
| 348 | tracking is disabled, the slider emits the valueChanged() signal
|
---|
| 349 | when the user releases the mouse button (unless the value happens
|
---|
| 350 | to be the same as before).
|
---|
| 351 |
|
---|
| 352 | <p>Set this property's value with <a href="#setTracking">setTracking</a>() and get this property's value with <a href="#tracking">tracking</a>().
|
---|
| 353 | <h3 class=fn>int <a name="value-prop"></a>value</h3>
|
---|
| 354 | <p>This property holds the current slider value.
|
---|
| 355 | <p>Set this property's value with <a href="#setValue">setValue</a>() and get this property's value with <a href="#value">value</a>().
|
---|
| 356 | <p><p>See also <a href="qrangecontrol.html#value">QRangeControl::value</a>() and <a href="qrangecontrol.html#prevValue">prevValue</a>().
|
---|
| 357 |
|
---|
| 358 | <!-- eof -->
|
---|
| 359 | <hr><p>
|
---|
| 360 | This file is part of the <a href="index.html">Qt toolkit</a>.
|
---|
| 361 | Copyright © 1995-2007
|
---|
| 362 | <a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
|
---|
| 363 | <table width=100% cellspacing=0 border=0><tr>
|
---|
| 364 | <td>Copyright © 2007
|
---|
| 365 | <a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
---|
| 366 | <td align=right><div align=right>Qt 3.3.8</div>
|
---|
| 367 | </table></div></address></body>
|
---|
| 368 | </html>
|
---|