[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/qscrollbar.cpp:53 -->
|
---|
| 3 | <html>
|
---|
| 4 | <head>
|
---|
| 5 | <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
---|
| 6 | <title>QScrollBar 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>QScrollBar Class Reference</h1>
|
---|
| 33 |
|
---|
| 34 | <p>The QScrollBar widget provides a vertical or horizontal scroll bar.
|
---|
| 35 | <a href="#details">More...</a>
|
---|
| 36 | <p><tt>#include <<a href="qscrollbar-h.html">qscrollbar.h</a>></tt>
|
---|
| 37 | <p>Inherits <a href="qwidget.html">QWidget</a> and <a href="qrangecontrol.html">QRangeControl</a>.
|
---|
| 38 | <p><a href="qscrollbar-members.html">List of all member functions.</a>
|
---|
| 39 | <h2>Public Members</h2>
|
---|
| 40 | <ul>
|
---|
| 41 | <li class=fn><a href="#QScrollBar"><b>QScrollBar</b></a> ( QWidget * parent, const char * name = 0 )</li>
|
---|
| 42 | <li class=fn><a href="#QScrollBar-2"><b>QScrollBar</b></a> ( Orientation orientation, QWidget * parent, const char * name = 0 )</li>
|
---|
| 43 | <li class=fn><a href="#QScrollBar-3"><b>QScrollBar</b></a> ( int minValue, int maxValue, int lineStep, int pageStep, int value, Orientation orientation, QWidget * parent, const char * name = 0 )</li>
|
---|
| 44 | <li class=fn><a href="#~QScrollBar"><b>~QScrollBar</b></a> ()</li>
|
---|
| 45 | <li class=fn>virtual void <a href="#setOrientation"><b>setOrientation</b></a> ( Orientation )</li>
|
---|
| 46 | <li class=fn>Orientation <a href="#orientation"><b>orientation</b></a> () const</li>
|
---|
| 47 | <li class=fn>virtual void <a href="#setTracking"><b>setTracking</b></a> ( bool enable )</li>
|
---|
| 48 | <li class=fn>bool <a href="#tracking"><b>tracking</b></a> () const</li>
|
---|
| 49 | <li class=fn>bool <a href="#draggingSlider"><b>draggingSlider</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="#minValue"><b>minValue</b></a> () const</li>
|
---|
| 52 | <li class=fn>int <a href="#maxValue"><b>maxValue</b></a> () const</li>
|
---|
| 53 | <li class=fn>void <a href="#setMinValue"><b>setMinValue</b></a> ( int )</li>
|
---|
| 54 | <li class=fn>void <a href="#setMaxValue"><b>setMaxValue</b></a> ( int )</li>
|
---|
| 55 | <li class=fn>int <a href="#lineStep"><b>lineStep</b></a> () const</li>
|
---|
| 56 | <li class=fn>int <a href="#pageStep"><b>pageStep</b></a> () const</li>
|
---|
| 57 | <li class=fn>void <a href="#setLineStep"><b>setLineStep</b></a> ( int )</li>
|
---|
| 58 | <li class=fn>void <a href="#setPageStep"><b>setPageStep</b></a> ( int )</li>
|
---|
| 59 | <li class=fn>int <a href="#value"><b>value</b></a> () const</li>
|
---|
| 60 | <li class=fn>int <a href="#sliderStart"><b>sliderStart</b></a> () const</li>
|
---|
| 61 | <li class=fn>QRect <a href="#sliderRect"><b>sliderRect</b></a> () const</li>
|
---|
| 62 | </ul>
|
---|
| 63 | <h2>Public Slots</h2>
|
---|
| 64 | <ul>
|
---|
| 65 | <li class=fn>void <a href="#setValue"><b>setValue</b></a> ( int )</li>
|
---|
| 66 | </ul>
|
---|
| 67 | <h2>Signals</h2>
|
---|
| 68 | <ul>
|
---|
| 69 | <li class=fn>void <a href="#valueChanged"><b>valueChanged</b></a> ( int value )</li>
|
---|
| 70 | <li class=fn>void <a href="#sliderPressed"><b>sliderPressed</b></a> ()</li>
|
---|
| 71 | <li class=fn>void <a href="#sliderMoved"><b>sliderMoved</b></a> ( int value )</li>
|
---|
| 72 | <li class=fn>void <a href="#sliderReleased"><b>sliderReleased</b></a> ()</li>
|
---|
| 73 | <li class=fn>void <a href="#nextLine"><b>nextLine</b></a> ()</li>
|
---|
| 74 | <li class=fn>void <a href="#prevLine"><b>prevLine</b></a> ()</li>
|
---|
| 75 | <li class=fn>void <a href="#nextPage"><b>nextPage</b></a> ()</li>
|
---|
| 76 | <li class=fn>void <a href="#prevPage"><b>prevPage</b></a> ()</li>
|
---|
| 77 | </ul>
|
---|
| 78 | <h2>Properties</h2>
|
---|
| 79 | <ul>
|
---|
| 80 | <li class=fn>bool <a href="#draggingSlider-prop"><b>draggingSlider</b></a> - whether the user has clicked the mouse on the slider and is currently dragging it <em>(read only)</em></li>
|
---|
| 81 | <li class=fn>int <a href="#lineStep-prop"><b>lineStep</b></a> - the line step</li>
|
---|
| 82 | <li class=fn>int <a href="#maxValue-prop"><b>maxValue</b></a> - the scroll bar's maximum value</li>
|
---|
| 83 | <li class=fn>int <a href="#minValue-prop"><b>minValue</b></a> - the scroll bar's minimum value</li>
|
---|
| 84 | <li class=fn>Orientation <a href="#orientation-prop"><b>orientation</b></a> - the orientation of the scroll bar</li>
|
---|
| 85 | <li class=fn>int <a href="#pageStep-prop"><b>pageStep</b></a> - the page step</li>
|
---|
| 86 | <li class=fn>bool <a href="#tracking-prop"><b>tracking</b></a> - whether scroll bar tracking is enabled</li>
|
---|
| 87 | <li class=fn>int <a href="#value-prop"><b>value</b></a> - the scroll bar's value</li>
|
---|
| 88 | </ul>
|
---|
| 89 | <h2>Protected Members</h2>
|
---|
| 90 | <ul>
|
---|
| 91 | <li class=fn>virtual void <a href="#hideEvent"><b>hideEvent</b></a> ( QHideEvent * )</li>
|
---|
| 92 | </ul>
|
---|
| 93 | <hr><a name="details"></a><h2>Detailed Description</h2>
|
---|
| 94 |
|
---|
| 95 |
|
---|
| 96 | The QScrollBar widget provides a vertical or horizontal scroll bar.
|
---|
| 97 | <p>
|
---|
| 98 | <p> A scroll bar allows the user to control a value within a
|
---|
| 99 | program-definable range and gives users a visible indication of
|
---|
| 100 | the current value of a <a href="qrangecontrol.html">range control</a>.
|
---|
| 101 | <p> Scroll bars include four separate controls:
|
---|
| 102 | <p> <ul>
|
---|
| 103 | <p> <li> The <em>line-up</em> and <em>line-down</em> controls are little buttons
|
---|
| 104 | which the user can use to move one "line" up or down. The meaning
|
---|
| 105 | of line is configurable. In editors and list boxes it means one
|
---|
| 106 | line of text; in an image viewer it might mean 20 pixels.
|
---|
| 107 | <p> <li> The <em>slider</em> is the handle that indicates the current value of
|
---|
| 108 | the scroll bar, which the user can drag to change the value. This
|
---|
| 109 | part of the scroll bar is sometimes called the "thumb".
|
---|
| 110 | <p> <li> The <em>page-up/page-down</em> control is the area on which the
|
---|
| 111 | slider slides (the scroll bar's background). Clicking here moves
|
---|
| 112 | the scroll bar towards the click. The meaning of "page" is also
|
---|
| 113 | configurable: in editors and list boxes it means as many lines as
|
---|
| 114 | there is space for in the widget.
|
---|
| 115 | <p> </ul>
|
---|
| 116 | <p> QScrollBar has very few of its own functions; it mostly relies on
|
---|
| 117 | <a href="qrangecontrol.html">QRangeControl</a>. The most useful functions are <a href="#setValue">setValue</a>() to set the
|
---|
| 118 | scroll bar directly to some value; <a href="qrangecontrol.html#addPage">addPage</a>(), <a href="qrangecontrol.html#addLine">addLine</a>(),
|
---|
| 119 | <a href="qrangecontrol.html#subtractPage">subtractPage</a>(), and <a href="qrangecontrol.html#subtractLine">subtractLine</a>() to simulate the effects of
|
---|
| 120 | clicking (useful for accelerator keys); <a href="qrangecontrol.html#setSteps">setSteps</a>() to define the
|
---|
| 121 | values of <a href="#pageStep">pageStep</a>() and <a href="#lineStep">lineStep</a>(); and <a href="qrangecontrol.html#setRange">setRange</a>() to set the
|
---|
| 122 | <a href="#minValue">minValue</a>() and <a href="#maxValue">maxValue</a>() of the scroll bar. QScrollBar has a
|
---|
| 123 | convenience constructor with which you can set most of these
|
---|
| 124 | properties.
|
---|
| 125 | <p> Some GUI styles (for example, the Windows and <a href="motif-extension.html#Motif">Motif</a> styles
|
---|
| 126 | provided with Qt), also use the pageStep() value to calculate the
|
---|
| 127 | size of the slider.
|
---|
| 128 | <p> In addition to the access functions from <a href="qrangecontrol.html">QRangeControl</a>, QScrollBar
|
---|
| 129 | provides a comprehensive set of signals:
|
---|
| 130 | <center><table cellpadding="4" cellspacing="2" border="0">
|
---|
| 131 | <tr bgcolor="#a2c511"> <th valign="top">Signal <th valign="top">Emitted when
|
---|
| 132 | <tr bgcolor="#f0f0f0"> <td valign="top"><a href="#valueChanged">valueChanged</a>()
|
---|
| 133 | <td valign="top">the scroll bar's value has changed. The <a href="#tracking">tracking</a>()
|
---|
| 134 | determines whether this signal is emitted during user
|
---|
| 135 | interaction.
|
---|
| 136 | <tr bgcolor="#d0d0d0"> <td valign="top"><a href="#sliderPressed">sliderPressed</a>()
|
---|
| 137 | <td valign="top">the user starts to drag the slider.
|
---|
| 138 | <tr bgcolor="#f0f0f0"> <td valign="top"><a href="#sliderMoved">sliderMoved</a>()
|
---|
| 139 | <td valign="top">the user drags the slider.
|
---|
| 140 | <tr bgcolor="#d0d0d0"> <td valign="top"><a href="#sliderReleased">sliderReleased</a>()
|
---|
| 141 | <td valign="top">the user releases the slider.
|
---|
| 142 | <tr bgcolor="#f0f0f0"> <td valign="top"><a href="#nextLine">nextLine</a>()
|
---|
| 143 | <td valign="top">the scroll bar has moved one line down or right. Line is
|
---|
| 144 | defined in <a href="qrangecontrol.html">QRangeControl</a>.
|
---|
| 145 | <tr bgcolor="#d0d0d0"> <td valign="top"><a href="#prevLine">prevLine</a>()
|
---|
| 146 | <td valign="top">the scroll bar has moved one line up or left.
|
---|
| 147 | <tr bgcolor="#f0f0f0"> <td valign="top"><a href="#nextPage">nextPage</a>()
|
---|
| 148 | <td valign="top">the scroll bar has moved one page down or right.
|
---|
| 149 | <tr bgcolor="#d0d0d0"> <td valign="top"><a href="#prevPage">prevPage</a>()
|
---|
| 150 | <td valign="top">the scroll bar has moved one page up or left.
|
---|
| 151 | </table></center>
|
---|
| 152 | <p> QScrollBar only provides integer ranges. Note that although
|
---|
| 153 | QScrollBar handles very large numbers, scroll bars on current
|
---|
| 154 | screens cannot usefully control ranges above about 100,000 pixels.
|
---|
| 155 | Beyond that, it becomes difficult for the user to control the
|
---|
| 156 | scroll bar using either the keyboard or the mouse.
|
---|
| 157 | <p> A scroll bar can be controlled by the keyboard, but it has a
|
---|
| 158 | default <a href="qwidget.html#focusPolicy">focusPolicy</a>() of <a href="qwidget.html#FocusPolicy-enum">NoFocus</a>. Use <a href="qwidget.html#setFocusPolicy">setFocusPolicy</a>() to
|
---|
| 159 | enable <a href="focus.html#keyboard-focus">keyboard focus</a>. See <a href="qwidget.html#keyPressEvent">keyPressEvent</a>() for a list of key
|
---|
| 160 | bindings.
|
---|
| 161 | <p> If you need to add scroll bars to an interface, consider using the
|
---|
| 162 | <a href="qscrollview.html">QScrollView</a> class, which encapsulates the common uses for scroll
|
---|
| 163 | bars.
|
---|
| 164 | <p> <img src=qscrbar-m.png> <img src=qscrbar-w.png>
|
---|
| 165 | <p> <p>See also <a href="qslider.html">QSlider</a>, <a href="qspinbox.html">QSpinBox</a>, <a href="qscrollview.html">QScrollView</a>, <a href="guibooks.html#fowler">GUI Design Handbook: Scroll Bar</a>, and <a href="basic.html">Basic Widgets</a>.
|
---|
| 166 |
|
---|
| 167 | <hr><h2>Member Function Documentation</h2>
|
---|
| 168 | <h3 class=fn><a name="QScrollBar"></a>QScrollBar::QScrollBar ( <a href="qwidget.html">QWidget</a> * parent, const char * name = 0 )
|
---|
| 169 | </h3>
|
---|
| 170 | Constructs a vertical scroll bar.
|
---|
| 171 | <p> The <em>parent</em> and <em>name</em> arguments are sent on to the <a href="qwidget.html">QWidget</a>
|
---|
| 172 | constructor.
|
---|
| 173 | <p> The <a href="#minValue-prop">minValue</a> defaults to 0, the <a href="#maxValue-prop">maxValue</a> to 99, with a <a href="#lineStep-prop">lineStep</a> size of 1 and a <a href="#pageStep-prop">pageStep</a> size of 10, and an initial
|
---|
| 174 | <a href="#value-prop">value</a> of 0.
|
---|
| 175 |
|
---|
| 176 | <h3 class=fn><a name="QScrollBar-2"></a>QScrollBar::QScrollBar ( <a href="qt.html#Orientation-enum">Orientation</a> orientation, <a href="qwidget.html">QWidget</a> * parent, const char * name = 0 )
|
---|
| 177 | </h3>
|
---|
| 178 | Constructs a scroll bar.
|
---|
| 179 | <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>.
|
---|
| 180 | <p> The <em>parent</em> and <em>name</em> arguments are sent on to the <a href="qwidget.html">QWidget</a>
|
---|
| 181 | constructor.
|
---|
| 182 | <p> The <a href="#minValue-prop">minValue</a> defaults to 0, the <a href="#maxValue-prop">maxValue</a> to 99, with a <a href="#lineStep-prop">lineStep</a> size of 1 and a <a href="#pageStep-prop">pageStep</a> size of 10, and an initial
|
---|
| 183 | <a href="#value-prop">value</a> of 0.
|
---|
| 184 |
|
---|
| 185 | <h3 class=fn><a name="QScrollBar-3"></a>QScrollBar::QScrollBar ( int minValue, int maxValue, int lineStep, int pageStep, int value, <a href="qt.html#Orientation-enum">Orientation</a> orientation, <a href="qwidget.html">QWidget</a> * parent, const char * name = 0 )
|
---|
| 186 | </h3>
|
---|
| 187 | Constructs a scroll bar whose value can never be smaller than <em>minValue</em> or greater than <em>maxValue</em>, whose line step size is <em>lineStep</em> and page step size is <em>pageStep</em> and whose value is
|
---|
| 188 | initially <em>value</em> (which is guaranteed to be in range using
|
---|
| 189 | <a href="qrangecontrol.html#bound">bound</a>()).
|
---|
| 190 | <p> If <em>orientation</em> is <a href="qt.html#Orientation-enum">Vertical</a> the scroll bar is vertical and if
|
---|
| 191 | it is <a href="qt.html#Orientation-enum">Horizontal</a> the scroll bar is horizontal.
|
---|
| 192 | <p> The <em>parent</em> and <em>name</em> arguments are sent on to the <a href="qwidget.html">QWidget</a>
|
---|
| 193 | constructor.
|
---|
| 194 |
|
---|
| 195 | <h3 class=fn><a name="~QScrollBar"></a>QScrollBar::~QScrollBar ()
|
---|
| 196 | </h3>
|
---|
| 197 | Destructor.
|
---|
| 198 |
|
---|
| 199 | <h3 class=fn>bool <a name="draggingSlider"></a>QScrollBar::draggingSlider () const
|
---|
| 200 | </h3><p>Returns TRUE if the user has clicked the mouse on the slider and is currently dragging it; otherwise returns FALSE.
|
---|
| 201 | See the <a href="qscrollbar.html#draggingSlider-prop">"draggingSlider"</a> property for details.
|
---|
| 202 | <h3 class=fn>void <a name="hideEvent"></a>QScrollBar::hideEvent ( <a href="qhideevent.html">QHideEvent</a> * )<tt> [virtual protected]</tt>
|
---|
| 203 | </h3>
|
---|
| 204 | This function is called when the scrollbar is hidden.
|
---|
| 205 |
|
---|
| 206 | <p>Reimplemented from <a href="qwidget.html#hideEvent">QWidget</a>.
|
---|
| 207 | <h3 class=fn>int <a name="lineStep"></a>QScrollBar::lineStep () const
|
---|
| 208 | </h3><p>Returns the line step.
|
---|
| 209 | See the <a href="qscrollbar.html#lineStep-prop">"lineStep"</a> property for details.
|
---|
| 210 | <h3 class=fn>int <a name="maxValue"></a>QScrollBar::maxValue () const
|
---|
| 211 | </h3><p>Returns the scroll bar's maximum value.
|
---|
| 212 | See the <a href="qscrollbar.html#maxValue-prop">"maxValue"</a> property for details.
|
---|
| 213 | <h3 class=fn>int <a name="minValue"></a>QScrollBar::minValue () const
|
---|
| 214 | </h3><p>Returns the scroll bar's minimum value.
|
---|
| 215 | See the <a href="qscrollbar.html#minValue-prop">"minValue"</a> property for details.
|
---|
| 216 | <h3 class=fn>void <a name="nextLine"></a>QScrollBar::nextLine ()<tt> [signal]</tt>
|
---|
| 217 | </h3>
|
---|
| 218 |
|
---|
| 219 | <p> This signal is emitted when the scroll bar scrolls one line down
|
---|
| 220 | or right.
|
---|
| 221 |
|
---|
| 222 | <h3 class=fn>void <a name="nextPage"></a>QScrollBar::nextPage ()<tt> [signal]</tt>
|
---|
| 223 | </h3>
|
---|
| 224 |
|
---|
| 225 | <p> This signal is emitted when the scroll bar scrolls one page down
|
---|
| 226 | or right.
|
---|
| 227 |
|
---|
| 228 | <h3 class=fn><a href="qt.html#Orientation-enum">Orientation</a> <a name="orientation"></a>QScrollBar::orientation () const
|
---|
| 229 | </h3><p>Returns the orientation of the scroll bar.
|
---|
| 230 | See the <a href="qscrollbar.html#orientation-prop">"orientation"</a> property for details.
|
---|
| 231 | <h3 class=fn>int <a name="pageStep"></a>QScrollBar::pageStep () const
|
---|
| 232 | </h3><p>Returns the page step.
|
---|
| 233 | See the <a href="qscrollbar.html#pageStep-prop">"pageStep"</a> property for details.
|
---|
| 234 | <h3 class=fn>void <a name="prevLine"></a>QScrollBar::prevLine ()<tt> [signal]</tt>
|
---|
| 235 | </h3>
|
---|
| 236 |
|
---|
| 237 | <p> This signal is emitted when the scroll bar scrolls one line up or
|
---|
| 238 | left.
|
---|
| 239 |
|
---|
| 240 | <h3 class=fn>void <a name="prevPage"></a>QScrollBar::prevPage ()<tt> [signal]</tt>
|
---|
| 241 | </h3>
|
---|
| 242 |
|
---|
| 243 | <p> This signal is emitted when the scroll bar scrolls one page up or
|
---|
| 244 | left.
|
---|
| 245 |
|
---|
| 246 | <h3 class=fn>void <a name="setLineStep"></a>QScrollBar::setLineStep ( int )
|
---|
| 247 | </h3><p>Sets the line step.
|
---|
| 248 | See the <a href="qscrollbar.html#lineStep-prop">"lineStep"</a> property for details.
|
---|
| 249 | <h3 class=fn>void <a name="setMaxValue"></a>QScrollBar::setMaxValue ( int )
|
---|
| 250 | </h3><p>Sets the scroll bar's maximum value.
|
---|
| 251 | See the <a href="qscrollbar.html#maxValue-prop">"maxValue"</a> property for details.
|
---|
| 252 | <h3 class=fn>void <a name="setMinValue"></a>QScrollBar::setMinValue ( int )
|
---|
| 253 | </h3><p>Sets the scroll bar's minimum value.
|
---|
| 254 | See the <a href="qscrollbar.html#minValue-prop">"minValue"</a> property for details.
|
---|
| 255 | <h3 class=fn>void <a name="setOrientation"></a>QScrollBar::setOrientation ( <a href="qt.html#Orientation-enum">Orientation</a> )<tt> [virtual]</tt>
|
---|
| 256 | </h3><p>Sets the orientation of the scroll bar.
|
---|
| 257 | See the <a href="qscrollbar.html#orientation-prop">"orientation"</a> property for details.
|
---|
| 258 | <h3 class=fn>void <a name="setPageStep"></a>QScrollBar::setPageStep ( int )
|
---|
| 259 | </h3><p>Sets the page step.
|
---|
| 260 | See the <a href="qscrollbar.html#pageStep-prop">"pageStep"</a> property for details.
|
---|
| 261 | <h3 class=fn>void <a name="setPalette"></a>QScrollBar::setPalette ( const <a href="qpalette.html">QPalette</a> & p )<tt> [virtual]</tt>
|
---|
| 262 | </h3>
|
---|
| 263 | Reimplements the virtual function <a href="qwidget.html#setPalette">QWidget::setPalette</a>().
|
---|
| 264 | <p> Sets the background color to the mid color for <a href="motif-extension.html#Motif">Motif</a> style scroll
|
---|
| 265 | bars using palette <em>p</em>.
|
---|
| 266 |
|
---|
| 267 | <p>Reimplemented from <a href="qwidget.html#setPalette">QWidget</a>.
|
---|
| 268 | <h3 class=fn>void <a name="setTracking"></a>QScrollBar::setTracking ( bool enable )<tt> [virtual]</tt>
|
---|
| 269 | </h3><p>Sets whether scroll bar tracking is enabled to <em>enable</em>.
|
---|
| 270 | See the <a href="qscrollbar.html#tracking-prop">"tracking"</a> property for details.
|
---|
| 271 | <h3 class=fn>void <a name="setValue"></a>QScrollBar::setValue ( int )<tt> [slot]</tt>
|
---|
| 272 | </h3><p>Sets the scroll bar's value.
|
---|
| 273 | See the <a href="qscrollbar.html#value-prop">"value"</a> property for details.
|
---|
| 274 | <h3 class=fn>void <a name="sliderMoved"></a>QScrollBar::sliderMoved ( int value )<tt> [signal]</tt>
|
---|
| 275 | </h3>
|
---|
| 276 |
|
---|
| 277 | <p> This signal is emitted when the slider is dragged by the user, with
|
---|
| 278 | the new scroll bar <em>value</em> as an argument.
|
---|
| 279 | <p> This signal is emitted even when tracking is turned off.
|
---|
| 280 | <p> <p>See also <a href="#tracking-prop">tracking</a>, <a href="#valueChanged">valueChanged</a>(), <a href="#nextLine">nextLine</a>(), <a href="#prevLine">prevLine</a>(), <a href="#nextPage">nextPage</a>(), and <a href="#prevPage">prevPage</a>().
|
---|
| 281 |
|
---|
| 282 | <h3 class=fn>void <a name="sliderPressed"></a>QScrollBar::sliderPressed ()<tt> [signal]</tt>
|
---|
| 283 | </h3>
|
---|
| 284 |
|
---|
| 285 | <p> This signal is emitted when the user presses the slider with the
|
---|
| 286 | mouse.
|
---|
| 287 |
|
---|
| 288 | <h3 class=fn><a href="qrect.html">QRect</a> <a name="sliderRect"></a>QScrollBar::sliderRect () const
|
---|
| 289 | </h3>
|
---|
| 290 | Returns the scroll bar slider rectangle.
|
---|
| 291 | <p> <p>See also <a href="#sliderStart">sliderStart</a>().
|
---|
| 292 |
|
---|
| 293 | <h3 class=fn>void <a name="sliderReleased"></a>QScrollBar::sliderReleased ()<tt> [signal]</tt>
|
---|
| 294 | </h3>
|
---|
| 295 |
|
---|
| 296 | <p> This signal is emitted when the user releases the slider with the
|
---|
| 297 | mouse.
|
---|
| 298 |
|
---|
| 299 | <h3 class=fn>int <a name="sliderStart"></a>QScrollBar::sliderStart () const
|
---|
| 300 | </h3>
|
---|
| 301 |
|
---|
| 302 | <p> Returns the pixel position where the scroll bar slider starts.
|
---|
| 303 | <p> This is equivalent to <a href="#sliderRect">sliderRect</a>().<a href="qwidget.html#y">y</a>() for vertical scroll bars or
|
---|
| 304 | sliderRect().<a href="qwidget.html#x">x</a>() for horizontal scroll bars.
|
---|
| 305 |
|
---|
| 306 | <h3 class=fn>bool <a name="tracking"></a>QScrollBar::tracking () const
|
---|
| 307 | </h3><p>Returns TRUE if scroll bar tracking is enabled; otherwise returns FALSE.
|
---|
| 308 | See the <a href="qscrollbar.html#tracking-prop">"tracking"</a> property for details.
|
---|
| 309 | <h3 class=fn>int <a name="value"></a>QScrollBar::value () const
|
---|
| 310 | </h3><p>Returns the scroll bar's value.
|
---|
| 311 | See the <a href="qscrollbar.html#value-prop">"value"</a> property for details.
|
---|
| 312 | <h3 class=fn>void <a name="valueChanged"></a>QScrollBar::valueChanged ( int value )<tt> [signal]</tt>
|
---|
| 313 | </h3>
|
---|
| 314 |
|
---|
| 315 | <p> This signal is emitted when the scroll bar value has changed, with
|
---|
| 316 | the new scroll bar <em>value</em> as an argument.
|
---|
| 317 |
|
---|
| 318 | <hr><h2>Property Documentation</h2>
|
---|
| 319 | <h3 class=fn>bool <a name="draggingSlider-prop"></a>draggingSlider</h3>
|
---|
| 320 | <p>This property holds whether the user has clicked the mouse on the slider and is currently dragging it.
|
---|
| 321 | <p>
|
---|
| 322 | <p>Get this property's value with <a href="#draggingSlider">draggingSlider</a>().
|
---|
| 323 | <h3 class=fn>int <a name="lineStep-prop"></a>lineStep</h3>
|
---|
| 324 | <p>This property holds the line step.
|
---|
| 325 | <p>When setting lineStep, the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function will be
|
---|
| 326 | called if the new line step is different from the previous
|
---|
| 327 | setting.
|
---|
| 328 | <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>().
|
---|
| 329 |
|
---|
| 330 | <p>Set this property's value with <a href="#setLineStep">setLineStep</a>() and get this property's value with <a href="#lineStep">lineStep</a>().
|
---|
| 331 | <h3 class=fn>int <a name="maxValue-prop"></a>maxValue</h3>
|
---|
| 332 | <p>This property holds the scroll bar's maximum value.
|
---|
| 333 | <p>When setting this property, the <a href="#minValue-prop">QScrollBar::minValue</a> is
|
---|
| 334 | adjusted if necessary to ensure that the range remains valid.
|
---|
| 335 | <p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>().
|
---|
| 336 |
|
---|
| 337 | <p>Set this property's value with <a href="#setMaxValue">setMaxValue</a>() and get this property's value with <a href="#maxValue">maxValue</a>().
|
---|
| 338 | <h3 class=fn>int <a name="minValue-prop"></a>minValue</h3>
|
---|
| 339 | <p>This property holds the scroll bar's minimum value.
|
---|
| 340 | <p>When setting this property, the <a href="#maxValue-prop">QScrollBar::maxValue</a> is
|
---|
| 341 | adjusted if necessary to ensure that the range remains valid.
|
---|
| 342 | <p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>().
|
---|
| 343 |
|
---|
| 344 | <p>Set this property's value with <a href="#setMinValue">setMinValue</a>() and get this property's value with <a href="#minValue">minValue</a>().
|
---|
| 345 | <h3 class=fn><a href="qt.html#Orientation-enum">Orientation</a> <a name="orientation-prop"></a>orientation</h3>
|
---|
| 346 | <p>This property holds the orientation of the scroll bar.
|
---|
| 347 | <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>.
|
---|
| 348 |
|
---|
| 349 | <p>Set this property's value with <a href="#setOrientation">setOrientation</a>() and get this property's value with <a href="#orientation">orientation</a>().
|
---|
| 350 | <h3 class=fn>int <a name="pageStep-prop"></a>pageStep</h3>
|
---|
| 351 | <p>This property holds the page step.
|
---|
| 352 | <p>When setting pageStep, the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function will be
|
---|
| 353 | called if the new page step is different from the previous
|
---|
| 354 | setting.
|
---|
| 355 | <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>().
|
---|
| 356 |
|
---|
| 357 | <p>Set this property's value with <a href="#setPageStep">setPageStep</a>() and get this property's value with <a href="#pageStep">pageStep</a>().
|
---|
| 358 | <h3 class=fn>bool <a name="tracking-prop"></a>tracking</h3>
|
---|
| 359 | <p>This property holds whether scroll bar tracking is enabled.
|
---|
| 360 | <p>If tracking is enabled (the default), the scroll bar emits the
|
---|
| 361 | <a href="#valueChanged">valueChanged</a>() signal while the slider is being dragged. If
|
---|
| 362 | tracking is disabled, the scroll bar emits the valueChanged()
|
---|
| 363 | signal only when the user releases the mouse button after moving
|
---|
| 364 | the slider.
|
---|
| 365 |
|
---|
| 366 | <p>Set this property's value with <a href="#setTracking">setTracking</a>() and get this property's value with <a href="#tracking">tracking</a>().
|
---|
| 367 | <h3 class=fn>int <a name="value-prop"></a>value</h3>
|
---|
| 368 | <p>This property holds the scroll bar's value.
|
---|
| 369 | <p>Set this property's value with <a href="#setValue">setValue</a>() and get this property's value with <a href="#value">value</a>().
|
---|
| 370 | <p><p>See also <a href="qrangecontrol.html#value">QRangeControl::value</a>() and <a href="qrangecontrol.html#prevValue">prevValue</a>().
|
---|
| 371 |
|
---|
| 372 | <!-- eof -->
|
---|
| 373 | <hr><p>
|
---|
| 374 | This file is part of the <a href="index.html">Qt toolkit</a>.
|
---|
| 375 | Copyright © 1995-2007
|
---|
| 376 | <a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
|
---|
| 377 | <table width=100% cellspacing=0 border=0><tr>
|
---|
| 378 | <td>Copyright © 2007
|
---|
| 379 | <a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
---|
| 380 | <td align=right><div align=right>Qt 3.3.8</div>
|
---|
| 381 | </table></div></address></body>
|
---|
| 382 | </html>
|
---|