kalarm/lib
SpinBox2 Class Reference
#include <spinbox2.h>
Inheritance diagram for SpinBox2:

Detailed Description
Spin box with a pair of spin buttons on either side.The SpinBox2 class provides a spin box with two pairs of spin buttons, one on either side.
It is designed as a base class for implementing such facilities as time spin boxes, where the hours and minutes values are separately displayed in the edit field. When the appropriate step increments are configured, the left spin arrows can then be used to change the hours value, while the right spin arrows can be used to change the minutes value.
Rather than using SpinBox2 directly for time entry, use in preference TimeSpinBox or TimeEdit classes which are tailored from SpinBox2 for this purpose.
Separate step increments may optionally be specified for use when the shift key is held down. Typically these would be larger than the normal steps. Then, when the user clicks the spin buttons, he/she can increment or decrement the value faster by holding the shift key down.
The widget may be set as read-only. This has the same effect as disabling it, except that its appearance is unchanged.
Definition at line 55 of file spinbox2.h.
Public Slots | |
virtual void | setValue (int val) |
virtual void | setPrefix (const QString &text) |
virtual void | setSuffix (const QString &text) |
virtual void | stepUp () |
virtual void | stepDown () |
virtual void | pageUp () |
virtual void | pageDown () |
virtual void | selectAll () |
virtual void | setEnabled (bool enabled) |
Signals | |
void | valueChanged (int value) |
void | valueChanged (const QString &valueText) |
Public Member Functions | |
SpinBox2 (QWidget *parent=0, const char *name=0) | |
SpinBox2 (int minValue, int maxValue, int step=1, int step2=1, QWidget *parent=0, const char *name=0) | |
virtual void | setReadOnly (bool readOnly) |
bool | isReadOnly () const |
void | setSelectOnStep (bool sel) |
void | setReverseWithLayout (bool reverse) |
bool | reverseButtons () const |
QString | text () const |
virtual QString | prefix () const |
virtual QString | suffix () const |
virtual QString | cleanText () const |
virtual void | setSpecialValueText (const QString &text) |
QString | specialValueText () const |
virtual void | setWrapping (bool on) |
bool | wrapping () const |
virtual void | setButtonSymbols (QSpinBox::ButtonSymbols) |
QSpinBox::ButtonSymbols | buttonSymbols () const |
virtual void | setValidator (const QValidator *v) |
const QValidator * | validator () const |
virtual QSize | sizeHint () const |
virtual QSize | minimumSizeHint () const |
int | minValue () const |
int | maxValue () const |
void | setMinValue (int val) |
void | setMaxValue (int val) |
void | setRange (int minValue, int maxValue) |
int | value () const |
int | bound (int val) const |
QRect | upRect () const |
QRect | downRect () const |
QRect | up2Rect () const |
QRect | down2Rect () const |
int | lineStep () const |
int | lineShiftStep () const |
int | pageStep () const |
int | pageShiftStep () const |
void | setLineStep (int step) |
void | setSteps (int line, int page) |
void | setShiftSteps (int line, int page) |
void | addPage () |
void | subtractPage () |
void | addLine () |
void | subtractLine () |
void | addValue (int change) |
Protected Slots | |
virtual void | valueChange () |
virtual void | stepPage (int) |
Protected Member Functions | |
virtual QString | mapValueToText (int v) |
virtual int | mapTextToValue (bool *ok) |
virtual void | resizeEvent (QResizeEvent *) |
virtual void | showEvent (QShowEvent *) |
virtual void | styleChange (QStyle &) |
virtual void | getMetrics () const |
Protected Attributes | |
int | wUpdown2 |
int | xUpdown2 |
int | xSpinbox |
int | wGap |
Friends | |
class | MainSpinBox |
Constructor & Destructor Documentation
SpinBox2::SpinBox2 | ( | QWidget * | parent = 0 , |
|
const char * | name = 0 | |||
) |
Constructor.
- Parameters:
-
parent The parent object of this widget. name The name of this widget.
Definition at line 49 of file spinbox2.cpp.
SpinBox2::SpinBox2 | ( | int | minValue, | |
int | maxValue, | |||
int | step = 1 , |
|||
int | step2 = 1 , |
|||
QWidget * | parent = 0 , |
|||
const char * | name = 0 | |||
) |
Constructor.
- Parameters:
-
minValue The minimum value which the spin box can have. maxValue The maximum value which the spin box can have. step The (unshifted) step interval for the right-hand spin buttons. step2 The (unshifted) step interval for the left-hand spin buttons. parent The parent object of this widget. name The name of this widget.
Definition at line 61 of file spinbox2.cpp.
Member Function Documentation
void SpinBox2::setReadOnly | ( | bool | readOnly | ) | [virtual] |
Sets whether the spin box can be changed by the user.
- Parameters:
-
readOnly True to set the widget read-only, false to set it read-write.
Definition at line 97 of file spinbox2.cpp.
bool SpinBox2::isReadOnly | ( | ) | const [inline] |
void SpinBox2::setSelectOnStep | ( | bool | sel | ) | [inline] |
Sets whether the spin box value text should be selected when its value is stepped.
Definition at line 81 of file spinbox2.h.
void SpinBox2::setReverseWithLayout | ( | bool | reverse | ) |
Sets whether the spin button pairs should be reversed for a right-to-left language.
The default is for them to be reversed.
Definition at line 107 of file spinbox2.cpp.
bool SpinBox2::reverseButtons | ( | ) | const [inline] |
Returns whether the spin button pairs will be reversed for a right-to-left language.
Definition at line 87 of file spinbox2.h.
QString SpinBox2::text | ( | ) | const [inline] |
Returns the spin box's text, including any prefix() and suffix().
Definition at line 90 of file spinbox2.h.
virtual QString SpinBox2::prefix | ( | ) | const [inline, virtual] |
virtual QString SpinBox2::suffix | ( | ) | const [inline, virtual] |
virtual QString SpinBox2::cleanText | ( | ) | const [inline, virtual] |
Returns the spin box's text with no prefix(), suffix() or leading or trailing whitespace.
Definition at line 96 of file spinbox2.h.
virtual void SpinBox2::setSpecialValueText | ( | const QString & | text | ) | [inline, virtual] |
Sets the special-value text which, if non-null, is displayed instead of a numeric value when the current value is equal to minValue().
Definition at line 101 of file spinbox2.h.
QString SpinBox2::specialValueText | ( | ) | const [inline] |
Returns the special-value text which, if non-null, is displayed instead of a numeric value when the current value is equal to minValue().
Definition at line 105 of file spinbox2.h.
void SpinBox2::setWrapping | ( | bool | on | ) | [virtual] |
Sets whether it is possible to step the value from the highest value to the lowest value and vice versa.
Definition at line 123 of file spinbox2.cpp.
bool SpinBox2::wrapping | ( | ) | const [inline] |
Returns whether it is possible to step the value from the highest value to the lowest value and vice versa.
Definition at line 114 of file spinbox2.h.
void SpinBox2::setButtonSymbols | ( | QSpinBox::ButtonSymbols | ) | [virtual] |
QSpinBox::ButtonSymbols SpinBox2::buttonSymbols | ( | ) | const [inline] |
Returns the button symbols currently in use (arrows or plus/minus).
Definition at line 119 of file spinbox2.h.
virtual void SpinBox2::setValidator | ( | const QValidator * | v | ) | [inline, virtual] |
Sets the validator to v
.
The validator controls what keyboard input is accepted when the user is editing the value field.
Definition at line 124 of file spinbox2.h.
const QValidator* SpinBox2::validator | ( | ) | const [inline] |
Returns the current validator.
The validator controls what keyboard input is accepted when the user is editing the value field.
Definition at line 128 of file spinbox2.h.
int SpinBox2::minValue | ( | ) | const [inline] |
int SpinBox2::maxValue | ( | ) | const [inline] |
void SpinBox2::setMinValue | ( | int | val | ) |
void SpinBox2::setMaxValue | ( | int | val | ) |
Sets the maximum value of the spin box.
Reimplemented in TimeSpinBox.
Definition at line 200 of file spinbox2.cpp.
void SpinBox2::setRange | ( | int | minValue, | |
int | maxValue | |||
) | [inline] |
int SpinBox2::value | ( | ) | const [inline] |
int SpinBox2::bound | ( | int | val | ) | const |
Returns the specified value clamped to the range of the spin box.
Definition at line 188 of file spinbox2.cpp.
QRect SpinBox2::upRect | ( | ) | const [inline] |
QRect SpinBox2::downRect | ( | ) | const [inline] |
QRect SpinBox2::up2Rect | ( | ) | const |
QRect SpinBox2::down2Rect | ( | ) | const |
int SpinBox2::lineStep | ( | ) | const [inline] |
Returns the unshifted step increment for the right-hand spin buttons, i.e.
the amount by which the spin box value changes when a right-hand spin button is clicked without the shift key being pressed.
Definition at line 161 of file spinbox2.h.
int SpinBox2::lineShiftStep | ( | ) | const [inline] |
Returns the shifted step increment for the right-hand spin buttons, i.e.
the amount by which the spin box value changes when a right-hand spin button is clicked while the shift key is pressed.
Definition at line 166 of file spinbox2.h.
int SpinBox2::pageStep | ( | ) | const [inline] |
Returns the unshifted step increment for the left-hand spin buttons, i.e.
the amount by which the spin box value changes when a left-hand spin button is clicked without the shift key being pressed.
Definition at line 171 of file spinbox2.h.
int SpinBox2::pageShiftStep | ( | ) | const [inline] |
Returns the shifted step increment for the left-hand spin buttons, i.e.
the amount by which the spin box value changes when a left-hand spin button is clicked while the shift key is pressed.
Definition at line 176 of file spinbox2.h.
void SpinBox2::setLineStep | ( | int | step | ) |
Sets the unshifted step increment for the right-hand spin buttons, i.e.
the amount by which the spin box value changes when a right-hand spin button is clicked without the shift key being pressed.
Definition at line 139 of file spinbox2.cpp.
void SpinBox2::setSteps | ( | int | line, | |
int | page | |||
) |
Sets the unshifted step increments for the two pairs of spin buttons, i.e.
the amount by which the spin box value changes when a spin button is clicked without the shift key being pressed.
- Parameters:
-
line The step increment for the right-hand spin buttons. page The step increment for the left-hand spin buttons.
Definition at line 148 of file spinbox2.cpp.
void SpinBox2::setShiftSteps | ( | int | line, | |
int | page | |||
) |
Sets the shifted step increments for the two pairs of spin buttons, i.e.
the amount by which the spin box value changes when a spin button is clicked while the shift key is pressed.
- Parameters:
-
line The shift step increment for the right-hand spin buttons. page The shift step increment for the left-hand spin buttons.
Definition at line 164 of file spinbox2.cpp.
void SpinBox2::addPage | ( | ) | [inline] |
Increments the current value by adding the unshifted step increment for the left-hand spin buttons.
Definition at line 200 of file spinbox2.h.
void SpinBox2::subtractPage | ( | ) | [inline] |
Decrements the current value by subtracting the unshifted step increment for the left-hand spin buttons.
Definition at line 204 of file spinbox2.h.
void SpinBox2::addLine | ( | ) | [inline] |
Increments the current value by adding the unshifted step increment for the right-hand spin buttons.
Definition at line 208 of file spinbox2.h.
void SpinBox2::subtractLine | ( | ) | [inline] |
Decrements the current value by subtracting the unshifted step increment for the right-hand spin buttons.
Definition at line 212 of file spinbox2.h.
void SpinBox2::addValue | ( | int | change | ) | [inline] |
virtual void SpinBox2::setValue | ( | int | val | ) | [inline, virtual, slot] |
Sets the current value to val
.
Reimplemented in TimeSpinBox.
Definition at line 218 of file spinbox2.h.
virtual void SpinBox2::setPrefix | ( | const QString & | text | ) | [inline, virtual, slot] |
Sets the prefix which is prepended to the start of the displayed text.
Definition at line 220 of file spinbox2.h.
virtual void SpinBox2::setSuffix | ( | const QString & | text | ) | [inline, virtual, slot] |
Sets the suffix which is prepended to the start of the displayed text.
Definition at line 222 of file spinbox2.h.
virtual void SpinBox2::stepUp | ( | ) | [inline, virtual, slot] |
Increments the current value by adding the unshifted step increment for the right-hand spin buttons.
Reimplemented in TimeSpinBox.
Definition at line 226 of file spinbox2.h.
virtual void SpinBox2::stepDown | ( | ) | [inline, virtual, slot] |
Decrements the current value by subtracting the unshifted step increment for the right-hand spin buttons.
Reimplemented in TimeSpinBox.
Definition at line 230 of file spinbox2.h.
virtual void SpinBox2::pageUp | ( | ) | [inline, virtual, slot] |
Increments the current value by adding the unshifted step increment for the left-hand spin buttons.
Definition at line 234 of file spinbox2.h.
virtual void SpinBox2::pageDown | ( | ) | [inline, virtual, slot] |
Decrements the current value by subtracting the unshifted step increment for the left-hand spin buttons.
Definition at line 238 of file spinbox2.h.
virtual void SpinBox2::selectAll | ( | ) | [inline, virtual, slot] |
void SpinBox2::setEnabled | ( | bool | enabled | ) | [virtual, slot] |
void SpinBox2::valueChanged | ( | int | value | ) | [signal] |
Signal which is emitted whenever the value of the spin box changes.
void SpinBox2::valueChanged | ( | const QString & | valueText | ) | [signal] |
Signal which is emitted whenever the value of the spin box changes.
The documentation for this class was generated from the following files: