QDoubleValidator#

The QDoubleValidator class provides range checking of floating-point numbers. More

Inheritance diagram of PySide6.QtGui.QDoubleValidator

Synopsis#

Properties#

  • bottom - The validator’s minimum acceptable value

  • decimals - The validator’s maximum number of digits after the decimal point

  • notation - The notation of how a string can describe a number

  • top - The validator’s maximum acceptable value

Functions#

Signals#

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description#

QDoubleValidator provides an upper bound, a lower bound, and a limit on the number of digits after the decimal point.

You can set the acceptable range in one call with setRange() , or with setBottom() and setTop() . Set the number of decimal places with setDecimals() . The validate() function returns the validation state.

QDoubleValidator uses its locale() to interpret the number. For example, in the German locale, “1,234” will be accepted as the fractional number 1.234. In Arabic locales, QDoubleValidator will accept Arabic digits.

Note

The NumberOptions set on the locale() also affect the way the number is interpreted. For example, since RejectGroupSeparator is not set by default (except on the "C" locale), the validator will accept group separators. If the string passes validation, pass it to locale() .toDouble() to obtain its numeric value.

class PySide6.QtGui.QDoubleValidator([parent=None])#

PySide6.QtGui.QDoubleValidator(bottom, top, decimals[, parent=None])

Parameters:

Constructs a validator object with a parent object that accepts any double.

Constructs a validator object with a parent object. This validator will accept doubles from bottom to top inclusive, with up to decimals digits after the decimal point.

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property PᅟySide6.QtGui.QDoubleValidator.bottom: double#

This property holds the validator’s minimum acceptable value.

By default, this property contains a value of -infinity.

See also

setRange()

Access functions:
property PᅟySide6.QtGui.QDoubleValidator.decimals: int#

This property holds the validator’s maximum number of digits after the decimal point.

By default, this property contains a value of -1, which means any number of digits is accepted.

See also

setRange()

Access functions:
property PᅟySide6.QtGui.QDoubleValidator.notation: Notation#

This property holds the notation of how a string can describe a number.

By default, this property is set to ScientificNotation .

See also

Notation

Access functions:
property PᅟySide6.QtGui.QDoubleValidator.top: double#

This property holds the validator’s maximum acceptable value.

By default, this property contains a value of infinity.

See also

setRange()

Access functions:
PySide6.QtGui.QDoubleValidator.Notation#

This enum defines the allowed notations for entering a double.

Constant

Description

QDoubleValidator.StandardNotation

The string is written in the standard format, a whole number part optionally followed by a separator and fractional part, for example "0.015".

QDoubleValidator.ScientificNotation

The string is written in scientific form, which optionally appends an exponent part to the standard format, for example "1.5E-2".

The whole number part may, as usual, include a sign. This, along with the separators for fractional part, exponent and any digit-grouping, depend on locale. QDoubleValidator doesn’t check the placement (which would also depend on locale) of any digit-grouping separators it finds, but it will reject input that contains them if RejectGroupSeparator is set in locale().numberOptions().

See also

numberOptions() decimalPoint() exponential() negativeSign()

PySide6.QtGui.QDoubleValidator.bottom()#
Return type:

double

See also

setBottom()

Getter of property bottom .

PySide6.QtGui.QDoubleValidator.bottomChanged(bottom)#
Parameters:

bottomdouble

Notification signal of property bottom .

PySide6.QtGui.QDoubleValidator.decimals()#
Return type:

int

See also

setDecimals()

Getter of property decimals .

PySide6.QtGui.QDoubleValidator.decimalsChanged(decimals)#
Parameters:

decimals – int

Notification signal of property decimals .

PySide6.QtGui.QDoubleValidator.notation()#
Return type:

Notation

See also

setNotation()

Getter of property notation .

PySide6.QtGui.QDoubleValidator.notationChanged(notation)#
Parameters:

notationNotation

Notification signal of property notation .

PySide6.QtGui.QDoubleValidator.setBottom(arg__1)#
Parameters:

arg__1double

See also

bottom()

Setter of property bottom .

PySide6.QtGui.QDoubleValidator.setDecimals(arg__1)#
Parameters:

arg__1 – int

See also

decimals()

Setter of property decimals .

PySide6.QtGui.QDoubleValidator.setNotation(arg__1)#
Parameters:

arg__1Notation

See also

notation()

Setter of property notation .

PySide6.QtGui.QDoubleValidator.setRange(bottom, top)#
Parameters:
  • bottomdouble

  • topdouble

This is an overloaded function.

Sets the validator to accept doubles from minimum to maximum inclusive without changing the number of digits after the decimal point.

PySide6.QtGui.QDoubleValidator.setRange(bottom, top, decimals)
Parameters:
  • bottomdouble

  • topdouble

  • decimals – int

Sets the validator to accept doubles from minimum to maximum inclusive, with at most decimals digits after the decimal point.

Note

Setting the number of decimals to -1 effectively sets it to unlimited. This is also the value used by a default-constructed validator.

PySide6.QtGui.QDoubleValidator.setTop(arg__1)#
Parameters:

arg__1double

See also

top()

Setter of property top .

PySide6.QtGui.QDoubleValidator.top()#
Return type:

double

See also

setTop()

Getter of property top .

PySide6.QtGui.QDoubleValidator.topChanged(top)#
Parameters:

topdouble

Notification signal of property top .