Class: QgsSpinBox

class qgis.gui.QgsSpinBox

Bases: PyQt5.QtWidgets.QSpinBox

The QgsSpinBox is a spin box with a clear button that will set the value to the defined clear value. The clear value can be either the minimum or the maiximum value of the spin box or a custom value. This value can then be handled by a special value text.

QgsSpinBox(parent: QWidget = None) Constructor for QgsSpinBox.

Parameters:

parent

parent widget

Methods

actionEvent

changeEvent

param event:

childEvent

clear

Sets the current value to the value defined by the clear value.

clearValue

Returns the value used when clear() is called.

closeEvent

connectNotify

contextMenuEvent

create

customEvent

destroy

disconnectNotify

dragEnterEvent

dragLeaveEvent

dragMoveEvent

dropEvent

enterEvent

event

expressionsEnabled

Returns whether the widget will allow entry of simple expressions, which are evaluated and then discarded.

fixup

focusInEvent

focusNextChild

focusNextPrevChild

focusOutEvent

focusPreviousChild

hideEvent

initPainter

initStyleOption

inputMethodEvent

isSignalConnected

keyPressEvent

keyReleaseEvent

leaveEvent

lineEdit

metric

mouseDoubleClickEvent

mouseMoveEvent

mousePressEvent

mouseReleaseEvent

moveEvent

nativeEvent

paintEvent

param event:

receivers

resizeEvent

sender

senderSignalIndex

setClearValue

Defines the clear value as a custom value and will automatically set the clear value mode to CustomValue.

setClearValueMode

Defines if the clear value should be the minimum or maximum values of the widget or a custom value.

setExpressionsEnabled

Sets if the widget will allow entry of simple expressions, which are evaluated and then discarded.

setLineEdit

setLineEditAlignment

Set alignment in the embedded line edit widget

setShowClearButton

Sets whether the widget will show a clear button.

setSpecialValueText

Set the special-value text to be txt If set, the spin box will display this text instead of a numeric value whenever the current value is equal to minimum().

sharedPainter

showClearButton

Returns whether the widget is showing a clear button.

showEvent

stepEnabled

tabletEvent

textFromValue

timerEvent

param event:

updateMicroFocus

validate

param input:

valueFromText

param text:

wheelEvent

param event:

Attributes

CustomValue

MaximumValue

MinimumValue

class ClearValueMode

Bases: int

CustomValue = 2
MaximumValue = 1
MinimumValue = 0
actionEvent(self, QActionEvent)
changeEvent(self, event: QEvent)
Parameters:

event (QEvent) –

childEvent(self, QChildEvent)
clear(self)

Sets the current value to the value defined by the clear value.

clearValue(self) int

Returns the value used when clear() is called.

See also

setClearValue()

Return type:

int

closeEvent(self, QCloseEvent)
connectNotify(self, QMetaMethod)
contextMenuEvent(self, QContextMenuEvent)
create(self, window: PyQt5.sip.voidptr = 0, initializeWindow: bool = True, destroyOldWindow: bool = True)
customEvent(self, QEvent)
destroy(self, destroyWindow: bool = True, destroySubWindows: bool = True)
disconnectNotify(self, QMetaMethod)
dragEnterEvent(self, QDragEnterEvent)
dragLeaveEvent(self, QDragLeaveEvent)
dragMoveEvent(self, QDragMoveEvent)
dropEvent(self, QDropEvent)
enterEvent(self, QEvent)
event(self, QEvent) bool
expressionsEnabled(self) bool

Returns whether the widget will allow entry of simple expressions, which are evaluated and then discarded.

Return type:

bool

Returns:

True if spin box allows expression entry

New in version 2.7.

fixup(self, str) str
focusInEvent(self, QFocusEvent)
focusNextChild(self) bool
focusNextPrevChild(self, bool) bool
focusOutEvent(self, QFocusEvent)
focusPreviousChild(self) bool
hideEvent(self, QHideEvent)
initPainter(self, QPainter)
initStyleOption(self, QStyleOptionSpinBox)
inputMethodEvent(self, QInputMethodEvent)
isSignalConnected(self, QMetaMethod) bool
keyPressEvent(self, QKeyEvent)
keyReleaseEvent(self, QKeyEvent)
leaveEvent(self, QEvent)
lineEdit(self) QLineEdit
metric(self, QPaintDevice.PaintDeviceMetric) int
mouseDoubleClickEvent(self, QMouseEvent)
mouseMoveEvent(self, QMouseEvent)
mousePressEvent(self, QMouseEvent)
mouseReleaseEvent(self, QMouseEvent)
moveEvent(self, QMoveEvent)
nativeEvent(self, Union[QByteArray, bytes, bytearray], PyQt5.sip.voidptr) Tuple[bool, int]
paintEvent(self, event: QPaintEvent)
Parameters:

event (QPaintEvent) –

receivers(self, PYQT_SIGNAL) int
resizeEvent(self, QResizeEvent)
sender(self) QObject
senderSignalIndex(self) int
setClearValue(self, customValue: int, clearValueText: str = '')

Defines the clear value as a custom value and will automatically set the clear value mode to CustomValue.

Parameters:
  • customValue (int) – defines the numerical value used as the clear value

  • clearValueText (str = '') – is the text displayed when the spin box is at the clear value. If not specified, no special value text is used.

See also

setClearValue()

setClearValueMode(self, mode: QgsSpinBox.ClearValueMode, clearValueText: str = '')

Defines if the clear value should be the minimum or maximum values of the widget or a custom value.

Parameters:
  • mode (QgsSpinBox.ClearValueMode) – mode to user for clear value

  • clearValueText (str = '') – is the text displayed when the spin box is at the clear value. If not specified, no special value text is used.

setExpressionsEnabled(self, enabled: bool)

Sets if the widget will allow entry of simple expressions, which are evaluated and then discarded.

Parameters:

enabled (bool) – set to True to allow expression entry

New in version 2.7.

setLineEdit(self, QLineEdit)
setLineEditAlignment(self, alignment: Qt.Alignment | Qt.AlignmentFlag)

Set alignment in the embedded line edit widget

Parameters:

alignment (Union[Qt.Alignment) –

setShowClearButton(self, showClearButton: bool)

Sets whether the widget will show a clear button. The clear button allows users to reset the widget to a default or empty state.

Parameters:

showClearButton (bool) – set to True to show the clear button, or False to hide it

setSpecialValueText(self, txt: str)

Set the special-value text to be txt 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.

Parameters:

txt (str) –

sharedPainter(self) QPainter
showClearButton(self) bool

Returns whether the widget is showing a clear button.

Return type:

bool

showEvent(self, QShowEvent)
stepEnabled(self) QAbstractSpinBox.StepEnabled
tabletEvent(self, QTabletEvent)
textFromValue(self, int) str
timerEvent(self, event: QTimerEvent)
Parameters:

event (QTimerEvent) –

updateMicroFocus(self)
validate(self, input: str) Tuple[QValidator.State, int]
Parameters:

input (str) –

Return type:

Tuple[QValidator.State, int]

valueFromText(self, text: str) int
Parameters:

text (str) –

Return type:

int

wheelEvent(self, event: QWheelEvent)
Parameters:

event (QWheelEvent) –