QAbstractSpinBox Class Reference

#include <qabstractspinbox.h>

Inheritance diagram for QAbstractSpinBox:

[legend]Collaboration diagram for QAbstractSpinBox:

[legend]List of all members.

---

Detailed Description

The QAbstractSpinBox class provides a spinbox and a line edit to display values.

The class is designed as a common super class for widgets like QSpinBox, QDoubleSpinBox and QDateTimeEdit

Here are the main properties of the class:

1

text: The text that is displayed in the QAbstractSpinBox.

alignment: The alignment of the text in the QAbstractSpinBox.

wrapping: Whether the QAbstractSpinBox wraps from the minimum value to the maximum value and vica versa.

QAbstractSpinBox provides a virtual stepBy() function that is called whenever the user triggers a step. This function takes an integer value to signify how many steps were taken. E.g. Pressing Qt::Key_Down will trigger a call to stepBy(-1).

QAbstractSpinBox also provide a virtual function stepEnabled() to determine whether stepping up/down is allowed at any point. This function returns a bitset of StepEnabled.

See also:

QAbstractSlider, QSpinBox, QDoubleSpinBox, QDateTimeEdit, {Spin Boxes Example}

Definition at line 40 of file qabstractspinbox.h.

Public Types
enum	StepEnabledFlag
enum	ButtonSymbols
enum	CorrectionMode
Public Slots
void	stepUp ()
void	stepDown ()
void	selectAll ()
virtual void	clear ()
Signals
void	editingFinished ()
Public Member Functions
	QAbstractSpinBox (QWidget *parent=0)
	~QAbstractSpinBox ()
ButtonSymbols	buttonSymbols () const
void	setButtonSymbols (ButtonSymbols bs)
void	setCorrectionMode (CorrectionMode cm)
CorrectionMode	correctionMode () const
bool	hasAcceptableInput () const
QString	text () const
QString	specialValueText () const
void	setSpecialValueText (const QString &txt)
bool	wrapping () const
void	setWrapping (bool w)
void	setReadOnly (bool r)
bool	isReadOnly () const
void	setAlignment (Qt::Alignment flag)
Qt::Alignment	alignment () const
void	setFrame (bool)
bool	hasFrame () const
void	setAccelerated (bool on)
bool	isAccelerated () const
QSize	sizeHint () const
QSize	minimumSizeHint () const
void	interpretText ()
bool	event (QEvent *event)
virtual QValidator::State	validate (QString &input, int &pos) const
virtual void	fixup (QString &input) const
virtual void	stepBy (int steps)
Protected Member Functions
void	resizeEvent (QResizeEvent *event)
void	keyPressEvent (QKeyEvent *event)
void	keyReleaseEvent (QKeyEvent *event)
void	wheelEvent (QWheelEvent *event)
void	focusInEvent (QFocusEvent *event)
void	focusOutEvent (QFocusEvent *event)
void	contextMenuEvent (QContextMenuEvent *event)
void	changeEvent (QEvent *event)
void	closeEvent (QCloseEvent *event)
void	hideEvent (QHideEvent *event)
void	mousePressEvent (QMouseEvent *event)
void	mouseReleaseEvent (QMouseEvent *event)
void	mouseMoveEvent (QMouseEvent *event)
void	timerEvent (QTimerEvent *event)
void	paintEvent (QPaintEvent *event)
void	showEvent (QShowEvent *event)
QLineEdit *	lineEdit () const
void	setLineEdit (QLineEdit *edit)
virtual StepEnabled	stepEnabled () const
	QAbstractSpinBox (QAbstractSpinBoxPrivate &dd, QWidget *parent=0)
Private Member Functions
	Q_PRIVATE_SLOT (d_func(), void _q_editorTextChanged(const QString &)) Q_PRIVATE_SLOT(d_func()

---

Member Enumeration Documentation

enum QAbstractSpinBox::StepEnabledFlag

StepNone StepUpEnabled StepDownEnabled

Definition at line 61 of file qabstractspinbox.h.

                         { StepNone = 0x00, StepUpEnabled = 0x01,
                           StepDownEnabled = 0x02 };

enum QAbstractSpinBox::ButtonSymbols

This enum type describes the symbols that can be displayed on the buttons in a spin box.

qspinbox-updown.png qspinbox-plusminus.png

UpDownArrows Little arrows in the classic style. PlusMinus {+} and {-} symbols.

See also:

QAbstractSpinBox::buttonSymbols

Definition at line 65 of file qabstractspinbox.h.

{ UpDownArrows, PlusMinus };

enum QAbstractSpinBox::CorrectionMode

This enum type describes the mode the spinbox will use to correct an {QValidator::}{Intermediate} value if editing finishes.

CorrectToPreviousValue The spinbox will revert to the last valid value.

CorrectToNearestValue The spinbox will revert to the nearest valid value.

See also:

correctionMode

Definition at line 70 of file qabstractspinbox.h.

{ CorrectToPreviousValue, CorrectToNearestValue };

---

Constructor & Destructor Documentation

QAbstractSpinBox::QAbstractSpinBox

(

QWidget *

parent = 0

)

[explicit]

Constructs an abstract spinbox with the given parent with default wrapping, and alignment properties.

Definition at line 110 of file qabstractspinbox.cpp.

References d.

    : QWidget(*new QAbstractSpinBoxPrivate, parent, 0)
{
    Q_D(QAbstractSpinBox);
    d->init();
}

QAbstractSpinBox::~QAbstractSpinBox

(

)

Called when the QAbstractSpinBox is destroyed.

Definition at line 131 of file qabstractspinbox.cpp.

{
}

QAbstractSpinBox::QAbstractSpinBox	(	QAbstractSpinBoxPrivate &	dd,
		QWidget *	parent = 0
	)			[protected]

Definition at line 120 of file qabstractspinbox.cpp.

References d.

    : QWidget(dd, parent, 0)
{
    Q_D(QAbstractSpinBox);
    d->init();
}

---

Member Function Documentation

QAbstractSpinBox::ButtonSymbols QAbstractSpinBox::buttonSymbols

(

)

const

Definition at line 161 of file qabstractspinbox.cpp.

References d.

{
    Q_D(const QAbstractSpinBox);
    return d->buttonSymbols;
}

void QAbstractSpinBox::setButtonSymbols

(

ButtonSymbols

bs

)

Definition at line 167 of file qabstractspinbox.cpp.

References d, and QWidget::update().

{
    Q_D(QAbstractSpinBox);
    if (d->buttonSymbols != buttonSymbols) {
        d->buttonSymbols = buttonSymbols;
        update();
    }
}

void QAbstractSpinBox::setCorrectionMode

(

CorrectionMode

cm

)

Definition at line 372 of file qabstractspinbox.cpp.

References d.

{
    Q_D(QAbstractSpinBox);
    d->correctionMode = correctionMode;

}

QAbstractSpinBox::CorrectionMode QAbstractSpinBox::correctionMode

(

)

const

Definition at line 378 of file qabstractspinbox.cpp.

References d.

{
    Q_D(const QAbstractSpinBox);
    return d->correctionMode;
}

bool QAbstractSpinBox::hasAcceptableInput

(

)

const

Definition at line 393 of file qabstractspinbox.cpp.

References d.

{
    Q_D(const QAbstractSpinBox);
    return d->edit->hasAcceptableInput();
}

QString QAbstractSpinBox::text

(

)

const

Definition at line 184 of file qabstractspinbox.cpp.

References QLineEdit::displayText(), and lineEdit().

Referenced by QCalendarWidgetPrivate::_q_yearEditingFinished(), QDateTimeEdit::dateTimeFromText(), keyPressEvent(), QAccessibleSpinBox::text(), QSpinBox::validate(), QDoubleSpinBox::validate(), QDateTimeEdit::validate(), IconSizeSpinBox::valueFromText(), QSpinBox::valueFromText(), and QDoubleSpinBox::valueFromText().

{
    return lineEdit()->displayText();
}

Here is the call graph for this function:

QString QAbstractSpinBox::specialValueText

(

)

const

Definition at line 225 of file qabstractspinbox.cpp.

References d.

Referenced by setSpecialValueText().

{
    Q_D(const QAbstractSpinBox);
    return d->specialValueText;
}

void QAbstractSpinBox::setSpecialValueText

(

const QString &

txt

)

Definition at line 231 of file qabstractspinbox.cpp.

References d, and specialValueText().

Referenced by Window::createDoubleSpinBoxes(), qdesigner_internal::IntProperty::createEditor(), qdesigner_internal::SpinBoxDoubleProperty::createEditor(), Window::createSpinBoxes(), and QueryPage::QueryPage().

{
    Q_D(QAbstractSpinBox);

    d->specialValueText = specialValueText;
    d->clearCache();
    d->updateEdit();
}

Here is the call graph for this function:

bool QAbstractSpinBox::wrapping

(

)

const

Definition at line 261 of file qabstractspinbox.cpp.

References d.

{
    Q_D(const QAbstractSpinBox);
    return d->wrapping;
}

void QAbstractSpinBox::setWrapping

(

bool

w

)

Definition at line 267 of file qabstractspinbox.cpp.

References d.

{
    Q_D(QAbstractSpinBox);
    d->wrapping = wrapping;
}

void QAbstractSpinBox::setReadOnly

(

bool

r

)

Definition at line 294 of file qabstractspinbox.cpp.

References d, and QWidget::update().

{
    Q_D(QAbstractSpinBox);
    d->readOnly = enable;
    d->edit->setReadOnly(enable);
    update();
}

bool QAbstractSpinBox::isReadOnly

(

)

const

Definition at line 288 of file qabstractspinbox.cpp.

References d.

Referenced by keyPressEvent().

{
    Q_D(const QAbstractSpinBox);
    return d->readOnly;
}

void QAbstractSpinBox::setAlignment

(

Qt::Alignment

flag

)

Definition at line 420 of file qabstractspinbox.cpp.

References d.

{
    Q_D(QAbstractSpinBox);

    d->edit->setAlignment(flag);
}

Qt::Alignment QAbstractSpinBox::alignment

(

)

const

Definition at line 413 of file qabstractspinbox.cpp.

References d.

{
    Q_D(const QAbstractSpinBox);

    return (Qt::Alignment)d->edit->alignment();
}

void QAbstractSpinBox::setFrame

(

bool

)

Definition at line 317 of file qabstractspinbox.cpp.

References d, and QWidget::update().

Referenced by qdesigner_internal::IntProperty::createEditor(), BookDelegate::createEditor(), qdesigner_internal::SpinBoxDoubleProperty::createEditor(), QDefaultItemEditorFactory::createEditor(), and QCalendarWidgetPrivate::createHeader().

{
    Q_D(QAbstractSpinBox);
    d->frame = enable;
    update();
    d->updateEditFieldGeometry();
}

bool QAbstractSpinBox::hasFrame

(

)

const

Definition at line 310 of file qabstractspinbox.cpp.

References d.

{
    Q_D(const QAbstractSpinBox);
    return d->frame;
}

void QAbstractSpinBox::setAccelerated

(

bool

on

)

Definition at line 335 of file qabstractspinbox.cpp.

References d.

{
    Q_D(QAbstractSpinBox);
    d->accelerate = accelerate;

}

bool QAbstractSpinBox::isAccelerated

(

)

const

Definition at line 341 of file qabstractspinbox.cpp.

References d.

{
    Q_D(const QAbstractSpinBox);
    return d->accelerate;
}

QSize QAbstractSpinBox::sizeHint

(

)

const [virtual]

Reimplemented from QWidget.

Definition at line 734 of file qabstractspinbox.cpp.

References QStyle::CC_SpinBox, QStyle::CT_SpinBox, d, QWidget::ensurePolished(), QSize::expandedTo(), QWidget::fontMetrics(), QApplication::globalStrut(), h, qMax(), QStyleOption::rect, QWidget::rect(), s, QStyle::SC_SpinBoxEditField, QRect::setSize(), QRect::size(), QStyle::sizeFromContents(), QWidget::style(), QStyle::subControlRect(), w, and QFontMetrics::width().

Referenced by QCalendarWidgetPrivate::_q_yearClicked().

{
    Q_D(const QAbstractSpinBox);
    ensurePolished();

    const QFontMetrics fm(fontMetrics());
    int h = d->edit->sizeHint().height();
    int w = 0;
    QString s;
    s = d->prefix + d->textFromValue(d->minimum) + d->suffix + QLatin1Char(' ');
    s.truncate(18);
    w = qMax(w, fm.width(s));
    s = d->prefix + d->textFromValue(d->maximum) + d->suffix + QLatin1Char(' ');
    s.truncate(18);
    w = qMax(w, fm.width(s));
    if (d->specialValueText.size()) {
        s = d->specialValueText;
        w = qMax(w, fm.width(s));
    }
    w += 2; // cursor blinking space

    QStyleOptionSpinBox opt = d->getStyleOption();
    QSize hint(w, h);
    QSize extra(35, 6);
    opt.rect.setSize(hint + extra);
    extra += hint - style()->subControlRect(QStyle::CC_SpinBox, &opt,
                                            QStyle::SC_SpinBoxEditField, this).size();
    // get closer to final result by repeating the calculation
    opt.rect.setSize(hint + extra);
    extra += hint - style()->subControlRect(QStyle::CC_SpinBox, &opt,
                                               QStyle::SC_SpinBoxEditField, this).size();
    hint += extra;

    opt.rect = rect();
    return style()->sizeFromContents(QStyle::CT_SpinBox, &opt, hint, this)
        .expandedTo(QApplication::globalStrut());
}

Here is the call graph for this function:

QSize QAbstractSpinBox::minimumSizeHint

(

)

const [virtual]

Reimplemented from QWidget.

Definition at line 776 of file qabstractspinbox.cpp.

References QStyle::CC_SpinBox, QStyle::CT_SpinBox, d, QWidget::ensurePolished(), QSize::expandedTo(), QWidget::fontMetrics(), QApplication::globalStrut(), h, QStyleOption::rect, QWidget::rect(), QStyle::SC_SpinBoxEditField, QRect::setSize(), QRect::size(), QStyle::sizeFromContents(), QWidget::style(), QStyle::subControlRect(), w, and QFontMetrics::width().

{
    Q_D(const QAbstractSpinBox);
    ensurePolished();

    const QFontMetrics fm(fontMetrics());
    int h = d->edit->minimumSizeHint().height();
    int w = fm.width(QLatin1String("1000"));
    w += 2; // cursor blinking space

    QStyleOptionSpinBox opt = d->getStyleOption();
    QSize hint(w, h);
    QSize extra(35, 6);
    opt.rect.setSize(hint + extra);
    extra += hint - style()->subControlRect(QStyle::CC_SpinBox, &opt,
                                            QStyle::SC_SpinBoxEditField, this).size();
    // get closer to final result by repeating the calculation
    opt.rect.setSize(hint + extra);
    extra += hint - style()->subControlRect(QStyle::CC_SpinBox, &opt,
                                               QStyle::SC_SpinBoxEditField, this).size();
    hint += extra;

    opt.rect = rect();

    return style()->sizeFromContents(QStyle::CT_SpinBox, &opt, hint, this)
        .expandedTo(QApplication::globalStrut());
}

Here is the call graph for this function:

void QAbstractSpinBox::interpretText

(

)

This function interprets the text of the spin box. If the value has changed since last interpretation it will emit signals.

Definition at line 638 of file qabstractspinbox.cpp.

References d, and EmitIfChanged.

Referenced by SpinBoxDelegate::setModelData().

{
    Q_D(QAbstractSpinBox);
    d->interpret(EmitIfChanged);
}

bool QAbstractSpinBox::event

(

QEvent *

event

)

[virtual]

Reimplemented from QWidget.

Definition at line 648 of file qabstractspinbox.cpp.

References QEvent::ApplicationLayoutDirectionChange, d, QWidget::event(), QEvent::HoverEnter, QEvent::HoverLeave, QEvent::HoverMove, QEvent::LayoutDirectionChange, and QEvent::ShortcutOverride.

Referenced by changeEvent(), closeEvent(), contextMenuEvent(), QDateTimeEdit::event(), QSpinBox::event(), focusInEvent(), focusOutEvent(), hideEvent(), keyPressEvent(), keyReleaseEvent(), mouseMoveEvent(), mousePressEvent(), mouseReleaseEvent(), resizeEvent(), timerEvent(), and wheelEvent().

{
    Q_D(QAbstractSpinBox);
    switch (event->type()) {
    case QEvent::ApplicationLayoutDirectionChange:
    case QEvent::LayoutDirectionChange:
        d->updateEditFieldGeometry();
        break;
    case QEvent::HoverEnter:
    case QEvent::HoverLeave:
    case QEvent::HoverMove:
        if (const QHoverEvent *he = static_cast<const QHoverEvent *>(event))
            d->updateHoverControl(he->pos());
        break;
    case QEvent::ShortcutOverride:
        if (d->edit->event(event))
            return true;
        break;
    default:
        break;
    }
    return QWidget::event(event);
}

Here is the call graph for this function:

QValidator::State QAbstractSpinBox::validate	(	QString &	input,
		int &	pos
	)			const [virtual]

This virtual function is called by the QAbstractSpinBox to determine whether input is valid. The pos parameter indicates the position in the string. Reimplemented in the various subclasses.

Definition at line 499 of file qabstractspinbox.cpp.

References QValidator::Acceptable.

Referenced by stepBy(), and QSpinBoxValidator::validate().

{
    return QValidator::Acceptable;
}

void QAbstractSpinBox::fixup

(

QString &

input

)

const [virtual]

This virtual function is called by the QAbstractSpinBox if the input is not validated to QValidator::Acceptable when Return is pressed or interpretText() is called. It will try to change the text so it is valid. Reimplemented in the various subclasses.

Definition at line 511 of file qabstractspinbox.cpp.

Referenced by QSpinBoxValidator::fixup().

{
}

void QAbstractSpinBox::stepBy

(

int

steps

)

[virtual]

Virtual function that is called whenever the user triggers a step. The steps parameter indicates how many steps were taken, e.g. Pressing Qt::Key_Down will trigger a call to stepBy(-1), whereas pressing Qt::Key_Prior will trigger a call to stepBy(10).

If you subclass QAbstractSpinBox you must reimplement this function. Note that this function is called even if the resulting value will be outside the bounds of minimum and maximum. It's this function's job to handle these situations.

Definition at line 549 of file qabstractspinbox.cpp.

References QValidator::Acceptable, AlwaysEmit, d, EmitIfChanged, NeverEmit, selectAll(), and validate().

Referenced by contextMenuEvent(), keyPressEvent(), qdesigner_internal::QtSpinBox::stepBy(), QDoublePropertySpinBox::stepBy(), QIntPropertySpinBox::stepBy(), qdesigner_internal::QtDoubleSpinBox::stepBy(), stepDown(), stepUp(), timerEvent(), and wheelEvent().

{
    Q_D(QAbstractSpinBox);

    const QVariant old = d->value;
    QString tmp = d->edit->displayText();
    int cursorPos = d->edit->cursorPosition();
    bool dontstep = false;
    EmitPolicy e = EmitIfChanged;
    if (d->pendingEmit) {
        dontstep = validate(tmp, cursorPos) != QValidator::Acceptable;
        d->interpret(NeverEmit);
        if (d->value != old)
            e = AlwaysEmit;
    }
    if (!dontstep) {
        d->setValue(d->bound(d->value + (d->singleStep * steps), old, steps), e);
    } else if (e == AlwaysEmit) {
        d->emitSignals(e, old);
    }
    selectAll();
}

Here is the call graph for this function:

void QAbstractSpinBox::stepUp

(

)

[slot]

Steps up by one linestep Calling this slot is analogous to calling stepBy(1);

See also:

stepBy(), stepDown()

Definition at line 521 of file qabstractspinbox.cpp.

References stepBy().

{
    stepBy(1);
}

void QAbstractSpinBox::stepDown

(

)

[slot]

Steps down by one linestep Calling this slot is analogous to calling stepBy(-1);

See also:

stepBy(), stepUp()

Definition at line 532 of file qabstractspinbox.cpp.

References stepBy().

{
    stepBy(-1);
}

void QAbstractSpinBox::selectAll

(

)

[slot]

Selects all the text in the spinbox except the prefix and suffix.

Definition at line 431 of file qabstractspinbox.cpp.

References d.

Referenced by QCalendarWidgetPrivate::_q_yearClicked(), qdesigner_internal::IntProperty::createEditor(), qdesigner_internal::SpinBoxDoubleProperty::createEditor(), focusInEvent(), QInputDialog::getInteger(), keyPressEvent(), QDateTimeEdit::keyPressEvent(), and stepBy().

{
    Q_D(QAbstractSpinBox);


    if (!d->specialValue()) {
        const int tmp = d->edit->displayText().size() - d->suffix.size();
        d->edit->setSelection(tmp, -(tmp - d->prefix.size()));
    } else {
        d->edit->selectAll();
    }
}

void QAbstractSpinBox::clear

(

)

[virtual, slot]

Clears the lineedit of all text but prefix and suffix.

Definition at line 448 of file qabstractspinbox.cpp.

References d.

Referenced by keyPressEvent().

{
    Q_D(QAbstractSpinBox);


    d->edit->setText(d->prefix + d->suffix);
    d->edit->setCursorPosition(d->prefix.size());
}

void QAbstractSpinBox::resizeEvent

(

QResizeEvent *

event

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 721 of file qabstractspinbox.cpp.

References d, event(), QWidget::resizeEvent(), and QWidget::update().

{
    Q_D(QAbstractSpinBox);
    QWidget::resizeEvent(event);

    d->updateEditFieldGeometry();
    update();
}

Here is the call graph for this function:

void QAbstractSpinBox::keyPressEvent

(

QKeyEvent *

event

)

[protected, virtual]

This function handles keyboard input.

The following keys are handled specifically: Enter/Return This will reinterpret the text and emit a signal even if the value has not changed since last time a signal was emitted. Up This will invoke stepBy(1) Down This will invoke stepBy(-1) Page up This will invoke stepBy(10) Page down This will invoke stepBy(-10)

Reimplemented from QWidget.

Definition at line 839 of file qabstractspinbox.cpp.

References AlwaysEmit, clear(), Qt::ControlModifier, d, Down, editingFinished(), emit, event(), isReadOnly(), Qt::Key_A, Qt::Key_Back, Qt::Key_Down, Qt::Key_End, Qt::Key_Enter, Qt::Key_Home, Qt::Key_Left, Qt::Key_PageDown, Qt::Key_PageUp, Qt::Key_Return, Qt::Key_Right, Qt::Key_Select, Qt::Key_U, Qt::Key_Up, Qt::Key_Y, Qt::Key_Z, Keyboard, selectAll(), QStyle::SH_SpinBox_AnimateButton, Qt::ShiftModifier, QString::size(), stepBy(), StepDownEnabled, stepEnabled(), StepUpEnabled, QWidget::style(), styleHint(), text(), and Up.

Referenced by QDateTimeEdit::keyPressEvent().

{
    Q_D(QAbstractSpinBox);

    if (!event->text().isEmpty() && d->edit->cursorPosition() < d->prefix.size())
        d->edit->setCursorPosition(d->prefix.size());

    int steps = 1;
    switch (event->key()) {
    case Qt::Key_PageUp:
    case Qt::Key_PageDown:
        steps *= 10;
    case Qt::Key_Up:
    case Qt::Key_Down: {
#ifdef QT_KEYPAD_NAVIGATION
        if (QApplication::keypadNavigationEnabled()) {
            // Reserve up/down for nav - use left/right for edit.
            if (!hasEditFocus() && (event->key() == Qt::Key_Up
                                    || event->key() == Qt::Key_Down)) {
                event->ignore();
                return;
            }
        }
#endif
        event->accept();
        const bool up = (event->key() == Qt::Key_PageUp || event->key() == Qt::Key_Up);
        if (!(stepEnabled() & (up ? StepUpEnabled : StepDownEnabled)))
            return;
        if (!up)
            steps *= -1;
        if (style()->styleHint(QStyle::SH_SpinBox_AnimateButton, 0, this)) {
            d->buttonState = (Keyboard | (up ? Up : Down));
        }
        stepBy(steps);
        return;
    }
#ifdef QT_KEYPAD_NAVIGATION
    case Qt::Key_Left:
    case Qt::Key_Right:
        if (QApplication::keypadNavigationEnabled() && !hasEditFocus()) {
            const bool up = (event->key() == Qt::Key_Right);
            if (!(stepEnabled() & (up ? StepUpEnabled : StepDownEnabled)))
                return;
            if (!up)
                steps *= -1;
            if (style()->styleHint(QStyle::SH_SpinBox_AnimateButton, 0, this)) {
                d->buttonState = (Keyboard | (up ? Up : Down));
            }
            stepBy(steps);
            return;
        }
        break;
    case Qt::Key_Back:
        if (QApplication::keypadNavigationEnabled() && !hasEditFocus()) {
            event->ignore();
            return;
        }
        break;
#endif
    case Qt::Key_Enter:
    case Qt::Key_Return:
        d->interpret(AlwaysEmit);
        selectAll();
        event->ignore();
        emit editingFinished();
        return;

#ifdef QT_KEYPAD_NAVIGATION
    case Qt::Key_Select:
        if (QApplication::keypadNavigationEnabled()) {
            // Toggles between left/right moving cursor and inc/dec.
            setEditFocus(!hasEditFocus());
            if (!hasEditFocus())
                selectAll();
        }
        return;
#endif

#ifdef Q_WS_X11 // only X11
    case Qt::Key_U:
        if (event->modifiers() & Qt::ControlModifier) {
            event->accept();
            if (!isReadOnly())
                clear();
            return;
        }
        break;
#else // Mac and Windows
    case Qt::Key_A:
        if (event->modifiers() & Qt::ControlModifier) {
            selectAll();
            event->accept();
            return;
        }
        break;
#endif

    case Qt::Key_End:
    case Qt::Key_Home:
        if (event->modifiers() & Qt::ShiftModifier) {
            int currentPos = d->edit->cursorPosition();
            const QString text = d->edit->displayText();
            if (event->key() == Qt::Key_End) {
                if ((currentPos == 0 && !d->prefix.isEmpty()) || text.size() - d->suffix.size() <= currentPos) {
                    break; // let lineedit handle this
                } else {
                    d->edit->setSelection(currentPos, text.size() - d->suffix.size() - currentPos);
                }
            } else {
                if ((currentPos == text.size() && !d->suffix.isEmpty()) || currentPos <= d->prefix.size()) {
                    break; // let lineedit handle this
                } else {
                    d->edit->setSelection(currentPos, d->prefix.size() - currentPos);
                }
            }
            event->accept();
            return;
        }
        break;

    case Qt::Key_Z:
    case Qt::Key_Y:
        if (event->modifiers() & Qt::ControlModifier) {
            event->ignore();
            return;
        }
        break;
    default:
        break;
    }

    d->edit->event(event);
}

Here is the call graph for this function:

void QAbstractSpinBox::keyReleaseEvent

(

QKeyEvent *

event

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 977 of file qabstractspinbox.cpp.

References d, event(), Keyboard, QStyle::SH_SpinBox_AnimateButton, QWidget::style(), and QStyle::styleHint().

{
    Q_D(QAbstractSpinBox);

    if (d->buttonState & Keyboard && !event->isAutoRepeat()
        && style()->styleHint(QStyle::SH_SpinBox_AnimateButton, 0, this)) {
        d->reset();
    } else {
        d->edit->event(event);
    }
}

Here is the call graph for this function:

void QAbstractSpinBox::wheelEvent

(

QWheelEvent *

event

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 994 of file qabstractspinbox.cpp.

References Qt::ControlModifier, event(), stepBy(), StepDownEnabled, stepEnabled(), and StepUpEnabled.

Referenced by QDateTimeEdit::wheelEvent().

{
    const int steps = (event->delta() > 0 ? 1 : -1);
    if (stepEnabled() & (steps > 0 ? StepUpEnabled : StepDownEnabled))
        stepBy(event->modifiers() & Qt::ControlModifier ? steps * 10 : steps);
    event->accept();
}

Here is the call graph for this function:

void QAbstractSpinBox::focusInEvent

(

QFocusEvent *

event

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 1007 of file qabstractspinbox.cpp.

References Qt::BacktabFocusReason, d, event(), QWidget::focusInEvent(), selectAll(), and Qt::TabFocusReason.

Referenced by QDateTimeEdit::focusInEvent().

{
    Q_D(QAbstractSpinBox);

    d->edit->event(event);
    if (event->reason() == Qt::TabFocusReason || event->reason() == Qt::BacktabFocusReason) {
        selectAll();
    }
    QWidget::focusInEvent(event);
}

Here is the call graph for this function:

void QAbstractSpinBox::focusOutEvent

(

QFocusEvent *

event

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 1022 of file qabstractspinbox.cpp.

References d, editingFinished(), emit, EmitIfChanged, event(), and QWidget::focusOutEvent().

{
    Q_D(QAbstractSpinBox);

    if (d->pendingEmit)
        d->interpret(EmitIfChanged);

    d->reset();
    d->edit->event(event);
    QWidget::focusOutEvent(event);
    emit editingFinished();
}

Here is the call graph for this function:

void QAbstractSpinBox::contextMenuEvent

(

QContextMenuEvent *

event

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 1112 of file qabstractspinbox.cpp.

References d, event(), QWidget::height(), QWidget::mapToGlobal(), QContextMenuEvent::Mouse, QWidget::pos(), QAction::setEnabled(), stepBy(), StepDownEnabled, stepEnabled(), StepUpEnabled, and QWidget::width().

{
#ifdef QT_NO_CONTEXTMENU
    Q_UNUSED(event);
#else
    Q_D(QAbstractSpinBox);

    d->reset();
    QPointer<QMenu> menu = d->edit->createStandardContextMenu();
    menu->addSeparator();
    const uint se = stepEnabled();
    QAction *up = menu->addAction(tr("&Step up"));
    up->setEnabled(se & StepUpEnabled);
    QAction *down = menu->addAction(tr("Step &down"));
    down->setEnabled(se & StepDownEnabled);

    const QPointer<QAbstractSpinBox> that = this;
    const QPoint pos = (event->reason() == QContextMenuEvent::Mouse)
        ? event->globalPos() : mapToGlobal(QPoint(event->pos().x(), 0)) + QPoint(width() / 2, height() / 2);
    const QAction *action = menu->exec(pos);
    delete static_cast<QMenu *>(menu);
    if (that) {
        if (action == up) {
            stepBy(1);
        } else if (action == down) {
            stepBy(-1);
        }
    }
    event->accept();
#endif // QT_NO_CONTEXTMENU
}

Here is the call graph for this function:

void QAbstractSpinBox::changeEvent

(

QEvent *

event

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 688 of file qabstractspinbox.cpp.

References QEvent::ActivationChange, QWidget::changeEvent(), d, EmitIfChanged, QEvent::EnabledChange, event(), QWidget::isActiveWindow(), QWidget::isEnabled(), QStyle::SH_SpinBox_ClickAutoRepeatRate, QWidget::style(), QEvent::StyleChange, QStyle::styleHint(), and thresholdTime.

{
    Q_D(QAbstractSpinBox);

    switch (event->type()) {
        case QEvent::StyleChange:
            d->spinClickTimerInterval = style()->styleHint(QStyle::SH_SpinBox_ClickAutoRepeatRate, 0, this);
            d->spinClickThresholdTimerInterval = thresholdTime;
            d->reset();
            d->updateEditFieldGeometry();
            break;
        case QEvent::EnabledChange:
            if (!isEnabled()) {
                d->reset();
            }
            break;
        case QEvent::ActivationChange:
            if (!isActiveWindow()){
                d->reset();
                if (d->pendingEmit) // pendingEmit can be true even if it hasn't changed.
                    d->interpret(EmitIfChanged); // E.g. 10 to 10.0
            }
            break;
        default:
            break;
    }
    QWidget::changeEvent(event);
}

Here is the call graph for this function:

void QAbstractSpinBox::closeEvent

(

QCloseEvent *

event

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 1039 of file qabstractspinbox.cpp.

References QWidget::closeEvent(), d, EmitIfChanged, and event().

{
    Q_D(QAbstractSpinBox);

    d->reset();
    if (d->pendingEmit)
        d->interpret(EmitIfChanged);
    QWidget::closeEvent(event);
}

Here is the call graph for this function:

void QAbstractSpinBox::hideEvent

(

QHideEvent *

event

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 1053 of file qabstractspinbox.cpp.

References d, EmitIfChanged, event(), and QWidget::hideEvent().

{
    Q_D(QAbstractSpinBox);
    d->reset();
    if (d->pendingEmit)
        d->interpret(EmitIfChanged);
    QWidget::hideEvent(event);
}

Here is the call graph for this function:

void QAbstractSpinBox::mousePressEvent

(

QMouseEvent *

event

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 1171 of file qabstractspinbox.cpp.

References d, event(), Qt::LeftButton, None, QStyle::SC_SpinBoxDown, QStyle::SC_SpinBoxUp, StepDownEnabled, stepEnabled(), and StepUpEnabled.

Referenced by QDateTimeEdit::mousePressEvent().

{
    Q_D(QAbstractSpinBox);

    if (event->button() != Qt::LeftButton || d->buttonState != None) {
        return;
    }

    d->updateHoverControl(event->pos());
    event->accept();

    const StepEnabled se = stepEnabled();
    if ((se & StepUpEnabled) && d->hoverControl == QStyle::SC_SpinBoxUp) {
        d->updateState(true);
    } else if ((se & StepDownEnabled) && d->hoverControl == QStyle::SC_SpinBoxDown) {
        d->updateState(false);
    } else {
        event->ignore();
    }
}

Here is the call graph for this function:

void QAbstractSpinBox::mouseReleaseEvent

(

QMouseEvent *

event

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 1195 of file qabstractspinbox.cpp.

References d, and event().

{
    Q_D(QAbstractSpinBox);

    if ((d->buttonState & Mouse) != 0)
        d->reset();
    event->accept();
}

Here is the call graph for this function:

void QAbstractSpinBox::mouseMoveEvent

(

QMouseEvent *

event

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 1148 of file qabstractspinbox.cpp.

References d, event(), QStyle::SC_SpinBoxDown, QStyle::SC_SpinBoxUp, StepDownEnabled, stepEnabled(), and StepUpEnabled.

{
    Q_D(QAbstractSpinBox);

    d->updateHoverControl(event->pos());

    // If we have a timer ID, update the state
    const StepEnabled se = stepEnabled();
    if (d->spinClickTimerId != -1) {
        if ((se & StepUpEnabled) && d->hoverControl == QStyle::SC_SpinBoxUp)
            d->updateState(true);
        else if ((se & StepDownEnabled) && d->hoverControl == QStyle::SC_SpinBoxDown)
            d->updateState(false);
        else
            d->reset();
        event->accept();
    }
}

Here is the call graph for this function:

void QAbstractSpinBox::timerEvent

(

QTimerEvent *

event

)

[protected, virtual]

Reimplemented from QObject.

Definition at line 1066 of file qabstractspinbox.cpp.

References d, Down, event(), int, QObject::killTimer(), QObject::startTimer(), stepBy(), StepDownEnabled, stepEnabled(), StepUpEnabled, QObject::timerEvent(), and Up.

{
    Q_D(QAbstractSpinBox);

    bool doStep = false;
    if (event->timerId() == d->spinClickThresholdTimerId) {
        killTimer(d->spinClickThresholdTimerId);
        d->spinClickThresholdTimerId = -1;
        d->spinClickTimerId = startTimer(d->spinClickTimerInterval);
        doStep = true;
    } else if (event->timerId() == d->spinClickTimerId) {
        if (d->accelerate) {
            d->acceleration = d->acceleration + (int)(d->spinClickTimerInterval * 0.05);
            if (d->spinClickTimerInterval - d->acceleration >= 10) {
                killTimer(d->spinClickTimerId);
                d->spinClickTimerId = startTimer(d->spinClickTimerInterval - d->acceleration);
            }
        }
        doStep = true;
    }

    if (doStep) {
        const StepEnabled st = stepEnabled();
        if (d->buttonState & Up) {
            if (!(st & StepUpEnabled)) {
                d->reset();
            } else {
                stepBy(1);
            }
        } else if (d->buttonState & Down) {
            if (!(st & StepDownEnabled)) {
                d->reset();
            } else {
                stepBy(-1);
            }
        }
        return;
    }
    QWidget::timerEvent(event);
    return;
}

Here is the call graph for this function:

void QAbstractSpinBox::paintEvent

(

QPaintEvent *

event

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 808 of file qabstractspinbox.cpp.

References QStyle::CC_SpinBox, d, QStyle::drawComplexControl(), p, and QWidget::style().

Referenced by QDateTimeEdit::paintEvent().

{
    Q_D(QAbstractSpinBox);

    QStyleOptionSpinBox opt = d->getStyleOption();
    QPainter p(this);
    style()->drawComplexControl(QStyle::CC_SpinBox, &opt, &p, this);
}

Here is the call graph for this function:

void QAbstractSpinBox::showEvent

(

QShowEvent *

event

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 676 of file qabstractspinbox.cpp.

References d.

{
    Q_D(QAbstractSpinBox);

    d->reset();
    d->updateEdit();
}

QLineEdit * QAbstractSpinBox::lineEdit

(

)

const [protected]

This function returns a pointer to the line edit of the spin box.

Definition at line 576 of file qabstractspinbox.cpp.

References d.

Referenced by setLineEdit(), and text().

{
    Q_D(const QAbstractSpinBox);

    return d->edit;
}

void QAbstractSpinBox::setLineEdit

(

QLineEdit *

lineEdit

)

[protected]

Sets the line edit of the spinbox to be lineEdit instead of the current line edit widget. lineEdit can not be 0.

QAbstractSpinBox takes ownership of the new lineEdit

If QLineEdit::validator() for the lineEdit returns 0, the internal validator of the spinbox will be set on the line edit.

Definition at line 596 of file qabstractspinbox.cpp.

References QObject::connect(), d, QVariant::Invalid, QWidget::isVisible(), lineEdit(), Qt::NoContextMenu, SIGNAL, SLOT, and Qt::WA_InputMethodEnabled.

{
    Q_D(QAbstractSpinBox);

    if (!lineEdit) {
        Q_ASSERT(lineEdit);
        return;
    }
    delete d->edit;
    d->edit = lineEdit;
    if (!d->edit->validator())
        d->edit->setValidator(d->validator);

    if (d->edit->parent() != this)
        d->edit->setParent(this);

    d->edit->setFrame(false);
    d->edit->setAttribute(Qt::WA_InputMethodEnabled, false);
    d->edit->setFocusProxy(this);
    d->edit->setAcceptDrops(false);

    if (d->type != QVariant::Invalid) {
        connect(d->edit, SIGNAL(textChanged(QString)),
                this, SLOT(_q_editorTextChanged(QString)));
        connect(d->edit, SIGNAL(cursorPositionChanged(int,int)),
                this, SLOT(_q_editorCursorPositionChanged(int,int)));
    }
    d->updateEditFieldGeometry();
    d->edit->setContextMenuPolicy(Qt::NoContextMenu);

    if (isVisible())
        d->edit->show();
    if (isVisible())
        d->updateEdit();
}

Here is the call graph for this function:

QAbstractSpinBox::StepEnabled QAbstractSpinBox::stepEnabled

(

)

const [protected, virtual]

Virtual function that determines whether stepping up and down is legal at any given time.

The up arrow will be painted as disabled unless (stepEnabled() & StepUpEnabled) != 0.

The default implementation will return (StepUpEnabled| StepDownEnabled) if wrapping is turned on. Else it will return StepDownEnabled if value is > minimum() or'ed with StepUpEnabled if value < maximum().

If you subclass QAbstractSpinBox you will need to reimplement this function.

See also:

QSpinBox::minimum(), QSpinBox::maximum(), wrapping()

Definition at line 475 of file qabstractspinbox.cpp.

References d, QVariant::Invalid, StepDownEnabled, StepNone, and StepUpEnabled.

Referenced by contextMenuEvent(), keyPressEvent(), mouseMoveEvent(), mousePressEvent(), timerEvent(), and wheelEvent().

{
    Q_D(const QAbstractSpinBox);
    if (d->readOnly || d->type == QVariant::Invalid)
        return StepNone;
    if (d->wrapping)
        return StepEnabled(StepUpEnabled | StepDownEnabled);
    StepEnabled ret = StepNone;
    if (d->variantCompare(d->value, d->maximum) < 0) {
        ret |= StepUpEnabled;
    }
    if (d->variantCompare(d->value, d->minimum) > 0) {
        ret |= StepDownEnabled;
    }
    return ret;
}

void QAbstractSpinBox::editingFinished

(

)

[signal]

This signal is emitted editing is finished. This happens when the spinbox loses focus and when enter is pressed.

Referenced by focusOutEvent(), keyPressEvent(), QDateTimeEdit::keyPressEvent(), qdesigner_internal::QtSpinBox::stepBy(), and qdesigner_internal::QtDoubleSpinBox::stepBy().

QAbstractSpinBox::Q_PRIVATE_SLOT	(	d_func()	,
		void	_q_editorTextChanged(const QString &)
	)			[private]

---

The documentation for this class was generated from the following files:

• src/gui/widgets/qabstractspinbox.h
• src/gui/widgets/qabstractspinbox.cpp

---