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.
562 lines
35 KiB
562 lines
35 KiB
14 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/qspinbox.cpp:129 -->
|
||
|
|
<html>
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||
|
|
<title>QSpinBox 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>QSpinBox Class Reference</h1>
|
||
|
|
|
||
|
|
<p>The QSpinBox class provides a spin box widget (spin button).
|
||
|
|
<a href="#details">More...</a>
|
||
|
|
<p><tt>#include <<a href="qspinbox-h.html">qspinbox.h</a>></tt>
|
||
|
|
<p>Inherits <a href="qwidget.html">QWidget</a> and <a href="qrangecontrol.html">QRangeControl</a>.
|
||
|
|
<p><a href="qspinbox-members.html">List of all member functions.</a>
|
||
|
|
<h2>Public Members</h2>
|
||
|
|
<ul>
|
||
|
|
<li class=fn><a href="#QSpinBox"><b>QSpinBox</b></a> ( QWidget * parent = 0, const char * name = 0 )</li>
|
||
|
|
<li class=fn><a href="#QSpinBox-2"><b>QSpinBox</b></a> ( int minValue, int maxValue, int step = 1, QWidget * parent = 0, const char * name = 0 )</li>
|
||
|
|
<li class=fn><a href="#~QSpinBox"><b>~QSpinBox</b></a> ()</li>
|
||
|
|
<li class=fn>QString <a href="#text"><b>text</b></a> () const</li>
|
||
|
|
<li class=fn>virtual QString <a href="#prefix"><b>prefix</b></a> () const</li>
|
||
|
|
<li class=fn>virtual QString <a href="#suffix"><b>suffix</b></a> () const</li>
|
||
|
|
<li class=fn>virtual QString <a href="#cleanText"><b>cleanText</b></a> () const</li>
|
||
|
|
<li class=fn>virtual void <a href="#setSpecialValueText"><b>setSpecialValueText</b></a> ( const QString & text )</li>
|
||
|
|
<li class=fn>QString <a href="#specialValueText"><b>specialValueText</b></a> () const</li>
|
||
|
|
<li class=fn>virtual void <a href="#setWrapping"><b>setWrapping</b></a> ( bool on )</li>
|
||
|
|
<li class=fn>bool <a href="#wrapping"><b>wrapping</b></a> () const</li>
|
||
|
|
<li class=fn>enum <a href="#ButtonSymbols-enum"><b>ButtonSymbols</b></a> { UpDownArrows, PlusMinus }</li>
|
||
|
|
<li class=fn>virtual void <a href="#setButtonSymbols"><b>setButtonSymbols</b></a> ( ButtonSymbols )</li>
|
||
|
|
<li class=fn>ButtonSymbols <a href="#buttonSymbols"><b>buttonSymbols</b></a> () const</li>
|
||
|
|
<li class=fn>virtual void <a href="#setValidator"><b>setValidator</b></a> ( const QValidator * v )</li>
|
||
|
|
<li class=fn>const QValidator * <a href="#validator"><b>validator</b></a> () const</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>void <a href="#setLineStep"><b>setLineStep</b></a> ( int )</li>
|
||
|
|
<li class=fn>int <a href="#value"><b>value</b></a> () const</li>
|
||
|
|
<li class=fn>QRect <a href="#upRect"><b>upRect</b></a> () const</li>
|
||
|
|
<li class=fn>QRect <a href="#downRect"><b>downRect</b></a> () const</li>
|
||
|
|
</ul>
|
||
|
|
<h2>Public Slots</h2>
|
||
|
|
<ul>
|
||
|
|
<li class=fn>virtual void <a href="#setValue"><b>setValue</b></a> ( int value )</li>
|
||
|
|
<li class=fn>virtual void <a href="#setPrefix"><b>setPrefix</b></a> ( const QString & text )</li>
|
||
|
|
<li class=fn>virtual void <a href="#setSuffix"><b>setSuffix</b></a> ( const QString & text )</li>
|
||
|
|
<li class=fn>virtual void <a href="#stepUp"><b>stepUp</b></a> ()</li>
|
||
|
|
<li class=fn>virtual void <a href="#stepDown"><b>stepDown</b></a> ()</li>
|
||
|
|
<li class=fn>virtual void <a href="#selectAll"><b>selectAll</b></a> ()</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="#valueChanged-2"><b>valueChanged</b></a> ( const QString & valueText )</li>
|
||
|
|
</ul>
|
||
|
|
<h2>Properties</h2>
|
||
|
|
<ul>
|
||
|
|
<li class=fn>ButtonSymbols <a href="#buttonSymbols-prop"><b>buttonSymbols</b></a> - the current button symbol mode</li>
|
||
|
|
<li class=fn>QString <a href="#cleanText-prop"><b>cleanText</b></a> - the spin box's text with no prefix(), suffix() or leading or trailing whitespace <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 maximum value of the spin box</li>
|
||
|
|
<li class=fn>int <a href="#minValue-prop"><b>minValue</b></a> - the minimum value of the spin box</li>
|
||
|
|
<li class=fn>QString <a href="#prefix-prop"><b>prefix</b></a> - the spin box's prefix</li>
|
||
|
|
<li class=fn>QString <a href="#specialValueText-prop"><b>specialValueText</b></a> - the special-value text</li>
|
||
|
|
<li class=fn>QString <a href="#suffix-prop"><b>suffix</b></a> - the suffix of the spin box</li>
|
||
|
|
<li class=fn>QString <a href="#text-prop"><b>text</b></a> - the spin box's text, including any prefix() and suffix() <em>(read only)</em></li>
|
||
|
|
<li class=fn>int <a href="#value-prop"><b>value</b></a> - the value of the spin box</li>
|
||
|
|
<li class=fn>bool <a href="#wrapping-prop"><b>wrapping</b></a> - whether it is possible to step the value from the highest value to the lowest value and vice versa</li>
|
||
|
|
</ul>
|
||
|
|
<h2>Protected Members</h2>
|
||
|
|
<ul>
|
||
|
|
<li class=fn>virtual QString <a href="#mapValueToText"><b>mapValueToText</b></a> ( int v )</li>
|
||
|
|
<li class=fn>virtual int <a href="#mapTextToValue"><b>mapTextToValue</b></a> ( bool * ok )</li>
|
||
|
|
<li class=fn>QString <a href="#currentValueText"><b>currentValueText</b></a> ()</li>
|
||
|
|
<li class=fn>virtual void <a href="#updateDisplay"><b>updateDisplay</b></a> ()</li>
|
||
|
|
<li class=fn>virtual void <a href="#interpretText"><b>interpretText</b></a> ()</li>
|
||
|
|
<li class=fn>QLineEdit * <a href="#editor"><b>editor</b></a> () const</li>
|
||
|
|
<li class=fn>virtual void <a href="#valueChange"><b>valueChange</b></a> ()</li>
|
||
|
|
<li class=fn>virtual void <a href="#rangeChange"><b>rangeChange</b></a> ()</li>
|
||
|
|
<li class=fn>virtual bool <a href="#eventFilter"><b>eventFilter</b></a> ( QObject * o, QEvent * ev )</li>
|
||
|
|
</ul>
|
||
|
|
<h2>Protected Slots</h2>
|
||
|
|
<ul>
|
||
|
|
<li class=fn>void <a href="#textChanged"><b>textChanged</b></a> ()</li>
|
||
|
|
</ul>
|
||
|
|
<hr><a name="details"></a><h2>Detailed Description</h2>
|
||
|
|
|
||
|
|
|
||
|
|
The QSpinBox class provides a spin box widget (spin button).
|
||
|
|
<p>
|
||
|
|
|
||
|
|
<p> QSpinBox allows the user to choose a value either by clicking the
|
||
|
|
up/down buttons to increase/decrease the value currently displayed
|
||
|
|
or by typing the value directly into the spin box. If the value is
|
||
|
|
entered directly into the spin box, Enter (or Return) must be
|
||
|
|
pressed to apply the new value. The value is usually an integer.
|
||
|
|
<p> Every time the value changes QSpinBox emits the <a href="#valueChanged">valueChanged</a>()
|
||
|
|
signal. The current value can be fetched with <a href="#value">value</a>() and set
|
||
|
|
with <a href="#setValue">setValue</a>().
|
||
|
|
<p> The spin box keeps the value within a numeric range, and to
|
||
|
|
multiples of the <a href="#lineStep">lineStep</a>() size (see <a href="qrangecontrol.html">QRangeControl</a> for details).
|
||
|
|
Clicking the up/down buttons or using the keyboard accelerator's
|
||
|
|
up and down arrows will increase or decrease the current value in
|
||
|
|
steps of size lineStep(). The minimum and maximum value and the
|
||
|
|
step size can be set using one of the constructors, and can be
|
||
|
|
changed later with <a href="#setMinValue">setMinValue</a>(), <a href="#setMaxValue">setMaxValue</a>() and <a href="#setLineStep">setLineStep</a>().
|
||
|
|
<p> Most spin boxes are directional, but QSpinBox can also operate as
|
||
|
|
a circular spin box, i.e. if the range is 0-99 and the current
|
||
|
|
value is 99, clicking "up" will give 0. Use <a href="#setWrapping">setWrapping</a>() if you
|
||
|
|
want circular behavior.
|
||
|
|
<p> The displayed value can be prepended and appended with arbitrary
|
||
|
|
strings indicating, for example, currency or the unit of
|
||
|
|
measurement. See <a href="#setPrefix">setPrefix</a>() and <a href="#setSuffix">setSuffix</a>(). The text in the spin
|
||
|
|
box is retrieved with <a href="#text">text</a>() (which includes any <a href="#prefix">prefix</a>() and
|
||
|
|
<a href="#suffix">suffix</a>()), or with <a href="#cleanText">cleanText</a>() (which has no prefix(), no suffix()
|
||
|
|
and no leading or trailing whitespace). <a href="#currentValueText">currentValueText</a>() returns
|
||
|
|
the spin box's current value as text.
|
||
|
|
<p> Normally the spin box displays up and down arrows in the buttons.
|
||
|
|
You can use <a href="#setButtonSymbols">setButtonSymbols</a>() to change the display to show
|
||
|
|
<b>+</b> and <b>-</b> symbols if you prefer. In either case the up
|
||
|
|
and down arrow keys work as expected.
|
||
|
|
<p> It is often desirable to give the user a special (often default)
|
||
|
|
choice in addition to the range of numeric values. See
|
||
|
|
<a href="#setSpecialValueText">setSpecialValueText</a>() for how to do this with QSpinBox.
|
||
|
|
<p> The default <a href="qwidget.html#focusPolicy">QWidget::focusPolicy</a>() is StrongFocus.
|
||
|
|
<p> If using prefix(), suffix() and <a href="#specialValueText">specialValueText</a>() don't provide
|
||
|
|
enough control, you can ignore them and subclass QSpinBox instead.
|
||
|
|
<p> QSpinBox can easily be subclassed to allow the user to input
|
||
|
|
things other than an integer value as long as the allowed input
|
||
|
|
can be mapped to a range of integers. This can be done by
|
||
|
|
overriding the virtual functions <a href="#mapValueToText">mapValueToText</a>() and
|
||
|
|
<a href="#mapTextToValue">mapTextToValue</a>(), and setting another suitable validator using
|
||
|
|
<a href="#setValidator">setValidator</a>().
|
||
|
|
<p> For example, these functions could be changed so that the user
|
||
|
|
provided values from 0.0 to 10.0, or -1 to signify 'Auto', while
|
||
|
|
the range of integers used inside the program would be -1 to 100:
|
||
|
|
<p> <pre>
|
||
|
|
class MySpinBox : public QSpinBox
|
||
|
|
{
|
||
|
|
Q_OBJECT
|
||
|
|
public:
|
||
|
|
...
|
||
|
|
|
||
|
|
<a href="qstring.html">QString</a> mapValueToText( int value )
|
||
|
|
{
|
||
|
|
if ( <a href="#value-prop">value</a> == -1 ) // special case
|
||
|
|
return QString( "Auto" );
|
||
|
|
|
||
|
|
return QString( "%1.%2" ) // 0.0 to 10.0
|
||
|
|
.arg( value / 10 ).arg( value % 10 );
|
||
|
|
}
|
||
|
|
|
||
|
|
int mapTextToValue( bool *ok )
|
||
|
|
{
|
||
|
|
if ( <a href="#text">text</a>() == "Auto" ) // special case
|
||
|
|
return -1;
|
||
|
|
|
||
|
|
return (int) ( 10 * text().toFloat() ); // 0 to 100
|
||
|
|
}
|
||
|
|
};
|
||
|
|
</pre>
|
||
|
|
|
||
|
|
<p> <img src=qspinbox-m.png> <img src=qspinbox-w.png>
|
||
|
|
<p> <p>See also <a href="qscrollbar.html">QScrollBar</a>, <a href="qslider.html">QSlider</a>, <a href="guibooks.html#fowler">GUI Design Handbook: Spin Box</a>, and <a href="basic.html">Basic Widgets</a>.
|
||
|
|
|
||
|
|
<hr><h2>Member Type Documentation</h2>
|
||
|
|
<h3 class=fn><a name="ButtonSymbols-enum"></a>QSpinBox::ButtonSymbols</h3>
|
||
|
|
|
||
|
|
<p> This enum type determines what the buttons in a spin box show.
|
||
|
|
<ul>
|
||
|
|
<li><tt>QSpinBox::UpDownArrows</tt> - the buttons show little arrows in the classic
|
||
|
|
style.
|
||
|
|
<li><tt>QSpinBox::PlusMinus</tt> - the buttons show <b>+</b> and <b>-</b> symbols.
|
||
|
|
</ul><p> <p>See also <a href="#buttonSymbols-prop">QSpinBox::buttonSymbols</a>.
|
||
|
|
|
||
|
|
<hr><h2>Member Function Documentation</h2>
|
||
|
|
<h3 class=fn><a name="QSpinBox"></a>QSpinBox::QSpinBox ( <a href="qwidget.html">QWidget</a> * parent = 0, const char * name = 0 )
|
||
|
|
</h3>
|
||
|
|
Constructs a spin box with the default <a href="qrangecontrol.html">QRangeControl</a> range and
|
||
|
|
step values. It is called <em>name</em> and has parent <em>parent</em>.
|
||
|
|
<p> <p>See also <a href="#minValue-prop">minValue</a>, <a href="#maxValue-prop">maxValue</a>, <a href="qrangecontrol.html#setRange">setRange</a>(), <a href="#lineStep-prop">lineStep</a>, and <a href="qrangecontrol.html#setSteps">setSteps</a>().
|
||
|
|
|
||
|
|
<h3 class=fn><a name="QSpinBox-2"></a>QSpinBox::QSpinBox ( int minValue, int maxValue, int step = 1, <a href="qwidget.html">QWidget</a> * parent = 0, const char * name = 0 )
|
||
|
|
</h3>
|
||
|
|
Constructs a spin box that allows values from <em>minValue</em> to <em>maxValue</em> inclusive, with step amount <em>step</em>. The value is
|
||
|
|
initially set to <em>minValue</em>.
|
||
|
|
<p> The spin box is called <em>name</em> and has parent <em>parent</em>.
|
||
|
|
<p> <p>See also <a href="#minValue-prop">minValue</a>, <a href="#maxValue-prop">maxValue</a>, <a href="qrangecontrol.html#setRange">setRange</a>(), <a href="#lineStep-prop">lineStep</a>, and <a href="qrangecontrol.html#setSteps">setSteps</a>().
|
||
|
|
|
||
|
|
<h3 class=fn><a name="~QSpinBox"></a>QSpinBox::~QSpinBox ()
|
||
|
|
</h3>
|
||
|
|
Destroys the spin box, freeing all memory and other resources.
|
||
|
|
|
||
|
|
<h3 class=fn><a href="qspinbox.html#ButtonSymbols-enum">ButtonSymbols</a> <a name="buttonSymbols"></a>QSpinBox::buttonSymbols () const
|
||
|
|
</h3><p>Returns the current button symbol mode.
|
||
|
|
See the <a href="qspinbox.html#buttonSymbols-prop">"buttonSymbols"</a> property for details.
|
||
|
|
<h3 class=fn><a href="qstring.html">QString</a> <a name="cleanText"></a>QSpinBox::cleanText () const<tt> [virtual]</tt>
|
||
|
|
</h3><p>Returns the spin box's text with no <a href="#prefix">prefix</a>(), <a href="#suffix">suffix</a>() or leading or trailing whitespace.
|
||
|
|
See the <a href="qspinbox.html#cleanText-prop">"cleanText"</a> property for details.
|
||
|
|
<h3 class=fn><a href="qstring.html">QString</a> <a name="currentValueText"></a>QSpinBox::currentValueText ()<tt> [protected]</tt>
|
||
|
|
</h3>
|
||
|
|
Returns the full text calculated from the current value, including
|
||
|
|
any prefix and suffix. If there is special value text and the
|
||
|
|
value is <a href="#minValue">minValue</a>() the <a href="#specialValueText">specialValueText</a>() is returned.
|
||
|
|
|
||
|
|
<h3 class=fn><a href="qrect.html">QRect</a> <a name="downRect"></a>QSpinBox::downRect () const
|
||
|
|
</h3>
|
||
|
|
Returns the geometry of the "down" button.
|
||
|
|
|
||
|
|
<h3 class=fn><a href="qlineedit.html">QLineEdit</a> * <a name="editor"></a>QSpinBox::editor () const<tt> [protected]</tt>
|
||
|
|
</h3>
|
||
|
|
Returns a pointer to the embedded <a href="qlineedit.html">QLineEdit</a>.
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="eventFilter"></a>QSpinBox::eventFilter ( <a href="qobject.html">QObject</a> * o, <a href="qevent.html">QEvent</a> * ev )<tt> [virtual protected]</tt>
|
||
|
|
</h3>
|
||
|
|
Intercepts and handles the events coming to the embedded <a href="qlineedit.html">QLineEdit</a>
|
||
|
|
that have special meaning for the QSpinBox. The object is passed
|
||
|
|
as <em>o</em> and the event is passed as <em>ev</em>.
|
||
|
|
|
||
|
|
<p>Reimplemented from <a href="qobject.html#eventFilter">QObject</a>.
|
||
|
|
<h3 class=fn>void <a name="interpretText"></a>QSpinBox::interpretText ()<tt> [virtual protected]</tt>
|
||
|
|
</h3>
|
||
|
|
QSpinBox calls this after the user has manually edited the
|
||
|
|
contents of the spin box (i.e. by typing in the embedded
|
||
|
|
<a href="qlineedit.html">QLineEdit</a>, rather than using the up/down buttons/keys).
|
||
|
|
<p> The default implementation of this function interprets the new
|
||
|
|
text using <a href="#mapTextToValue">mapTextToValue</a>(). If mapTextToValue() is successful, it
|
||
|
|
changes the spin box's value; if not, the value is left unchanged.
|
||
|
|
<p> <p>See also <a href="#editor">editor</a>().
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="lineStep"></a>QSpinBox::lineStep () const
|
||
|
|
</h3><p>Returns the line step.
|
||
|
|
See the <a href="qspinbox.html#lineStep-prop">"lineStep"</a> property for details.
|
||
|
|
<h3 class=fn>int <a name="mapTextToValue"></a>QSpinBox::mapTextToValue ( bool * ok )<tt> [virtual protected]</tt>
|
||
|
|
</h3>
|
||
|
|
This virtual function is used by the spin box whenever it needs to
|
||
|
|
interpret text entered by the user as a value. The text is
|
||
|
|
available as <a href="#text">text</a>() and as <a href="#cleanText">cleanText</a>(), and this function must
|
||
|
|
parse it if possible. If <em>ok</em> is not 0: if it parses the text
|
||
|
|
successfully, <em>*ok</em> is set to TRUE; otherwise <em>*ok</em> is set to
|
||
|
|
FALSE.
|
||
|
|
<p> Subclasses that need to display spin box values in a non-numeric
|
||
|
|
way need to reimplement this function.
|
||
|
|
<p> Note that Qt handles <a href="#specialValueText">specialValueText</a>() separately; this function
|
||
|
|
is only concerned with the other values.
|
||
|
|
<p> The default implementation tries to interpret the text() as an
|
||
|
|
integer in the standard way and returns the integer value.
|
||
|
|
<p> <p>See also <a href="#interpretText">interpretText</a>() and <a href="#mapValueToText">mapValueToText</a>().
|
||
|
|
|
||
|
|
<h3 class=fn><a href="qstring.html">QString</a> <a name="mapValueToText"></a>QSpinBox::mapValueToText ( int v )<tt> [virtual protected]</tt>
|
||
|
|
</h3>
|
||
|
|
This virtual function is used by the spin box whenever it needs to
|
||
|
|
display value <em>v</em>. The default implementation returns a string
|
||
|
|
containing <em>v</em> printed in the standard way. Reimplementations may
|
||
|
|
return anything. (See the example in the detailed description.)
|
||
|
|
<p> Note that Qt does not call this function for <a href="#specialValueText">specialValueText</a>()
|
||
|
|
and that neither <a href="#prefix">prefix</a>() nor <a href="#suffix">suffix</a>() are included in the return
|
||
|
|
value.
|
||
|
|
<p> If you reimplement this, you may also need to reimplement
|
||
|
|
<a href="#mapTextToValue">mapTextToValue</a>().
|
||
|
|
<p> <p>See also <a href="#updateDisplay">updateDisplay</a>() and <a href="#mapTextToValue">mapTextToValue</a>().
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="maxValue"></a>QSpinBox::maxValue () const
|
||
|
|
</h3><p>Returns the maximum value of the spin box.
|
||
|
|
See the <a href="qspinbox.html#maxValue-prop">"maxValue"</a> property for details.
|
||
|
|
<h3 class=fn>int <a name="minValue"></a>QSpinBox::minValue () const
|
||
|
|
</h3><p>Returns the minimum value of the spin box.
|
||
|
|
See the <a href="qspinbox.html#minValue-prop">"minValue"</a> property for details.
|
||
|
|
<h3 class=fn><a href="qstring.html">QString</a> <a name="prefix"></a>QSpinBox::prefix () const<tt> [virtual]</tt>
|
||
|
|
</h3><p>Returns the spin box's prefix.
|
||
|
|
See the <a href="qspinbox.html#prefix-prop">"prefix"</a> property for details.
|
||
|
|
<h3 class=fn>void <a name="rangeChange"></a>QSpinBox::rangeChange ()<tt> [virtual protected]</tt>
|
||
|
|
</h3>
|
||
|
|
This virtual function is called by <a href="qrangecontrol.html">QRangeControl</a> whenever the
|
||
|
|
range has changed. It adjusts the default validator and updates
|
||
|
|
the display; if you need additional processing, you can
|
||
|
|
reimplement this function.
|
||
|
|
|
||
|
|
<p>Reimplemented from <a href="qrangecontrol.html#rangeChange">QRangeControl</a>.
|
||
|
|
<h3 class=fn>void <a name="selectAll"></a>QSpinBox::selectAll ()<tt> [virtual slot]</tt>
|
||
|
|
</h3>
|
||
|
|
Selects all the text in the spin box's editor.
|
||
|
|
|
||
|
|
<h3 class=fn>void <a name="setButtonSymbols"></a>QSpinBox::setButtonSymbols ( <a href="qspinbox.html#ButtonSymbols-enum">ButtonSymbols</a> )<tt> [virtual]</tt>
|
||
|
|
</h3><p>Sets the current button symbol mode.
|
||
|
|
See the <a href="qspinbox.html#buttonSymbols-prop">"buttonSymbols"</a> property for details.
|
||
|
|
<h3 class=fn>void <a name="setLineStep"></a>QSpinBox::setLineStep ( int )
|
||
|
|
</h3><p>Sets the line step.
|
||
|
|
See the <a href="qspinbox.html#lineStep-prop">"lineStep"</a> property for details.
|
||
|
|
<h3 class=fn>void <a name="setMaxValue"></a>QSpinBox::setMaxValue ( int )
|
||
|
|
</h3><p>Sets the maximum value of the spin box.
|
||
|
|
See the <a href="qspinbox.html#maxValue-prop">"maxValue"</a> property for details.
|
||
|
|
<h3 class=fn>void <a name="setMinValue"></a>QSpinBox::setMinValue ( int )
|
||
|
|
</h3><p>Sets the minimum value of the spin box.
|
||
|
|
See the <a href="qspinbox.html#minValue-prop">"minValue"</a> property for details.
|
||
|
|
<h3 class=fn>void <a name="setPrefix"></a>QSpinBox::setPrefix ( const <a href="qstring.html">QString</a> & text )<tt> [virtual slot]</tt>
|
||
|
|
</h3><p>Sets the spin box's prefix to <em>text</em>.
|
||
|
|
See the <a href="qspinbox.html#prefix-prop">"prefix"</a> property for details.
|
||
|
|
<h3 class=fn>void <a name="setSpecialValueText"></a>QSpinBox::setSpecialValueText ( const <a href="qstring.html">QString</a> & text )<tt> [virtual]</tt>
|
||
|
|
</h3><p>Sets the special-value text to <em>text</em>.
|
||
|
|
See the <a href="qspinbox.html#specialValueText-prop">"specialValueText"</a> property for details.
|
||
|
|
<h3 class=fn>void <a name="setSuffix"></a>QSpinBox::setSuffix ( const <a href="qstring.html">QString</a> & text )<tt> [virtual slot]</tt>
|
||
|
|
</h3><p>Sets the suffix of the spin box to <em>text</em>.
|
||
|
|
See the <a href="qspinbox.html#suffix-prop">"suffix"</a> property for details.
|
||
|
|
<h3 class=fn>void <a name="setValidator"></a>QSpinBox::setValidator ( const <a href="qvalidator.html">QValidator</a> * v )<tt> [virtual]</tt>
|
||
|
|
</h3>
|
||
|
|
Sets the validator to <em>v</em>. The validator controls what keyboard
|
||
|
|
input is accepted when the user is editing in the value field. The
|
||
|
|
default is to use a suitable <a href="qintvalidator.html">QIntValidator</a>.
|
||
|
|
<p> Use <a href="#setValidator">setValidator</a>(0) to turn off input validation (entered input
|
||
|
|
will still be kept within the spin box's range).
|
||
|
|
|
||
|
|
<h3 class=fn>void <a name="setValue"></a>QSpinBox::setValue ( int value )<tt> [virtual slot]</tt>
|
||
|
|
</h3><p>Sets the value of the spin box to <em>value</em>.
|
||
|
|
See the <a href="qspinbox.html#value-prop">"value"</a> property for details.
|
||
|
|
<h3 class=fn>void <a name="setWrapping"></a>QSpinBox::setWrapping ( bool on )<tt> [virtual]</tt>
|
||
|
|
</h3><p>Sets whether it is possible to step the value from the highest value to the lowest value and vice versa to <em>on</em>.
|
||
|
|
See the <a href="qspinbox.html#wrapping-prop">"wrapping"</a> property for details.
|
||
|
|
<h3 class=fn><a href="qstring.html">QString</a> <a name="specialValueText"></a>QSpinBox::specialValueText () const
|
||
|
|
</h3><p>Returns the special-value text.
|
||
|
|
See the <a href="qspinbox.html#specialValueText-prop">"specialValueText"</a> property for details.
|
||
|
|
<h3 class=fn>void <a name="stepDown"></a>QSpinBox::stepDown ()<tt> [virtual slot]</tt>
|
||
|
|
</h3>
|
||
|
|
Decreases the spin box's value one <a href="#lineStep">lineStep</a>(), wrapping as
|
||
|
|
necessary if <a href="#wrapping">wrapping</a>() is TRUE. This is the same as clicking on
|
||
|
|
the pointing-down button and can be used for keyboard
|
||
|
|
accelerators, for example.
|
||
|
|
<p> <p>See also <a href="#stepUp">stepUp</a>(), <a href="qrangecontrol.html#subtractLine">subtractLine</a>(), <a href="#lineStep-prop">lineStep</a>, <a href="qrangecontrol.html#setSteps">setSteps</a>(), <a href="#value-prop">value</a>, and <a href="#value-prop">value</a>.
|
||
|
|
|
||
|
|
<h3 class=fn>void <a name="stepUp"></a>QSpinBox::stepUp ()<tt> [virtual slot]</tt>
|
||
|
|
</h3>
|
||
|
|
Increases the spin box's value by one <a href="#lineStep">lineStep</a>(), wrapping as
|
||
|
|
necessary if <a href="#wrapping">wrapping</a>() is TRUE. This is the same as clicking on
|
||
|
|
the pointing-up button and can be used for keyboard accelerators,
|
||
|
|
for example.
|
||
|
|
<p> <p>See also <a href="#stepDown">stepDown</a>(), <a href="qrangecontrol.html#addLine">addLine</a>(), <a href="#lineStep-prop">lineStep</a>, <a href="qrangecontrol.html#setSteps">setSteps</a>(), <a href="#value-prop">value</a>, and <a href="#value-prop">value</a>.
|
||
|
|
|
||
|
|
<h3 class=fn><a href="qstring.html">QString</a> <a name="suffix"></a>QSpinBox::suffix () const<tt> [virtual]</tt>
|
||
|
|
</h3><p>Returns the suffix of the spin box.
|
||
|
|
See the <a href="qspinbox.html#suffix-prop">"suffix"</a> property for details.
|
||
|
|
<h3 class=fn><a href="qstring.html">QString</a> <a name="text"></a>QSpinBox::text () const
|
||
|
|
</h3><p>Returns the spin box's text, including any <a href="#prefix">prefix</a>() and <a href="#suffix">suffix</a>().
|
||
|
|
See the <a href="qspinbox.html#text-prop">"text"</a> property for details.
|
||
|
|
<h3 class=fn>void <a name="textChanged"></a>QSpinBox::textChanged ()<tt> [protected slot]</tt>
|
||
|
|
</h3>
|
||
|
|
This slot is called whenever the user edits the spin box's text.
|
||
|
|
|
||
|
|
<h3 class=fn><a href="qrect.html">QRect</a> <a name="upRect"></a>QSpinBox::upRect () const
|
||
|
|
</h3>
|
||
|
|
Returns the geometry of the "up" button.
|
||
|
|
|
||
|
|
<h3 class=fn>void <a name="updateDisplay"></a>QSpinBox::updateDisplay ()<tt> [virtual protected]</tt>
|
||
|
|
</h3>
|
||
|
|
Updates the contents of the embedded <a href="qlineedit.html">QLineEdit</a> to reflect the
|
||
|
|
current value using <a href="#mapValueToText">mapValueToText</a>(). Also enables/disables the
|
||
|
|
up/down push buttons accordingly.
|
||
|
|
<p> <p>See also <a href="#mapValueToText">mapValueToText</a>().
|
||
|
|
|
||
|
|
<h3 class=fn>const <a href="qvalidator.html">QValidator</a> * <a name="validator"></a>QSpinBox::validator () const
|
||
|
|
</h3>
|
||
|
|
Returns the validator that constrains editing for this spin box if
|
||
|
|
there is any; otherwise returns 0.
|
||
|
|
<p> <p>See also <a href="#setValidator">setValidator</a>() and <a href="qvalidator.html">QValidator</a>.
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="value"></a>QSpinBox::value () const
|
||
|
|
</h3><p>Returns the value of the spin box.
|
||
|
|
See the <a href="qspinbox.html#value-prop">"value"</a> property for details.
|
||
|
|
<h3 class=fn>void <a name="valueChange"></a>QSpinBox::valueChange ()<tt> [virtual protected]</tt>
|
||
|
|
</h3>
|
||
|
|
This virtual function is called by <a href="qrangecontrol.html">QRangeControl</a> whenever the
|
||
|
|
value has changed. The QSpinBox reimplementation updates the
|
||
|
|
display and emits the <a href="#valueChanged">valueChanged</a>() signals; if you need
|
||
|
|
additional processing, either reimplement this or connect to one
|
||
|
|
of the valueChanged() signals.
|
||
|
|
|
||
|
|
<p>Reimplemented from <a href="qrangecontrol.html#valueChange">QRangeControl</a>.
|
||
|
|
<h3 class=fn>void <a name="valueChanged"></a>QSpinBox::valueChanged ( int value )<tt> [signal]</tt>
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This signal is emitted every time the value of the spin box
|
||
|
|
changes; the new value is passed in <em>value</em>. This signal will be
|
||
|
|
emitted as a result of a call to <a href="#setValue">setValue</a>(), or because the user
|
||
|
|
changed the value by using a keyboard accelerator or mouse click,
|
||
|
|
etc.
|
||
|
|
<p> Note that the <a href="#valueChanged">valueChanged</a>() signal is emitted <em>every</em> time, not
|
||
|
|
just for the "last" step; i.e. if the user clicks "up" three
|
||
|
|
times, this signal is emitted three times.
|
||
|
|
<p> <p>See also <a href="#value-prop">value</a>.
|
||
|
|
|
||
|
|
<p>Examples: <a href="listbox-example.html#x1445">listbox/listbox.cpp</a>, <a href="qfd-example.html#x2009">qfd/fontdisplayer.cpp</a>, and <a href="scribble-example.html#x939">scribble/scribble.cpp</a>.
|
||
|
|
<h3 class=fn>void <a name="valueChanged-2"></a>QSpinBox::valueChanged ( const <a href="qstring.html">QString</a> & valueText )<tt> [signal]</tt>
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||
|
|
<p> This signal is emitted whenever the <a href="#valueChanged">valueChanged</a>( int ) signal is
|
||
|
|
emitted, i.e. every time the value of the spin box changes
|
||
|
|
(whatever the cause, e.g. by <a href="#setValue">setValue</a>(), by a keyboard
|
||
|
|
accelerator, by mouse clicks, etc.).
|
||
|
|
<p> The <em>valueText</em> parameter is the same string that is displayed in
|
||
|
|
the edit field of the spin box.
|
||
|
|
<p> <p>See also <a href="#value-prop">value</a>, <a href="#prefix-prop">prefix</a>, <a href="#suffix-prop">suffix</a>, and <a href="#specialValueText-prop">specialValueText</a>.
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="wrapping"></a>QSpinBox::wrapping () const
|
||
|
|
</h3><p>Returns TRUE if it is possible to step the value from the highest value to the lowest value and vice versa; otherwise returns FALSE.
|
||
|
|
See the <a href="qspinbox.html#wrapping-prop">"wrapping"</a> property for details.
|
||
|
|
<hr><h2>Property Documentation</h2>
|
||
|
|
<h3 class=fn><a href="qspinbox.html#ButtonSymbols-enum">ButtonSymbols</a> <a name="buttonSymbols-prop"></a>buttonSymbols</h3>
|
||
|
|
<p>This property holds the current button symbol mode.
|
||
|
|
<p>The possible values can be either <a href="#ButtonSymbols-enum">UpDownArrows</a> or <a href="#ButtonSymbols-enum">PlusMinus</a>.
|
||
|
|
The default is <a href="#ButtonSymbols-enum">UpDownArrows</a>.
|
||
|
|
<p> <p>See also <a href="#ButtonSymbols-enum">ButtonSymbols</a>.
|
||
|
|
|
||
|
|
<p>Set this property's value with <a href="#setButtonSymbols">setButtonSymbols</a>() and get this property's value with <a href="#buttonSymbols">buttonSymbols</a>().
|
||
|
|
<h3 class=fn><a href="qstring.html">QString</a> <a name="cleanText-prop"></a>cleanText</h3>
|
||
|
|
<p>This property holds the spin box's text with no <a href="#prefix">prefix</a>(), <a href="#suffix">suffix</a>() or leading or trailing whitespace.
|
||
|
|
<p>Get this property's value with <a href="#cleanText">cleanText</a>().
|
||
|
|
<p><p>See also <a href="#text-prop">text</a>, <a href="#prefix-prop">prefix</a>, and <a href="#suffix-prop">suffix</a>.
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="lineStep-prop"></a>lineStep</h3>
|
||
|
|
<p>This property holds the line step.
|
||
|
|
<p>When the user uses the arrows to change the spin box's value the
|
||
|
|
value will be incremented/decremented by the amount of the line
|
||
|
|
step.
|
||
|
|
<p> The <a href="#setLineStep">setLineStep</a>() function calls the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function
|
||
|
|
if the new line step is different from the previous setting.
|
||
|
|
<p> <p>See also <a href="qrangecontrol.html#setSteps">QRangeControl::setSteps</a>() and <a href="qrangecontrol.html#setRange">setRange</a>().
|
||
|
|
|
||
|
|
<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 maximum value of the spin box.
|
||
|
|
<p>When setting this property, <a href="#minValue-prop">QSpinBox::minValue</a> is adjusted, if
|
||
|
|
necessary, to ensure that the range remains valid.
|
||
|
|
<p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>() and <a href="#specialValueText-prop">specialValueText</a>.
|
||
|
|
|
||
|
|
<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 minimum value of the spin box.
|
||
|
|
<p>When setting this property, <a href="#maxValue-prop">QSpinBox::maxValue</a> is adjusted, if
|
||
|
|
necessary, to ensure that the range remains valid.
|
||
|
|
<p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>() and <a href="#specialValueText-prop">specialValueText</a>.
|
||
|
|
|
||
|
|
<p>Set this property's value with <a href="#setMinValue">setMinValue</a>() and get this property's value with <a href="#minValue">minValue</a>().
|
||
|
|
<h3 class=fn><a href="qstring.html">QString</a> <a name="prefix-prop"></a>prefix</h3>
|
||
|
|
<p>This property holds the spin box's prefix.
|
||
|
|
<p>The prefix is prepended to the start of the displayed value.
|
||
|
|
Typical use is to display a unit of measurement or a currency
|
||
|
|
symbol. For example:
|
||
|
|
<p> <pre>
|
||
|
|
sb->setPrefix( "$" );
|
||
|
|
</pre>
|
||
|
|
|
||
|
|
<p> To turn off the prefix display, set this property to an empty
|
||
|
|
string. The default is no prefix. The prefix is not displayed for
|
||
|
|
the <a href="#minValue">minValue</a>() if <a href="#specialValueText">specialValueText</a>() is not empty.
|
||
|
|
<p> If no prefix is set, <a href="#prefix">prefix</a>() returns <a href="qstring.html#QString-null">QString::null</a>.
|
||
|
|
<p> <p>See also <a href="#suffix-prop">suffix</a>.
|
||
|
|
|
||
|
|
<p>Set this property's value with <a href="#setPrefix">setPrefix</a>() and get this property's value with <a href="#prefix">prefix</a>().
|
||
|
|
<h3 class=fn><a href="qstring.html">QString</a> <a name="specialValueText-prop"></a>specialValueText</h3>
|
||
|
|
<p>This property holds the special-value text.
|
||
|
|
<p>If set, the spin box will display this text instead of a numeric
|
||
|
|
value whenever the current value is equal to minVal(). Typical use
|
||
|
|
is to indicate that this choice has a special (default) meaning.
|
||
|
|
<p> For example, if your spin box allows the user to choose the margin
|
||
|
|
width in a print dialog and your application is able to
|
||
|
|
automatically choose a good margin width, you can set up the spin
|
||
|
|
box like this:
|
||
|
|
<pre>
|
||
|
|
QSpinBox marginBox( -1, 20, 1, parent, "marginBox" );
|
||
|
|
marginBox-><a href="#setSuffix">setSuffix</a>( " mm" );
|
||
|
|
marginBox-><a href="#setSpecialValueText">setSpecialValueText</a>( "Auto" );
|
||
|
|
</pre>
|
||
|
|
|
||
|
|
The user will then be able to choose a margin width from 0-20
|
||
|
|
millimeters or select "Auto" to leave it to the application to
|
||
|
|
choose. Your code must then interpret the spin box value of -1 as
|
||
|
|
the user requesting automatic margin width.
|
||
|
|
<p> All values are displayed with the <a href="#prefix">prefix</a>() and <a href="#suffix">suffix</a>() (if set),
|
||
|
|
<em>except</em> for the special value, which only shows the special
|
||
|
|
value text.
|
||
|
|
<p> To turn off the special-value text display, call this function
|
||
|
|
with an empty string. The default is no special-value text, i.e.
|
||
|
|
the numeric value is shown as usual.
|
||
|
|
<p> If no special-value text is set, <a href="#specialValueText">specialValueText</a>() returns
|
||
|
|
<a href="qstring.html#QString-null">QString::null</a>.
|
||
|
|
|
||
|
|
<p>Set this property's value with <a href="#setSpecialValueText">setSpecialValueText</a>() and get this property's value with <a href="#specialValueText">specialValueText</a>().
|
||
|
|
<h3 class=fn><a href="qstring.html">QString</a> <a name="suffix-prop"></a>suffix</h3>
|
||
|
|
<p>This property holds the suffix of the spin box.
|
||
|
|
<p>The suffix is appended to the end of the displayed value. Typical
|
||
|
|
use is to display a unit of measurement or a currency symbol. For
|
||
|
|
example:
|
||
|
|
<p> <pre>
|
||
|
|
sb->setSuffix( " km" );
|
||
|
|
</pre>
|
||
|
|
|
||
|
|
<p> To turn off the suffix display, set this property to an empty
|
||
|
|
string. The default is no suffix. The suffix is not displayed for
|
||
|
|
the <a href="#minValue">minValue</a>() if <a href="#specialValueText">specialValueText</a>() is not empty.
|
||
|
|
<p> If no suffix is set, <a href="#suffix">suffix</a>() returns a <a href="qstring.html#QString-null">QString::null</a>.
|
||
|
|
<p> <p>See also <a href="#prefix-prop">prefix</a>.
|
||
|
|
|
||
|
|
<p>Set this property's value with <a href="#setSuffix">setSuffix</a>() and get this property's value with <a href="#suffix">suffix</a>().
|
||
|
|
<h3 class=fn><a href="qstring.html">QString</a> <a name="text-prop"></a>text</h3>
|
||
|
|
<p>This property holds the spin box's text, including any <a href="#prefix">prefix</a>() and <a href="#suffix">suffix</a>().
|
||
|
|
<p>There is no default text.
|
||
|
|
<p> <p>See also <a href="#value-prop">value</a>.
|
||
|
|
|
||
|
|
<p>Get this property's value with <a href="#text">text</a>().
|
||
|
|
<h3 class=fn>int <a name="value-prop"></a>value</h3>
|
||
|
|
<p>This property holds the value of the spin box.
|
||
|
|
<p>Set this property's value with <a href="#setValue">setValue</a>() and get this property's value with <a href="#value">value</a>().
|
||
|
|
<p><p>See also <a href="qrangecontrol.html#setValue">QRangeControl::setValue</a>().
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="wrapping-prop"></a>wrapping</h3>
|
||
|
|
<p>This property holds whether it is possible to step the value from the highest value to the lowest value and vice versa.
|
||
|
|
<p>By default, wrapping is turned off.
|
||
|
|
<p> If you have a range of 0..100 and wrapping is off when the user
|
||
|
|
reaches 100 and presses the Up Arrow nothing will happen; but if
|
||
|
|
wrapping is on the value will change from 100 to 0, then to 1,
|
||
|
|
etc. When wrapping is on, navigating past the highest value takes
|
||
|
|
you to the lowest and vice versa.
|
||
|
|
<p> <p>See also <a href="#minValue-prop">minValue</a>, <a href="#maxValue-prop">maxValue</a>, and <a href="qrangecontrol.html#setRange">setRange</a>().
|
||
|
|
|
||
|
|
<p>Set this property's value with <a href="#setWrapping">setWrapping</a>() and get this property's value with <a href="#wrapping">wrapping</a>().
|
||
|
|
<!-- eof -->
|
||
|
|
<hr><p>
|
||
|
|
This file is part of the <a href="index.html">Qt 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>Qt 3.3.8</div>
|
||
|
|
</table></div></address></body>
|
||
|
|
</html>
|