![]() |
CopperSpice API
1.9.2
|
The QAbstractSpinBox class provides a spinbox and a line edit to display values. More...
Public Typedefs | |
using | StepEnabled = QFlags< StepEnabledFlag > |
![]() | |
using | RenderFlags = QFlags< RenderFlag > |
Public Types | |
enum | ButtonSymbols |
enum | CorrectionMode |
enum | StepEnabledFlag |
![]() | |
enum | RenderFlag |
![]() | |
enum | PaintDeviceMetric |
Public Signals | |
void | editingFinished () |
![]() | |
void | customContextMenuRequested (const QPoint &pos) |
void | windowIconChanged (const QIcon &icon) |
void | windowIconTextChanged (const QString &iconText) |
void | windowTitleChanged (const QString &title) |
![]() | |
void | destroyed (QObject *obj=nullptr) |
void | objectNameChanged (const QString &objectName) |
Public Slots | |
virtual void | clear () |
void | selectAll () |
void | stepDown () |
void | stepUp () |
![]() | |
bool | close () |
void | hide () |
void | lower () |
void | raise () |
void | repaint () |
void | setDisabled (bool disable) |
void | setEnabled (bool enable) |
void | setFocus () |
void | setHidden (bool hidden) |
void | setStyleSheet (const QString &styleSheet) |
virtual void | setVisible (bool visible) |
void | setWindowModified (bool modified) |
void | setWindowTitle (const QString &title) |
void | show () |
void | showFullScreen () |
void | showMaximized () |
void | showMinimized () |
void | showNormal () |
void | update () |
![]() | |
void | deleteLater () |
Public Methods | |
QAbstractSpinBox (QWidget *parent=nullptr) | |
~QAbstractSpinBox () | |
Qt::Alignment | alignment () const |
ButtonSymbols | buttonSymbols () const |
CorrectionMode | correctionMode () const |
bool | event (QEvent *event) override |
virtual void | fixup (QString &input) const |
bool | hasAcceptableInput () const |
bool | hasFrame () const |
QVariant | inputMethodQuery (Qt::InputMethodQuery query) const override |
void | interpretText () |
bool | isAccelerated () const |
bool | isGroupSeparatorShown () const |
bool | isReadOnly () const |
bool | keyboardTracking () const |
QSize | minimumSizeHint () const override |
void | setAccelerated (bool on) |
void | setAlignment (Qt::Alignment flag) |
void | setButtonSymbols (ButtonSymbols symbols) |
void | setCorrectionMode (CorrectionMode cm) |
void | setFrame (bool enable) |
void | setGroupSeparatorShown (bool shown) |
void | setKeyboardTracking (bool enable) |
void | setReadOnly (bool enable) |
void | setSpecialValueText (const QString &txt) |
void | setWrapping (bool wrapping) |
QSize | sizeHint () const override |
QString | specialValueText () const |
virtual void | stepBy (int steps) |
QString | text () const |
virtual QValidator::State | validate (QString &input, int &pos) const |
bool | wrapping () const |
![]() | |
QWidget (QWidget *parent=nullptr, Qt::WindowFlags flags=Qt::EmptyFlag) | |
~QWidget () | |
bool | acceptDrops () const |
QString | accessibleDescription () const |
QString | accessibleName () const |
QList< QAction * > | actions () const |
void | activateWindow () |
void | addAction (QAction *action) |
void | addActions (const QList< QAction * > &actions) |
void | adjustSize () |
bool | autoFillBackground () const |
QPalette::ColorRole | backgroundRole () const |
QBackingStore * | backingStore () const |
QSize | baseSize () const |
QWidget * | childAt (const QPoint &position) const |
QWidget * | childAt (int x, int y) const |
QRect | childrenRect () const |
QRegion | childrenRegion () const |
void | clearFocus () |
void | clearMask () |
QMargins | contentsMargins () const |
QRect | contentsRect () const |
Qt::ContextMenuPolicy | contextMenuPolicy () const |
QCursor | cursor () const |
WId | effectiveWinId () const |
void | ensurePolished () const |
Qt::FocusPolicy | focusPolicy () const |
QWidget * | focusProxy () const |
QWidget * | focusWidget () const |
const QFont & | font () const |
QFontInfo | fontInfo () const |
QFontMetrics | fontMetrics () const |
QPalette::ColorRole | foregroundRole () const |
QRect | frameGeometry () const |
QSize | frameSize () const |
const QRect & | geometry () const |
void | getContentsMargins (int *left, int *top, int *right, int *bottom) const |
QPixmap | grab (const QRect &rectangle=QRect (QPoint (0, 0), QSize (-1,-1))) |
void | grabGesture (Qt::GestureType gestureType, Qt::GestureFlags flags=Qt::GestureFlags ()) |
void | grabKeyboard () |
void | grabMouse () |
void | grabMouse (const QCursor &cursor) |
int | grabShortcut (const QKeySequence &key, Qt::ShortcutContext context=Qt::WindowShortcut) |
QGraphicsEffect * | graphicsEffect () const |
QGraphicsProxyWidget * | graphicsProxyWidget () const |
bool | hasEditFocus () const |
bool | hasFocus () const |
virtual bool | hasHeightForWidth () const |
bool | hasMouseTracking () const |
int | height () const |
virtual int | heightForWidth (int width) const |
Qt::InputMethodHints | inputMethodHints () const |
void | insertAction (QAction *before, QAction *action) |
void | insertActions (QAction *before, QList< QAction * > actions) |
bool | isActiveWindow () const |
bool | isAncestorOf (const QWidget *child) const |
bool | isEnabled () const |
bool | isEnabledTo (const QWidget *parent) const |
bool | isEnabledToTLW () const |
bool | isFullScreen () const |
bool | isHidden () const |
bool | isMaximized () const |
bool | isMinimized () const |
bool | isModal () const |
bool | isTopLevel () const |
bool | isVisible () const |
bool | isVisibleTo (const QWidget *parent) const |
bool | isWindow () const |
bool | isWindowModified () const |
QLayout * | layout () const |
Qt::LayoutDirection | layoutDirection () const |
QLocale | locale () const |
QPoint | mapFrom (const QWidget *parent, const QPoint &pos) const |
QPoint | mapFromGlobal (const QPoint &pos) const |
QPoint | mapFromParent (const QPoint &pos) const |
QPoint | mapTo (const QWidget *parent, const QPoint &pos) const |
QPoint | mapToGlobal (const QPoint &pos) const |
QPoint | mapToParent (const QPoint &pos) const |
QRegion | mask () const |
int | maximumHeight () const |
QSize | maximumSize () const |
int | maximumWidth () const |
int | minimumHeight () const |
QSize | minimumSize () const |
int | minimumWidth () const |
void | move (const QPoint &point) |
void | move (int x, int y) |
QWidget * | nativeParentWidget () const |
QWidget * | nextInFocusChain () const |
QRect | normalGeometry () const |
void | overrideWindowFlags (Qt::WindowFlags flags) |
QPaintEngine * | paintEngine () const override |
const QPalette & | palette () const |
QWidget * | parentWidget () const |
QPoint | pos () const |
QWidget * | previousInFocusChain () const |
QRect | rect () const |
void | releaseKeyboard () |
void | releaseMouse () |
void | releaseShortcut (int id) |
void | removeAction (QAction *action) |
void | render (QPaintDevice *target, const QPoint &targetOffset=QPoint (), const QRegion &sourceRegion=QRegion (), RenderFlags renderFlags=RenderFlags (DrawWindowBackground|DrawChildren)) |
void | render (QPainter *painter, const QPoint &targetOffset=QPoint (), const QRegion &sourceRegion=QRegion (), RenderFlags renderFlags=RenderFlags (DrawWindowBackground|DrawChildren)) |
void | repaint (const QRect &rect) |
void | repaint (const QRegion ®ion) |
void | repaint (int x, int y, int w, int h) |
void | resize (const QSize &size) |
void | resize (int w, int h) |
bool | restoreGeometry (const QByteArray &geometry) |
QByteArray | saveGeometry () const |
void | scroll (int dx, int dy) |
void | scroll (int dx, int dy, const QRect &rect) |
void | setAcceptDrops (bool on) |
void | setAccessibleDescription (const QString &description) |
void | setAccessibleName (const QString &name) |
void | setAttribute (Qt::WidgetAttribute attribute, bool enable=true) |
void | setAutoFillBackground (bool enable) |
void | setBackgroundRole (QPalette::ColorRole role) |
void | setBaseSize (const QSize &size) |
void | setBaseSize (int basew, int baseh) |
void | setContentsMargins (const QMargins &margins) |
void | setContentsMargins (int left, int top, int right, int bottom) |
void | setContextMenuPolicy (Qt::ContextMenuPolicy policy) |
void | setCursor (const QCursor &cursor) |
void | setEditFocus (bool enable) |
void | setFixedHeight (int h) |
void | setFixedSize (const QSize &size) |
void | setFixedSize (int w, int h) |
void | setFixedWidth (int w) |
void | setFocus (Qt::FocusReason reason) |
void | setFocusPolicy (Qt::FocusPolicy policy) |
void | setFocusProxy (QWidget *widget) |
void | setFont (const QFont &font) |
void | setForegroundRole (QPalette::ColorRole role) |
void | setGeometry (const QRect &rect) |
void | setGeometry (int x, int y, int w, int h) |
void | setGraphicsEffect (QGraphicsEffect *effect) |
void | setInputMethodHints (Qt::InputMethodHints hints) |
void | setLayout (QLayout *layout) |
void | setLayoutDirection (Qt::LayoutDirection direction) |
void | setLocale (const QLocale &locale) |
void | setMask (const QBitmap &bitmap) |
void | setMask (const QRegion ®ion) |
void | setMaximumHeight (int maxh) |
void | setMaximumSize (const QSize &size) |
void | setMaximumSize (int maxw, int maxh) |
void | setMaximumWidth (int maxw) |
void | setMinimumHeight (int minh) |
void | setMinimumSize (const QSize &size) |
void | setMinimumSize (int minw, int minh) |
void | setMinimumWidth (int minw) |
void | setMouseTracking (bool enable) |
void | setPalette (const QPalette &palette) |
void | setParent (QWidget *parent) |
void | setParent (QWidget *parent, Qt::WindowFlags flags) |
void | setShortcutAutoRepeat (int id, bool enable=true) |
void | setShortcutEnabled (int id, bool enable=true) |
void | setSizeIncrement (const QSize &size) |
void | setSizeIncrement (int w, int h) |
void | setSizePolicy (QSizePolicy policy) |
void | setSizePolicy (QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical) |
void | setStatusTip (const QString &data) |
void | setStyle (QStyle *style) |
void | setToolTip (const QString &data) |
void | setToolTipDuration (int msec) |
void | setUpdatesEnabled (bool enable) |
void | setWhatsThis (const QString &str) |
void | setWindowFilePath (const QString &filePath) |
void | setWindowFlags (Qt::WindowFlags flags) |
void | setWindowIcon (const QIcon &icon) |
void | setWindowModality (Qt::WindowModality windowModality) |
void | setWindowOpacity (qreal level) |
void | setWindowRole (const QString &role) |
void | setWindowState (Qt::WindowStates windowState) |
QSize | size () const |
QSize | sizeIncrement () const |
QSizePolicy | sizePolicy () const |
void | stackUnder (QWidget *widget) |
QString | statusTip () const |
QStyle * | style () const |
QString | styleSheet () const |
bool | testAttribute (Qt::WidgetAttribute attribute) const |
QString | toolTip () const |
int | toolTipDuration () const |
QWidget * | topLevelWidget () const |
bool | underMouse () const |
void | ungrabGesture (Qt::GestureType gestureType) |
void | unsetCursor () |
void | unsetLayoutDirection () |
void | unsetLocale () |
void | update (const QRect &rect) |
void | update (const QRegion ®ion) |
void | update (int x, int y, int w, int h) |
void | updateGeometry () |
bool | updatesEnabled () const |
QRegion | visibleRegion () const |
QString | whatsThis () const |
int | width () const |
QWidget * | window () const |
QString | windowFilePath () const |
Qt::WindowFlags | windowFlags () const |
QWindow * | windowHandle () const |
QIcon | windowIcon () const |
Qt::WindowModality | windowModality () const |
qreal | windowOpacity () const |
QString | windowRole () const |
Qt::WindowStates | windowState () const |
QString | windowTitle () const |
Qt::WindowType | windowType () const |
WId | winId () const |
int | x () const |
int | y () const |
![]() | |
QObject (QObject *parent=nullptr) | |
~QObject () | |
bool | blockSignals (bool block) |
const QList< QObject * > & | children () const |
bool | connect (const QObject *sender, const QString &signalMethod, const QString &location, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection) |
bool | connect (const QObject *sender, const QString &signalMethod, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection) |
bool | disconnect (const QObject *receiver, const QString &slotMethod=QString ()) const |
bool | disconnect (const QString &signalMethod, const QString &location, const QObject *receiver=nullptr, const QString &slotMethod=QString ()) const |
bool | disconnect (const QString &signalMethod=QString (), const QObject *receiver=nullptr, const QString &slotMethod=QString ()) const |
void | dumpObjectInfo () |
void | dumpObjectTree () |
QList< QString > | dynamicPropertyNames () const |
virtual bool | event (QEvent *event) |
virtual bool | eventFilter (QObject *watched, QEvent *event) |
template<typename T > | |
T | findChild (const QString &childName=QString ()) const |
template<class T > | |
QList< T > | findChildren (const QRegularExpression ®Exp, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const |
template<class T > | |
QList< T > | findChildren (const QString &childName=QString (), Qt::FindChildOptions options=Qt::FindChildrenRecursively) const |
bool | inherits (const QString &className) const |
void | installEventFilter (QObject *filterObj) |
bool | isWidgetType () const |
bool | isWindowType () const |
void | killTimer (int id) |
const QMetaObject * | metaObject () const |
void | moveToThread (QThread *targetThread) |
QString | objectName () const |
QObject * | parent () const |
template<class T = QVariant> | |
T | property (const QString &name) const |
void | removeEventFilter (QObject *obj) |
void | setObjectName (const QString &name) |
void | setParent (QObject *parent) |
bool | setProperty (const QString &name, const QVariant &value) |
bool | signalsBlocked () const |
int | startTimer (int interval, Qt::TimerType timerType=Qt::CoarseTimer) |
QThread * | thread () const |
![]() | |
virtual | ~QPaintDevice () |
int | colorCount () const |
int | depth () const |
int | devicePixelRatio () const |
qreal | devicePixelRatioF () const |
int | height () const |
int | heightMM () const |
int | logicalDpiX () const |
int | logicalDpiY () const |
bool | paintingActive () const |
int | physicalDpiX () const |
int | physicalDpiY () const |
int | width () const |
int | widthMM () const |
Protected Methods | |
void | changeEvent (QEvent *event) override |
void | closeEvent (QCloseEvent *event) override |
void | contextMenuEvent (QContextMenuEvent *event) override |
void | focusInEvent (QFocusEvent *event) override |
void | focusOutEvent (QFocusEvent *event) override |
void | hideEvent (QHideEvent *event) override |
void | initStyleOption (QStyleOptionSpinBox *option) const |
void | keyPressEvent (QKeyEvent *event) override |
void | keyReleaseEvent (QKeyEvent *event) override |
QLineEdit * | lineEdit () const |
void | mouseMoveEvent (QMouseEvent *event) override |
void | mousePressEvent (QMouseEvent *event) override |
void | mouseReleaseEvent (QMouseEvent *event) override |
void | paintEvent (QPaintEvent *event) override |
void | resizeEvent (QResizeEvent *event) override |
void | setLineEdit (QLineEdit *lineEdit) |
void | showEvent (QShowEvent *event) override |
virtual StepEnabled | stepEnabled () const |
void | timerEvent (QTimerEvent *event) override |
void | wheelEvent (QWheelEvent *event) override |
![]() | |
virtual void | actionEvent (QActionEvent *event) |
void | create (WId window=0, bool initializeWindow=true, bool destroyOldWindow=true) |
void | destroy (bool destroyWindow=true, bool destroySubWindows=true) |
virtual void | dragEnterEvent (QDragEnterEvent *event) |
virtual void | dragLeaveEvent (QDragLeaveEvent *event) |
virtual void | dragMoveEvent (QDragMoveEvent *event) |
virtual void | dropEvent (QDropEvent *event) |
virtual void | enterEvent (QEvent *event) |
bool | event (QEvent *event) override |
bool | focusNextChild () |
virtual bool | focusNextPrevChild (bool next) |
bool | focusPreviousChild () |
void | initPainter (QPainter *painter) const override |
virtual void | inputMethodEvent (QInputMethodEvent *event) |
virtual void | leaveEvent (QEvent *event) |
int | metric (PaintDeviceMetric metric) const override |
virtual void | mouseDoubleClickEvent (QMouseEvent *event) |
virtual void | moveEvent (QMoveEvent *event) |
virtual bool | nativeEvent (const QByteArray &eventType, void *message, long *result) |
virtual void | tabletEvent (QTabletEvent *event) |
![]() | |
virtual void | childEvent (QChildEvent *event) |
virtual void | connectNotify (const QMetaMethod &signalMethod) const |
virtual void | customEvent (QEvent *event) |
virtual void | disconnectNotify (const QMetaMethod &signalMethod) const |
bool | isSignalConnected (const QMetaMethod &signalMethod) const |
int | receivers (const QString &signal) const |
QObject * | sender () const |
int | senderSignalIndex () const |
virtual void | timerEvent (QTimerEvent *event) |
![]() | |
QPaintDevice () | |
Additional Inherited Members | |
![]() | |
static QWidget * | createWindowContainer (QWindow *window, QWidget *parent=nullptr, Qt::WindowFlags flags=Qt::EmptyFlag) |
static QWidget * | find (WId id) |
static QWidget * | keyboardGrabber () |
static QWidget * | mouseGrabber () |
static void | setTabOrder (QWidget *firstWidget, QWidget *secondWidget) |
![]() | |
static bool | connect (const QObject *sender, const QMetaMethod &signalMethod, const QObject *receiver, const QMetaMethod &slotMethod, Qt::ConnectionType type=Qt::AutoConnection) |
static bool | connect (const QObject *sender, const QString &signalMethod, const QObject *receiver, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection, const QString &location=QString ()) |
static bool | connect (const QObject *sender, const QString &signalMethod, const QString &location, const QObject *receiver, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection) |
template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class SlotClass , class... SlotArgs, class SlotReturn > | |
static bool | connect (const Sender *sender, void (SignalClass::*signalMethod)(SignalArgs...), const Receiver *receiver, SlotReturn (SlotClass::*slotMethod)(SlotArgs...), Qt::ConnectionType type=Qt::AutoConnection) |
template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class T > | |
static bool | connect (const Sender *sender, void (SignalClass::*signalMethod)(SignalArgs...), const Receiver *receiver, T slotLambda, Qt::ConnectionType type=Qt::AutoConnection) |
static bool | disconnect (const QObject *sender, const QMetaMethod &signalMethod, const QObject *receiver, const QMetaMethod &slotMethod) |
static bool | disconnect (const QObject *sender, const QString &signalMethod, const QObject *receiver, const QString &slotMethod) |
static bool | disconnect (const QObject *sender, const QString &signalMethod, const QString &location, const QObject *receiver, const QString &slotMethod) |
static bool | disconnect (const QObject *sender, std::nullptr_t, const QObject *receiver, std::nullptr_t) |
template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class SlotClass , class... SlotArgs, class SlotReturn > | |
static bool | disconnect (const Sender *sender, void (SignalClass::*signalMethod)(SignalArgs...), const Receiver *receiver, SlotReturn (SlotClass::*slotMethod)(SlotArgs...)) |
template<class Sender , class SignalClass , class... SignalArgs, class Receiver > | |
static bool | disconnect (const Sender *sender, void (SignalClass::*signalMethod)(SignalArgs...), const Receiver *receiver, std::nullptr_t slotMethod=nullptr) |
template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class T > | |
static bool | disconnect (const Sender *sender, void (SignalClass::*signalMethod)(SignalArgs...), const Receiver *receiver, T slotMethod) |
static QMetaObject & | staticMetaObject () |
static QString | tr (const char *text, const char *comment=nullptr, std::optional< int > numArg=std::optional< int >()) |
![]() | |
void | updateMicroFocus () |
![]() | |
QWidgetList | |
WId | |
![]() | |
T | qobject_cast (QObject *object) |
QObjectList | |
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.
The following are the main properties of the class.
QAbstractSpinBox provides a virtual stepBy() method that is called whenever the user triggers a step. This method takes an integer value to signify how many steps were taken. For example, pressing Qt::Key_Down will trigger a call to stepBy(-1).
QAbstractSpinBox also provide a virtual method stepEnabled() to determine whether stepping up/down is allowed at any point. This method returns a bitset of StepEnabled.
Typedef for QFlags<StepEnabledFlag> which contains an OR combination of StepEnabledFlag values.
Refer to QAbstractSpinBox::StepEnabledFlag for the enum documentation.
This enum type describes the symbols that can be displayed on the buttons in a spin box.
Constant | Value | Description |
---|---|---|
QAbstractSpinBox::UpDownArrows | 0 | Little arrows in the classic style. |
QAbstractSpinBox::PlusMinus | 1 | + and - symbols. |
QAbstractSpinBox::NoButtons | 2 | Do not display buttons. |
This enum type describes the mode the spinbox will use to correct an Intermediate value if editing finishes.
Constant | Value | Description |
---|---|---|
QAbstractSpinBox::CorrectToPreviousValue | 0 | The spinbox will revert to the last valid value. |
QAbstractSpinBox::CorrectToNearestValue | 1 | The spinbox will revert to the nearest valid value. |
This enum type describes the behavior of the step buttons.
Constant | Value |
---|---|
QAbstractSpinBox::StepNone | 0x00 |
QAbstractSpinBox::StepUpEnabled | 0x01 |
QAbstractSpinBox::StepDownEnabled | 0x02 |
|
explicit |
Constructs an abstract spinbox with the given parent with default wrapping, and alignment properties.
QAbstractSpinBox::~QAbstractSpinBox | ( | ) |
Destroys this QAbstractSpinBox object.
Qt::Alignment QAbstractSpinBox::alignment | ( | ) | const |
Returns the value of the property.
ButtonSymbols QAbstractSpinBox::buttonSymbols | ( | ) | const |
Returns the value of the property.
|
overrideprotectedvirtual |
Reimplemented from QWidget::changeEvent()
|
slot |
Clears the lineedit of all text but prefix and suffix.
|
overrideprotectedvirtual |
Reimplemented from QWidget::closeEvent()
|
overrideprotectedvirtual |
Reimplemented from QWidget::contextMenuEvent()
CorrectionMode QAbstractSpinBox::correctionMode | ( | ) | const |
Returns the value of the property.
|
signal |
This signal is emitted when editing is finished. This happens when the spinbox loses focus and when enter is pressed.
|
override |
Reimplemented from QWidget::event()
|
virtual |
This virtual method 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.
This method is reimplemented in the various subclasses.
Reimplemented in QDateTimeEdit::fixup(), QDoubleSpinBox::fixup(), QSpinBox::fixup()
|
overrideprotectedvirtual |
Reimplemented from QWidget::focusInEvent()
Reimplemented in QDateTimeEdit::focusInEvent()
|
overrideprotectedvirtual |
Reimplemented from QWidget::focusOutEvent()
bool QAbstractSpinBox::hasAcceptableInput | ( | ) | const |
Returns the value of the property.
bool QAbstractSpinBox::hasFrame | ( | ) | const |
Returns the value of the property.
|
overrideprotectedvirtual |
Reimplemented from QWidget::hideEvent()
|
protected |
Initialize option with the values from this QSpinBox. This method is useful for subclasses when they need a QStyleOptionSpinBox, but do not want to fill in all the information themselves.
|
overridevirtual |
Reimplemented from QWidget::inputMethodQuery()
void QAbstractSpinBox::interpretText | ( | ) |
This method interprets the text of the spin box. If the value has changed since last interpretation it will emit signals.
bool QAbstractSpinBox::isAccelerated | ( | ) | const |
Returns the value of the property.
bool QAbstractSpinBox::isGroupSeparatorShown | ( | ) | const |
Returns the value of the property.
bool QAbstractSpinBox::isReadOnly | ( | ) | const |
Returns the value of the property.
bool QAbstractSpinBox::keyboardTracking | ( | ) | const |
Returns the value of the property.
|
overrideprotectedvirtual |
This method handles keyboard input. The following keys are handled specifically.
Key | Description |
---|---|
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 | Invokes stepBy(1) |
Down | Invokes stepBy(-1) |
Page up | Invokes stepBy(10) |
Page down | Invokes stepBy(-10) |
Reimplemented from QWidget::keyPressEvent()
Reimplemented in QDateTimeEdit::keyPressEvent()
|
overrideprotectedvirtual |
Reimplemented from QWidget::keyReleaseEvent()
|
protected |
This method returns a pointer to the line edit of the spin box.
|
overridevirtual |
Reimplemented from QWidget::minimumSizeHint()
|
overrideprotectedvirtual |
Reimplemented from QWidget::mouseMoveEvent()
|
overrideprotectedvirtual |
Reimplemented from QWidget::mousePressEvent()
Reimplemented in QDateTimeEdit::mousePressEvent()
|
overrideprotectedvirtual |
Reimplemented from QWidget::mouseReleaseEvent()
|
overrideprotectedvirtual |
Reimplemented from QWidget::paintEvent()
Reimplemented in QDateTimeEdit::paintEvent()
|
overrideprotectedvirtual |
Reimplemented from QWidget::resizeEvent()
|
slot |
Selects all the text in the spinbox except the prefix and suffix.
void QAbstractSpinBox::setAccelerated | ( | bool | on | ) |
Sets the value for the accelerated property using on.
void QAbstractSpinBox::setAlignment | ( | Qt::Alignment | flag | ) |
Sets the value for the alignment property using flag.
void QAbstractSpinBox::setButtonSymbols | ( | ButtonSymbols | symbols | ) |
Sets the value for the button symbols property using symbols.
void QAbstractSpinBox::setCorrectionMode | ( | CorrectionMode | cm | ) |
Sets the value for the correction mode property using cm.
void QAbstractSpinBox::setFrame | ( | bool | enable | ) |
Sets the value for the frame property using enable.
void QAbstractSpinBox::setGroupSeparatorShown | ( | bool | shown | ) |
Sets the value of the property to shown.
void QAbstractSpinBox::setKeyboardTracking | ( | bool | enable | ) |
Sets the value for the keyboard tracking property using enable.
|
protected |
Sets the line edit of the spinbox to be lineEdit instead of the current line edit widget. The given lineEdit can not be a nullptr. If QLineEdit::validator() for the lineEdit returns a nullptr, the internal validator of the spinbox will be set on the line edit.
QAbstractSpinBox takes ownership of the new lineEdit.
void QAbstractSpinBox::setReadOnly | ( | bool | enable | ) |
Sets the value for the read only property using enable.
void QAbstractSpinBox::setSpecialValueText | ( | const QString & | txt | ) |
Sets the value for the special value property using txt.
void QAbstractSpinBox::setWrapping | ( | bool | wrapping | ) |
Sets the value for the special-value property using wrapping.
|
overrideprotectedvirtual |
Reimplemented from QWidget::showEvent()
|
overridevirtual |
Reimplemented from QWidget::sizeHint()
Reimplemented in QDateTimeEdit::sizeHint()
QString QAbstractSpinBox::specialValueText | ( | ) | const |
Returns the value of the property.
|
virtual |
Called whenever the user triggers a step. The steps parameter indicates how many steps were taken. For example, pressing Qt::Key_Down will trigger a call to stepBy(-1) and pressing Qt::Key_Prior will trigger a call to stepBy(10). This method is called even if the resulting value will be outside the bounds of minimum and maximum.
Classes which inherit from QAbstractSpinBox should reimplement this method.
Reimplemented in QDateTimeEdit::stepBy()
|
slot |
|
protectedvirtual |
Determines whether stepping up and down is legal at any given time.
If wrapping is enabled this method will return (StepUpEnabled | StepDownEnabled). If wrapping is disabled and the value of the spin box is equal to the minimum value, this method will return StepUpEnabled. If wrapping is disabled and the value of the spin box is equal to the maximum value, this method will return StepDownEnabled.
Classes which inherit from QAbstractSpinBox should reimplement this method.
Reimplemented in QDateTimeEdit::stepEnabled()
|
slot |
Steps up by one linestep. Calling this slot is analogous to calling stepBy(1).
QString QAbstractSpinBox::text | ( | ) | const |
Returns the value of the property.
|
overrideprotected |
Reimplemented from QObject::timerEvent()
|
virtual |
This method is used to validate the given input. The pos parameter indicates the current position in the string. Any class which inherits from QAbstractSpinBox should reimplement this method.
Reimplemented in QDateTimeEdit::validate(), QDoubleSpinBox::validate(), QSpinBox::validate()
|
overrideprotectedvirtual |
Reimplemented from QWidget::wheelEvent()
Reimplemented in QDateTimeEdit::wheelEvent()
bool QAbstractSpinBox::wrapping | ( | ) | const |
Returns the value of the property.
|
This property holds whether the spin box will accelerate the frequency of the steps when pressing the step Up/Down buttons. If enabled the spin box will increase/decrease the value faster the longer you hold the button down.
Properties | Class Methods |
---|---|
read | isAccelerated |
write | setAccelerated |
|
This property holds whether the input satisfies the current validation.
Properties | Class Methods |
---|---|
read | hasAcceptableInput |
|
This property holds the alignment of the spin box. Possible Values are Qt::AlignLeft, Qt::AlignRight, and Qt::AlignHCenter. By default, the alignment is Qt::AlignLeft. Attempting to set the alignment to an illegal flag combination does nothing.
Properties | Class Methods |
---|---|
read | alignment |
write | setAlignment |
|
This property holds the current button symbol mode. The possible values can be either UpDownArrows
or PlusMinus
. The default is UpDownArrows
. Some styles might render PlusMinus and UpDownArrows identically.
Properties | Class Methods |
---|---|
read | buttonSymbols |
write | setButtonSymbols |
|
This property holds the mode to correct an Intermediate value if editing finishes. The default mode is QAbstractSpinBox::CorrectToPreviousValue.
Properties | Class Methods |
---|---|
read | correctionMode |
write | setCorrectionMode |
|
This property holds whether the spin box draws itself with a frame. If enabled (the default) the spin box draws itself inside a frame, otherwise the spin box draws itself without any frame.
Properties | Class Methods |
---|---|
read | hasFrame |
write | setFrame |
|
This property holds whether keyboard tracking is enabled for the current spinbox. If keyboard tracking is enabled (the default) the spinbox emits the valueChanged() signal while the new value is being entered from the keyboard. For example, when the user enters the value 600 by typing 6, 0, and 0, the spinbox emits 3 signals with the values 6, 60, and 600 respectively.
If keyboard tracking is disabled, the spinbox does not emit the valueChanged() signal while the user is typing. In this case the signal will be emitted later when the return key is pressed, keyboard focus is lost, or when some other other spinbox input occurs.
Properties | Class Methods |
---|---|
read | keyboardTracking |
write | setKeyboardTracking |
|
This property holds whether the spin box is read only. In read only mode, the user can still copy the text to the clipboard, or drag and drop the text; but can not edit it. The QLineEdit in the QAbstractSpinBox does not show a cursor in read only mode.
Properties | Class Methods |
---|---|
read | isReadOnly |
write | setReadOnly |
|
This property holds the special-value text. If no special-value text is set then specialValueText() returns an empty string. The default is no special-value text.
If set, the spin box will display this text instead of a numeric value whenever the current value is equal to minimum(). Typical use is to indicate that this choice has a special (default) meaning. For example, if your spin box allows the user to choose a scale factor (or zoom level) for displaying an image, and your application is able to automatically choose one that will enable the image to fit completely within the display window, you can set up the spin box like this.
The user will then be able to choose a scale from 1% to 1000% or select "Automatic" to leave it up to the application to choose. Your code must then interpret the spin box value of 0 as a request from the user to scale the image to fit inside the window.
All values are displayed with the prefix and suffix (if set), except for the special value, which only shows the special value text. This special text is passed in the QSpinBox::valueChanged() signal that passes a QString.
Properties | Class Methods |
---|---|
read | specialValueText |
write | setSpecialValueText |
|
This property holds the spin box's text, including any prefix and suffix. There is no default text.
Properties | Class Methods |
---|---|
read | text |
|
This property holds whether the spin box is circular. If wrapping is true stepping up from maximum() value will take you to the minimum() value and vice versa. Wrapping only make sense if you have minimum() and maximum() values set.
Properties | Class Methods |
---|---|
read | wrapping |
write | setWrapping |