The QgsSpinBox is a spin box with a clear button that will set the value to the defined clear value. More...

#include <qgsdoublespinbox.h>

Inheritance diagram for QgsDoubleSpinBox:

Public Types
enum	ClearValueMode { MinimumValue , MaximumValue , CustomValue }
	Behavior when widget is cleared. More...

Public Member Functions
	QgsDoubleSpinBox (QWidget *parent=nullptr)
	Constructor for QgsDoubleSpinBox. More...

void	clear () override
	Sets the current value to the value defined by the clear value. More...

double	clearValue () const
	Returns the value used when clear() is called. More...

bool	expressionsEnabled () const
	Returns whether the widget will allow entry of simple expressions, which are evaluated and then discarded. More...

void	paintEvent (QPaintEvent *e) override

void	setClearValue (double customValue, const QString &clearValueText=QString())
	Defines the clear value as a custom value and will automatically set the clear value mode to CustomValue. More...

void	setClearValueMode (ClearValueMode mode, const QString &clearValueText=QString())
	Defines if the clear value should be the minimum or maximum values of the widget or a custom value. More...

void	setExpressionsEnabled (bool enabled)
	Sets if the widget will allow entry of simple expressions, which are evaluated and then discarded. More...

void	setLineEditAlignment (Qt::Alignment alignment)
	Set alignment in the embedded line edit widget. More...

void	setShowClearButton (bool showClearButton)
	Sets whether the widget will show a clear button. More...

void	setSpecialValueText (const QString &txt)
	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(). More...

bool	showClearButton () const
	Returns whether the widget is showing a clear button. More...

QValidator::State	validate (QString &input, int &pos) const override

double	valueFromText (const QString &text) const override

Protected Member Functions
void	changeEvent (QEvent *event) override

void	timerEvent (QTimerEvent *event) override

void	wheelEvent (QWheelEvent *event) override

Properties
bool	clearValue

bool	expressionsEnabled

bool	showClearButton

Friends
class	TestQgsRangeWidgetWrapper

Detailed Description

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.

Definition at line 42 of file qgsdoublespinbox.h.

Member Enumeration Documentation

◆ ClearValueMode

enum QgsDoubleSpinBox::ClearValueMode

Behavior when widget is cleared.

Enumerator
MinimumValue	Reset value to minimum()
MaximumValue	Reset value to maximum()
CustomValue	Reset value to custom value (see setClearValue() )

Definition at line 62 of file qgsdoublespinbox.h.

Constructor & Destructor Documentation

◆ QgsDoubleSpinBox()

QgsDoubleSpinBox::QgsDoubleSpinBox ( QWidget * parent = nullptr )

explicit

Constructor for QgsDoubleSpinBox.

Parameters

parent parent widget

Definition at line 39 of file qgsdoublespinbox.cpp.

Member Function Documentation

◆ changeEvent()

void QgsDoubleSpinBox::changeEvent ( QEvent * event )

overrideprotected

Definition at line 66 of file qgsdoublespinbox.cpp.

◆ clear()

void QgsDoubleSpinBox::clear ( )

override

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

Definition at line 122 of file qgsdoublespinbox.cpp.

◆ clearValue()

double QgsDoubleSpinBox::clearValue ( ) const

Returns the value used when clear() is called.

See also: setClearValue()

Definition at line 157 of file qgsdoublespinbox.cpp.

◆ expressionsEnabled()

bool QgsDoubleSpinBox::expressionsEnabled ( ) const

inline

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

Returns: true if spin box allows expression entry

Since: QGIS 2.7

Definition at line 103 of file qgsdoublespinbox.h.

◆ paintEvent()

void QgsDoubleSpinBox::paintEvent ( QPaintEvent * e )

override

Definition at line 111 of file qgsdoublespinbox.cpp.

◆ setClearValue()

void QgsDoubleSpinBox::setClearValue	(	double	customValue,
		const QString &	clearValueText = `QString()`
	)

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

Parameters

customValue	defines the numerical value used as the clear value
clearValueText	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()

Definition at line 129 of file qgsdoublespinbox.cpp.

◆ setClearValueMode()

void QgsDoubleSpinBox::setClearValueMode	(	QgsDoubleSpinBox::ClearValueMode	mode,
		const QString &	clearValueText = `QString()`
	)

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

Parameters

mode	mode to user for clear value
clearValueText	is the text displayed when the spin box is at the clear value. If not specified, no special value text is used.

Definition at line 143 of file qgsdoublespinbox.cpp.

◆ setExpressionsEnabled()

void QgsDoubleSpinBox::setExpressionsEnabled ( bool enabled )

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

Parameters

enabled set to true to allow expression entry

Since: QGIS 2.7

Definition at line 61 of file qgsdoublespinbox.cpp.

◆ setLineEditAlignment()

void QgsDoubleSpinBox::setLineEditAlignment ( Qt::Alignment alignment )

Set alignment in the embedded line edit widget.

Parameters

alignment

Definition at line 167 of file qgsdoublespinbox.cpp.

◆ setShowClearButton()

void QgsDoubleSpinBox::setShowClearButton ( bool showClearButton )

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 set to true to show the clear button, or false to hide it

See also: showClearButton()

Definition at line 55 of file qgsdoublespinbox.cpp.

◆ setSpecialValueText()

void QgsDoubleSpinBox::setSpecialValueText ( const QString & txt )

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.

Definition at line 172 of file qgsdoublespinbox.cpp.

◆ showClearButton()

bool QgsDoubleSpinBox::showClearButton ( ) const

inline

Returns whether the widget is showing a clear button.

See also: setShowClearButton()

Definition at line 87 of file qgsdoublespinbox.h.

◆ timerEvent()

void QgsDoubleSpinBox::timerEvent ( QTimerEvent * event )

overrideprotected

Definition at line 100 of file qgsdoublespinbox.cpp.

◆ validate()

QValidator::State QgsDoubleSpinBox::validate	(	QString &	input,
		int &	pos
	)		const

override

Definition at line 235 of file qgsdoublespinbox.cpp.

◆ valueFromText()

double QgsDoubleSpinBox::valueFromText ( const QString & text ) const

override

Definition at line 219 of file qgsdoublespinbox.cpp.

◆ wheelEvent()

void QgsDoubleSpinBox::wheelEvent ( QWheelEvent * event )

overrideprotected

Definition at line 78 of file qgsdoublespinbox.cpp.

Friends And Related Function Documentation

◆ TestQgsRangeWidgetWrapper

friend class TestQgsRangeWidgetWrapper

friend

Definition at line 171 of file qgsdoublespinbox.h.

Property Documentation

◆ clearValue

bool QgsDoubleSpinBox::clearValue

readwrite

Definition at line 1 of file qgsdoublespinbox.h.

◆ expressionsEnabled

bool QgsDoubleSpinBox::expressionsEnabled

readwrite

Definition at line 1 of file qgsdoublespinbox.h.

◆ showClearButton

bool QgsDoubleSpinBox::showClearButton

readwrite

Definition at line 1 of file qgsdoublespinbox.h.

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

/build/qgis-3.20.0+99unstable/src/gui/editorwidgets/qgsdoublespinbox.h
/build/qgis-3.20.0+99unstable/src/gui/editorwidgets/qgsdoublespinbox.cpp

Public Types

Public Member Functions

Protected Member Functions

Properties

Friends

Detailed Description

Member Enumeration Documentation

◆ ClearValueMode

Constructor & Destructor Documentation

◆ QgsDoubleSpinBox()

Member Function Documentation

◆ changeEvent()

◆ clear()

◆ clearValue()

◆ expressionsEnabled()

◆ paintEvent()

◆ setClearValue()

◆ setClearValueMode()

◆ setExpressionsEnabled()

◆ setLineEditAlignment()

◆ setShowClearButton()

◆ setSpecialValueText()

◆ showClearButton()

◆ timerEvent()

◆ validate()

◆ valueFromText()

◆ wheelEvent()

Friends And Related Function Documentation

◆ TestQgsRangeWidgetWrapper

Property Documentation

◆ clearValue

◆ expressionsEnabled

◆ showClearButton