You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
383 lines
23 KiB
383 lines
23 KiB
13 years ago
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||
|
|
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/widgets/qscrollbar.cpp:53 -->
|
||
|
|
<html>
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||
|
|
<title>TQScrollBar Class</title>
|
||
|
|
<style type="text/css"><!--
|
||
|
|
fn { margin-left: 1cm; text-indent: -1cm; }
|
||
|
|
a:link { color: #004faf; text-decoration: none }
|
||
|
|
a:visited { color: #672967; text-decoration: none }
|
||
|
|
body { background: #ffffff; color: black; }
|
||
|
|
--></style>
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
|
||
|
|
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||
|
|
<tr bgcolor="#E5E5E5">
|
||
|
|
<td 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>
|
||
|
|
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQScrollBar Class Reference</h1>
|
||
|
|
|
||
|
|
<p>The TQScrollBar widget provides a vertical or horizontal scroll bar.
|
||
|
|
<a href="#details">More...</a>
|
||
|
13 years ago
|
<p><tt>#include <<a href="qscrollbar-h.html">ntqscrollbar.h</a>></tt>
|
||
|
|
<p>Inherits <a href="ntqwidget.html">TQWidget</a> and <a href="ntqrangecontrol.html">TQRangeControl</a>.
|
||
|
13 years ago
|
<p><a href="qscrollbar-members.html">List of all member functions.</a>
|
||
|
|
<h2>Public Members</h2>
|
||
|
|
<ul>
|
||
|
|
<li class=fn><a href="#TQScrollBar"><b>TQScrollBar</b></a> ( TQWidget * parent, const char * name = 0 )</li>
|
||
|
|
<li class=fn><a href="#TQScrollBar-2"><b>TQScrollBar</b></a> ( Orientation orientation, TQWidget * parent, const char * name = 0 )</li>
|
||
|
|
<li class=fn><a href="#TQScrollBar-3"><b>TQScrollBar</b></a> ( int minValue, int maxValue, int lineStep, int pageStep, int value, Orientation orientation, TQWidget * parent, const char * name = 0 )</li>
|
||
|
|
<li class=fn><a href="#~TQScrollBar"><b>~TQScrollBar</b></a> ()</li>
|
||
|
|
<li class=fn>virtual void <a href="#setOrientation"><b>setOrientation</b></a> ( Orientation )</li>
|
||
|
|
<li class=fn>Orientation <a href="#orientation"><b>orientation</b></a> () const</li>
|
||
|
|
<li class=fn>virtual void <a href="#setTracking"><b>setTracking</b></a> ( bool enable )</li>
|
||
|
|
<li class=fn>bool <a href="#tracking"><b>tracking</b></a> () const</li>
|
||
|
|
<li class=fn>bool <a href="#draggingSlider"><b>draggingSlider</b></a> () const</li>
|
||
|
|
<li class=fn>virtual void <a href="#setPalette"><b>setPalette</b></a> ( const TQPalette & p )</li>
|
||
|
|
<li class=fn>int <a href="#minValue"><b>minValue</b></a> () const</li>
|
||
|
|
<li class=fn>int <a href="#maxValue"><b>maxValue</b></a> () const</li>
|
||
|
|
<li class=fn>void <a href="#setMinValue"><b>setMinValue</b></a> ( int )</li>
|
||
|
|
<li class=fn>void <a href="#setMaxValue"><b>setMaxValue</b></a> ( int )</li>
|
||
|
|
<li class=fn>int <a href="#lineStep"><b>lineStep</b></a> () const</li>
|
||
|
|
<li class=fn>int <a href="#pageStep"><b>pageStep</b></a> () const</li>
|
||
|
|
<li class=fn>void <a href="#setLineStep"><b>setLineStep</b></a> ( int )</li>
|
||
|
|
<li class=fn>void <a href="#setPageStep"><b>setPageStep</b></a> ( int )</li>
|
||
|
|
<li class=fn>int <a href="#value"><b>value</b></a> () const</li>
|
||
|
|
<li class=fn>int <a href="#sliderStart"><b>sliderStart</b></a> () const</li>
|
||
|
|
<li class=fn>TQRect <a href="#sliderRect"><b>sliderRect</b></a> () const</li>
|
||
|
|
</ul>
|
||
|
|
<h2>Public Slots</h2>
|
||
|
|
<ul>
|
||
|
|
<li class=fn>void <a href="#setValue"><b>setValue</b></a> ( int )</li>
|
||
|
|
</ul>
|
||
|
|
<h2>Signals</h2>
|
||
|
|
<ul>
|
||
|
|
<li class=fn>void <a href="#valueChanged"><b>valueChanged</b></a> ( int value )</li>
|
||
|
|
<li class=fn>void <a href="#sliderPressed"><b>sliderPressed</b></a> ()</li>
|
||
|
|
<li class=fn>void <a href="#sliderMoved"><b>sliderMoved</b></a> ( int value )</li>
|
||
|
|
<li class=fn>void <a href="#sliderReleased"><b>sliderReleased</b></a> ()</li>
|
||
|
|
<li class=fn>void <a href="#nextLine"><b>nextLine</b></a> ()</li>
|
||
|
|
<li class=fn>void <a href="#prevLine"><b>prevLine</b></a> ()</li>
|
||
|
|
<li class=fn>void <a href="#nextPage"><b>nextPage</b></a> ()</li>
|
||
|
|
<li class=fn>void <a href="#prevPage"><b>prevPage</b></a> ()</li>
|
||
|
|
</ul>
|
||
|
|
<h2>Properties</h2>
|
||
|
|
<ul>
|
||
|
|
<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>
|
||
|
|
<li class=fn>int <a href="#lineStep-prop"><b>lineStep</b></a> - the line step</li>
|
||
|
|
<li class=fn>int <a href="#maxValue-prop"><b>maxValue</b></a> - the scroll bar's maximum value</li>
|
||
|
|
<li class=fn>int <a href="#minValue-prop"><b>minValue</b></a> - the scroll bar's minimum value</li>
|
||
|
|
<li class=fn>Orientation <a href="#orientation-prop"><b>orientation</b></a> - the orientation of the scroll bar</li>
|
||
|
|
<li class=fn>int <a href="#pageStep-prop"><b>pageStep</b></a> - the page step</li>
|
||
|
|
<li class=fn>bool <a href="#tracking-prop"><b>tracking</b></a> - whether scroll bar tracking is enabled</li>
|
||
|
|
<li class=fn>int <a href="#value-prop"><b>value</b></a> - the scroll bar's value</li>
|
||
|
|
</ul>
|
||
|
|
<h2>Protected Members</h2>
|
||
|
|
<ul>
|
||
|
|
<li class=fn>virtual void <a href="#hideEvent"><b>hideEvent</b></a> ( TQHideEvent * )</li>
|
||
|
|
</ul>
|
||
|
|
<hr><a name="details"></a><h2>Detailed Description</h2>
|
||
|
|
|
||
|
|
|
||
|
|
The TQScrollBar widget provides a vertical or horizontal scroll bar.
|
||
|
|
<p>
|
||
|
|
<p> A scroll bar allows the user to control a value within a
|
||
|
|
program-definable range and gives users a visible indication of
|
||
|
13 years ago
|
the current value of a <a href="ntqrangecontrol.html">range control</a>.
|
||
|
13 years ago
|
<p> Scroll bars include four separate controls:
|
||
|
|
<p> <ul>
|
||
|
|
<p> <li> The <em>line-up</em> and <em>line-down</em> controls are little buttons
|
||
|
|
which the user can use to move one "line" up or down. The meaning
|
||
|
|
of line is configurable. In editors and list boxes it means one
|
||
|
|
line of text; in an image viewer it might mean 20 pixels.
|
||
|
|
<p> <li> The <em>slider</em> is the handle that indicates the current value of
|
||
|
|
the scroll bar, which the user can drag to change the value. This
|
||
|
|
part of the scroll bar is sometimes called the "thumb".
|
||
|
|
<p> <li> The <em>page-up/page-down</em> control is the area on which the
|
||
|
|
slider slides (the scroll bar's background). Clicking here moves
|
||
|
|
the scroll bar towards the click. The meaning of "page" is also
|
||
|
|
configurable: in editors and list boxes it means as many lines as
|
||
|
|
there is space for in the widget.
|
||
|
|
<p> </ul>
|
||
|
|
<p> TQScrollBar has very few of its own functions; it mostly relies on
|
||
|
13 years ago
|
<a href="ntqrangecontrol.html">TQRangeControl</a>. The most useful functions are <a href="#setValue">setValue</a>() to set the
|
||
|
|
scroll bar directly to some value; <a href="ntqrangecontrol.html#addPage">addPage</a>(), <a href="ntqrangecontrol.html#addLine">addLine</a>(),
|
||
|
|
<a href="ntqrangecontrol.html#subtractPage">subtractPage</a>(), and <a href="ntqrangecontrol.html#subtractLine">subtractLine</a>() to simulate the effects of
|
||
|
|
clicking (useful for accelerator keys); <a href="ntqrangecontrol.html#setSteps">setSteps</a>() to define the
|
||
|
|
values of <a href="#pageStep">pageStep</a>() and <a href="#lineStep">lineStep</a>(); and <a href="ntqrangecontrol.html#setRange">setRange</a>() to set the
|
||
|
13 years ago
|
<a href="#minValue">minValue</a>() and <a href="#maxValue">maxValue</a>() of the scroll bar. TQScrollBar has a
|
||
|
|
convenience constructor with which you can set most of these
|
||
|
|
properties.
|
||
|
|
<p> Some GUI styles (for example, the Windows and <a href="motif-extension.html#Motif">Motif</a> styles
|
||
|
|
provided with TQt), also use the pageStep() value to calculate the
|
||
|
|
size of the slider.
|
||
|
13 years ago
|
<p> In addition to the access functions from <a href="ntqrangecontrol.html">TQRangeControl</a>, TQScrollBar
|
||
|
13 years ago
|
provides a comprehensive set of signals:
|
||
|
|
<center><table cellpadding="4" cellspacing="2" border="0">
|
||
|
|
<tr bgcolor="#a2c511"> <th valign="top">Signal <th valign="top">Emitted when
|
||
|
|
<tr bgcolor="#f0f0f0"> <td valign="top"><a href="#valueChanged">valueChanged</a>()
|
||
|
|
<td valign="top">the scroll bar's value has changed. The <a href="#tracking">tracking</a>()
|
||
|
|
determines whether this signal is emitted during user
|
||
|
|
interaction.
|
||
|
|
<tr bgcolor="#d0d0d0"> <td valign="top"><a href="#sliderPressed">sliderPressed</a>()
|
||
|
|
<td valign="top">the user starts to drag the slider.
|
||
|
|
<tr bgcolor="#f0f0f0"> <td valign="top"><a href="#sliderMoved">sliderMoved</a>()
|
||
|
|
<td valign="top">the user drags the slider.
|
||
|
|
<tr bgcolor="#d0d0d0"> <td valign="top"><a href="#sliderReleased">sliderReleased</a>()
|
||
|
|
<td valign="top">the user releases the slider.
|
||
|
|
<tr bgcolor="#f0f0f0"> <td valign="top"><a href="#nextLine">nextLine</a>()
|
||
|
|
<td valign="top">the scroll bar has moved one line down or right. Line is
|
||
|
13 years ago
|
defined in <a href="ntqrangecontrol.html">TQRangeControl</a>.
|
||
|
13 years ago
|
<tr bgcolor="#d0d0d0"> <td valign="top"><a href="#prevLine">prevLine</a>()
|
||
|
|
<td valign="top">the scroll bar has moved one line up or left.
|
||
|
|
<tr bgcolor="#f0f0f0"> <td valign="top"><a href="#nextPage">nextPage</a>()
|
||
|
|
<td valign="top">the scroll bar has moved one page down or right.
|
||
|
|
<tr bgcolor="#d0d0d0"> <td valign="top"><a href="#prevPage">prevPage</a>()
|
||
|
|
<td valign="top">the scroll bar has moved one page up or left.
|
||
|
|
</table></center>
|
||
|
|
<p> TQScrollBar only provides integer ranges. Note that although
|
||
|
|
TQScrollBar handles very large numbers, scroll bars on current
|
||
|
|
screens cannot usefully control ranges above about 100,000 pixels.
|
||
|
|
Beyond that, it becomes difficult for the user to control the
|
||
|
|
scroll bar using either the keyboard or the mouse.
|
||
|
|
<p> A scroll bar can be controlled by the keyboard, but it has a
|
||
|
13 years ago
|
default <a href="ntqwidget.html#focusPolicy">focusPolicy</a>() of <a href="ntqwidget.html#FocusPolicy-enum">NoFocus</a>. Use <a href="ntqwidget.html#setFocusPolicy">setFocusPolicy</a>() to
|
||
|
|
enable <a href="focus.html#keyboard-focus">keyboard focus</a>. See <a href="ntqwidget.html#keyPressEvent">keyPressEvent</a>() for a list of key
|
||
|
13 years ago
|
bindings.
|
||
|
|
<p> If you need to add scroll bars to an interface, consider using the
|
||
|
13 years ago
|
<a href="ntqscrollview.html">TQScrollView</a> class, which encapsulates the common uses for scroll
|
||
|
13 years ago
|
bars.
|
||
|
|
<p> <img src=qscrbar-m.png> <img src=qscrbar-w.png>
|
||
|
13 years ago
|
<p> <p>See also <a href="ntqslider.html">TQSlider</a>, <a href="ntqspinbox.html">TQSpinBox</a>, <a href="ntqscrollview.html">TQScrollView</a>, <a href="guibooks.html#fowler">GUI Design Handbook: Scroll Bar</a>, and <a href="basic.html">Basic Widgets</a>.
|
||
|
13 years ago
|
|
||
|
|
<hr><h2>Member Function Documentation</h2>
|
||
|
13 years ago
|
<h3 class=fn><a name="TQScrollBar"></a>TQScrollBar::TQScrollBar ( <a href="ntqwidget.html">TQWidget</a> * parent, const char * name = 0 )
|
||
|
13 years ago
|
</h3>
|
||
|
|
Constructs a vertical scroll bar.
|
||
|
13 years ago
|
<p> The <em>parent</em> and <em>name</em> arguments are sent on to the <a href="ntqwidget.html">TQWidget</a>
|
||
|
13 years ago
|
constructor.
|
||
|
|
<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
|
||
|
|
<a href="#value-prop">value</a> of 0.
|
||
|
|
|
||
|
13 years ago
|
<h3 class=fn><a name="TQScrollBar-2"></a>TQScrollBar::TQScrollBar ( <a href="ntqt.html#Orientation-enum">Orientation</a> orientation, <a href="ntqwidget.html">TQWidget</a> * parent, const char * name = 0 )
|
||
|
13 years ago
|
</h3>
|
||
|
|
Constructs a scroll bar.
|
||
|
13 years ago
|
<p> The <em>orientation</em> must be <a href="ntqt.html#Orientation-enum">TQt::Vertical</a> or <a href="ntqt.html#Orientation-enum">TQt::Horizontal</a>.
|
||
|
|
<p> The <em>parent</em> and <em>name</em> arguments are sent on to the <a href="ntqwidget.html">TQWidget</a>
|
||
|
13 years ago
|
constructor.
|
||
|
|
<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
|
||
|
|
<a href="#value-prop">value</a> of 0.
|
||
|
|
|
||
|
13 years ago
|
<h3 class=fn><a name="TQScrollBar-3"></a>TQScrollBar::TQScrollBar ( int minValue, int maxValue, int lineStep, int pageStep, int value, <a href="ntqt.html#Orientation-enum">Orientation</a> orientation, <a href="ntqwidget.html">TQWidget</a> * parent, const char * name = 0 )
|
||
|
13 years ago
|
</h3>
|
||
|
|
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
|
||
|
|
initially <em>value</em> (which is guaranteed to be in range using
|
||
|
13 years ago
|
<a href="ntqrangecontrol.html#bound">bound</a>()).
|
||
|
|
<p> If <em>orientation</em> is <a href="ntqt.html#Orientation-enum">Vertical</a> the scroll bar is vertical and if
|
||
|
|
it is <a href="ntqt.html#Orientation-enum">Horizontal</a> the scroll bar is horizontal.
|
||
|
|
<p> The <em>parent</em> and <em>name</em> arguments are sent on to the <a href="ntqwidget.html">TQWidget</a>
|
||
|
13 years ago
|
constructor.
|
||
|
|
|
||
|
|
<h3 class=fn><a name="~TQScrollBar"></a>TQScrollBar::~TQScrollBar ()
|
||
|
|
</h3>
|
||
|
|
Destructor.
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="draggingSlider"></a>TQScrollBar::draggingSlider () const
|
||
|
|
</h3><p>Returns TRUE if the user has clicked the mouse on the slider and is currently dragging it; otherwise returns FALSE.
|
||
|
13 years ago
|
See the <a href="ntqscrollbar.html#draggingSlider-prop">"draggingSlider"</a> property for details.
|
||
|
13 years ago
|
<h3 class=fn>void <a name="hideEvent"></a>TQScrollBar::hideEvent ( <a href="qhideevent.html">TQHideEvent</a> * )<tt> [virtual protected]</tt>
|
||
|
|
</h3>
|
||
|
|
This function is called when the scrollbar is hidden.
|
||
|
|
|
||
|
13 years ago
|
<p>Reimplemented from <a href="ntqwidget.html#hideEvent">TQWidget</a>.
|
||
|
13 years ago
|
<h3 class=fn>int <a name="lineStep"></a>TQScrollBar::lineStep () const
|
||
|
|
</h3><p>Returns the line step.
|
||
|
13 years ago
|
See the <a href="ntqscrollbar.html#lineStep-prop">"lineStep"</a> property for details.
|
||
|
13 years ago
|
<h3 class=fn>int <a name="maxValue"></a>TQScrollBar::maxValue () const
|
||
|
|
</h3><p>Returns the scroll bar's maximum value.
|
||
|
13 years ago
|
See the <a href="ntqscrollbar.html#maxValue-prop">"maxValue"</a> property for details.
|
||
|
13 years ago
|
<h3 class=fn>int <a name="minValue"></a>TQScrollBar::minValue () const
|
||
|
|
</h3><p>Returns the scroll bar's minimum value.
|
||
|
13 years ago
|
See the <a href="ntqscrollbar.html#minValue-prop">"minValue"</a> property for details.
|
||
|
13 years ago
|
<h3 class=fn>void <a name="nextLine"></a>TQScrollBar::nextLine ()<tt> [signal]</tt>
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This signal is emitted when the scroll bar scrolls one line down
|
||
|
|
or right.
|
||
|
|
|
||
|
|
<h3 class=fn>void <a name="nextPage"></a>TQScrollBar::nextPage ()<tt> [signal]</tt>
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This signal is emitted when the scroll bar scrolls one page down
|
||
|
|
or right.
|
||
|
|
|
||
|
13 years ago
|
<h3 class=fn><a href="ntqt.html#Orientation-enum">Orientation</a> <a name="orientation"></a>TQScrollBar::orientation () const
|
||
|
13 years ago
|
</h3><p>Returns the orientation of the scroll bar.
|
||
|
13 years ago
|
See the <a href="ntqscrollbar.html#orientation-prop">"orientation"</a> property for details.
|
||
|
13 years ago
|
<h3 class=fn>int <a name="pageStep"></a>TQScrollBar::pageStep () const
|
||
|
|
</h3><p>Returns the page step.
|
||
|
13 years ago
|
See the <a href="ntqscrollbar.html#pageStep-prop">"pageStep"</a> property for details.
|
||
|
13 years ago
|
<h3 class=fn>void <a name="prevLine"></a>TQScrollBar::prevLine ()<tt> [signal]</tt>
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This signal is emitted when the scroll bar scrolls one line up or
|
||
|
|
left.
|
||
|
|
|
||
|
|
<h3 class=fn>void <a name="prevPage"></a>TQScrollBar::prevPage ()<tt> [signal]</tt>
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This signal is emitted when the scroll bar scrolls one page up or
|
||
|
|
left.
|
||
|
|
|
||
|
|
<h3 class=fn>void <a name="setLineStep"></a>TQScrollBar::setLineStep ( int )
|
||
|
|
</h3><p>Sets the line step.
|
||
|
13 years ago
|
See the <a href="ntqscrollbar.html#lineStep-prop">"lineStep"</a> property for details.
|
||
|
13 years ago
|
<h3 class=fn>void <a name="setMaxValue"></a>TQScrollBar::setMaxValue ( int )
|
||
|
|
</h3><p>Sets the scroll bar's maximum value.
|
||
|
13 years ago
|
See the <a href="ntqscrollbar.html#maxValue-prop">"maxValue"</a> property for details.
|
||
|
13 years ago
|
<h3 class=fn>void <a name="setMinValue"></a>TQScrollBar::setMinValue ( int )
|
||
|
|
</h3><p>Sets the scroll bar's minimum value.
|
||
|
13 years ago
|
See the <a href="ntqscrollbar.html#minValue-prop">"minValue"</a> property for details.
|
||
|
|
<h3 class=fn>void <a name="setOrientation"></a>TQScrollBar::setOrientation ( <a href="ntqt.html#Orientation-enum">Orientation</a> )<tt> [virtual]</tt>
|
||
|
13 years ago
|
</h3><p>Sets the orientation of the scroll bar.
|
||
|
13 years ago
|
See the <a href="ntqscrollbar.html#orientation-prop">"orientation"</a> property for details.
|
||
|
13 years ago
|
<h3 class=fn>void <a name="setPageStep"></a>TQScrollBar::setPageStep ( int )
|
||
|
|
</h3><p>Sets the page step.
|
||
|
13 years ago
|
See the <a href="ntqscrollbar.html#pageStep-prop">"pageStep"</a> property for details.
|
||
|
|
<h3 class=fn>void <a name="setPalette"></a>TQScrollBar::setPalette ( const <a href="ntqpalette.html">TQPalette</a> & p )<tt> [virtual]</tt>
|
||
|
13 years ago
|
</h3>
|
||
|
13 years ago
|
Reimplements the virtual function <a href="ntqwidget.html#setPalette">TQWidget::setPalette</a>().
|
||
|
13 years ago
|
<p> Sets the background color to the mid color for <a href="motif-extension.html#Motif">Motif</a> style scroll
|
||
|
|
bars using palette <em>p</em>.
|
||
|
|
|
||
|
13 years ago
|
<p>Reimplemented from <a href="ntqwidget.html#setPalette">TQWidget</a>.
|
||
|
13 years ago
|
<h3 class=fn>void <a name="setTracking"></a>TQScrollBar::setTracking ( bool enable )<tt> [virtual]</tt>
|
||
|
|
</h3><p>Sets whether scroll bar tracking is enabled to <em>enable</em>.
|
||
|
13 years ago
|
See the <a href="ntqscrollbar.html#tracking-prop">"tracking"</a> property for details.
|
||
|
13 years ago
|
<h3 class=fn>void <a name="setValue"></a>TQScrollBar::setValue ( int )<tt> [slot]</tt>
|
||
|
|
</h3><p>Sets the scroll bar's value.
|
||
|
13 years ago
|
See the <a href="ntqscrollbar.html#value-prop">"value"</a> property for details.
|
||
|
13 years ago
|
<h3 class=fn>void <a name="sliderMoved"></a>TQScrollBar::sliderMoved ( int value )<tt> [signal]</tt>
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This signal is emitted when the slider is dragged by the user, with
|
||
|
|
the new scroll bar <em>value</em> as an argument.
|
||
|
|
<p> This signal is emitted even when tracking is turned off.
|
||
|
|
<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>().
|
||
|
|
|
||
|
|
<h3 class=fn>void <a name="sliderPressed"></a>TQScrollBar::sliderPressed ()<tt> [signal]</tt>
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This signal is emitted when the user presses the slider with the
|
||
|
|
mouse.
|
||
|
|
|
||
|
13 years ago
|
<h3 class=fn><a href="ntqrect.html">TQRect</a> <a name="sliderRect"></a>TQScrollBar::sliderRect () const
|
||
|
13 years ago
|
</h3>
|
||
|
|
Returns the scroll bar slider rectangle.
|
||
|
|
<p> <p>See also <a href="#sliderStart">sliderStart</a>().
|
||
|
|
|
||
|
|
<h3 class=fn>void <a name="sliderReleased"></a>TQScrollBar::sliderReleased ()<tt> [signal]</tt>
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This signal is emitted when the user releases the slider with the
|
||
|
|
mouse.
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="sliderStart"></a>TQScrollBar::sliderStart () const
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> Returns the pixel position where the scroll bar slider starts.
|
||
|
13 years ago
|
<p> This is equivalent to <a href="#sliderRect">sliderRect</a>().<a href="ntqwidget.html#y">y</a>() for vertical scroll bars or
|
||
|
|
sliderRect().<a href="ntqwidget.html#x">x</a>() for horizontal scroll bars.
|
||
|
13 years ago
|
|
||
|
|
<h3 class=fn>bool <a name="tracking"></a>TQScrollBar::tracking () const
|
||
|
|
</h3><p>Returns TRUE if scroll bar tracking is enabled; otherwise returns FALSE.
|
||
|
13 years ago
|
See the <a href="ntqscrollbar.html#tracking-prop">"tracking"</a> property for details.
|
||
|
13 years ago
|
<h3 class=fn>int <a name="value"></a>TQScrollBar::value () const
|
||
|
|
</h3><p>Returns the scroll bar's value.
|
||
|
13 years ago
|
See the <a href="ntqscrollbar.html#value-prop">"value"</a> property for details.
|
||
|
13 years ago
|
<h3 class=fn>void <a name="valueChanged"></a>TQScrollBar::valueChanged ( int value )<tt> [signal]</tt>
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This signal is emitted when the scroll bar value has changed, with
|
||
|
|
the new scroll bar <em>value</em> as an argument.
|
||
|
|
|
||
|
|
<hr><h2>Property Documentation</h2>
|
||
|
|
<h3 class=fn>bool <a name="draggingSlider-prop"></a>draggingSlider</h3>
|
||
|
|
<p>This property holds whether the user has clicked the mouse on the slider and is currently dragging it.
|
||
|
|
<p>
|
||
|
|
<p>Get this property's value with <a href="#draggingSlider">draggingSlider</a>().
|
||
|
|
<h3 class=fn>int <a name="lineStep-prop"></a>lineStep</h3>
|
||
|
|
<p>This property holds the line step.
|
||
|
13 years ago
|
<p>When setting lineStep, the virtual <a href="ntqrangecontrol.html#stepChange">stepChange</a>() function will be
|
||
|
13 years ago
|
called if the new line step is different from the previous
|
||
|
|
setting.
|
||
|
13 years ago
|
<p> <p>See also <a href="ntqrangecontrol.html#setSteps">setSteps</a>(), <a href="ntqrangecontrol.html#pageStep">TQRangeControl::pageStep</a>(), and <a href="ntqrangecontrol.html#setRange">setRange</a>().
|
||
|
13 years ago
|
|
||
|
|
<p>Set this property's value with <a href="#setLineStep">setLineStep</a>() and get this property's value with <a href="#lineStep">lineStep</a>().
|
||
|
|
<h3 class=fn>int <a name="maxValue-prop"></a>maxValue</h3>
|
||
|
|
<p>This property holds the scroll bar's maximum value.
|
||
|
|
<p>When setting this property, the <a href="#minValue-prop">TQScrollBar::minValue</a> is
|
||
|
|
adjusted if necessary to ensure that the range remains valid.
|
||
|
13 years ago
|
<p> <p>See also <a href="ntqrangecontrol.html#setRange">setRange</a>().
|
||
|
13 years ago
|
|
||
|
|
<p>Set this property's value with <a href="#setMaxValue">setMaxValue</a>() and get this property's value with <a href="#maxValue">maxValue</a>().
|
||
|
|
<h3 class=fn>int <a name="minValue-prop"></a>minValue</h3>
|
||
|
|
<p>This property holds the scroll bar's minimum value.
|
||
|
|
<p>When setting this property, the <a href="#maxValue-prop">TQScrollBar::maxValue</a> is
|
||
|
|
adjusted if necessary to ensure that the range remains valid.
|
||
|
13 years ago
|
<p> <p>See also <a href="ntqrangecontrol.html#setRange">setRange</a>().
|
||
|
13 years ago
|
|
||
|
|
<p>Set this property's value with <a href="#setMinValue">setMinValue</a>() and get this property's value with <a href="#minValue">minValue</a>().
|
||
|
13 years ago
|
<h3 class=fn><a href="ntqt.html#Orientation-enum">Orientation</a> <a name="orientation-prop"></a>orientation</h3>
|
||
|
13 years ago
|
<p>This property holds the orientation of the scroll bar.
|
||
|
13 years ago
|
<p>The orientation must be <a href="ntqt.html#Orientation-enum">TQt::Vertical</a> (the default) or <a href="ntqt.html#Orientation-enum">TQt::Horizontal</a>.
|
||
|
13 years ago
|
|
||
|
|
<p>Set this property's value with <a href="#setOrientation">setOrientation</a>() and get this property's value with <a href="#orientation">orientation</a>().
|
||
|
|
<h3 class=fn>int <a name="pageStep-prop"></a>pageStep</h3>
|
||
|
|
<p>This property holds the page step.
|
||
|
13 years ago
|
<p>When setting pageStep, the virtual <a href="ntqrangecontrol.html#stepChange">stepChange</a>() function will be
|
||
|
13 years ago
|
called if the new page step is different from the previous
|
||
|
|
setting.
|
||
|
13 years ago
|
<p> <p>See also <a href="ntqrangecontrol.html#setSteps">TQRangeControl::setSteps</a>(), <a href="#lineStep-prop">lineStep</a>, and <a href="ntqrangecontrol.html#setRange">setRange</a>().
|
||
|
13 years ago
|
|
||
|
|
<p>Set this property's value with <a href="#setPageStep">setPageStep</a>() and get this property's value with <a href="#pageStep">pageStep</a>().
|
||
|
|
<h3 class=fn>bool <a name="tracking-prop"></a>tracking</h3>
|
||
|
|
<p>This property holds whether scroll bar tracking is enabled.
|
||
|
|
<p>If tracking is enabled (the default), the scroll bar emits the
|
||
|
|
<a href="#valueChanged">valueChanged</a>() signal while the slider is being dragged. If
|
||
|
|
tracking is disabled, the scroll bar emits the valueChanged()
|
||
|
|
signal only when the user releases the mouse button after moving
|
||
|
|
the slider.
|
||
|
|
|
||
|
|
<p>Set this property's value with <a href="#setTracking">setTracking</a>() and get this property's value with <a href="#tracking">tracking</a>().
|
||
|
|
<h3 class=fn>int <a name="value-prop"></a>value</h3>
|
||
|
|
<p>This property holds the scroll bar's value.
|
||
|
|
<p>Set this property's value with <a href="#setValue">setValue</a>() and get this property's value with <a href="#value">value</a>().
|
||
|
13 years ago
|
<p><p>See also <a href="ntqrangecontrol.html#value">TQRangeControl::value</a>() and <a href="ntqrangecontrol.html#prevValue">prevValue</a>().
|
||
|
13 years ago
|
|
||
|
|
<!-- eof -->
|
||
|
|
<hr><p>
|
||
|
|
This file is part of the <a href="index.html">TQt toolkit</a>.
|
||
|
|
Copyright © 1995-2007
|
||
|
|
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
|
||
|
|
<table width=100% cellspacing=0 border=0><tr>
|
||
|
|
<td>Copyright © 2007
|
||
|
|
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||
|
|
<td align=right><div align=right>TQt 3.3.8</div>
|
||
|
|
</table></div></address></body>
|
||
|
|
</html>
|