QDoubleValidator#

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

Synopsis#

Functions#

def bottom ()
def decimals ()
def notation ()
def setBottom (arg__1)
def setDecimals (arg__1)
def setNotation (arg__1)
def setRange (bottom, top)
def setRange (bottom, top, decimals)
def setTop (arg__1)
def top ()

Signals#

def bottomChanged (bottom)
def decimalsChanged (decimals)
def notationChanged (notation)
def topChanged (top)

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, the validator will accept group separators. It is thus recommended to use toDouble() to obtain the numeric value.

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

Parameters

bottom – double
top – double
decimals – int
parent – PySide6.QtCore.QObject

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.

PySide6.QtGui.QDoubleValidator.Notation#

This enum defines the allowed notations for entering a double.

Constant	Description
QDoubleValidator.StandardNotation	The string is written as a standard number (i.e. 0.015).
QDoubleValidator.ScientificNotation	The string is written in scientific form. It may have an exponent part(i.e. 1.5E-2).

PySide6.QtGui.QDoubleValidator.bottom()#

Return type: double

This property holds the validator’s minimum acceptable value.

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

PySide6.QtGui.QDoubleValidator.bottomChanged(bottom)#

Parameters: bottom – double

PySide6.QtGui.QDoubleValidator.decimals()#

Return type: 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.

PySide6.QtGui.QDoubleValidator.decimalsChanged(decimals)#

Parameters: decimals – int

PySide6.QtGui.QDoubleValidator.notation()#

Return type: Notation

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

By default, this property is set to ScientificNotation .

PySide6.QtGui.QDoubleValidator.notationChanged(notation)#

Parameters: notation – Notation

PySide6.QtGui.QDoubleValidator.setBottom(arg__1)#

Parameters: arg__1 – double

This property holds the validator’s minimum acceptable value.

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

PySide6.QtGui.QDoubleValidator.setDecimals(arg__1)#

Parameters: arg__1 – 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.

PySide6.QtGui.QDoubleValidator.setNotation(arg__1)#

Parameters: arg__1 – Notation

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

By default, this property is set to ScientificNotation .

PySide6.QtGui.QDoubleValidator.setRange(bottom, top)#

Parameters

bottom – double
top – double

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

bottom – double
top – double
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__1 – double

This property holds the validator’s maximum acceptable value.

By default, this property contains a value of infinity.

PySide6.QtGui.QDoubleValidator.top()#

Return type: double

This property holds the validator’s maximum acceptable value.

By default, this property contains a value of infinity.

PySide6.QtGui.QDoubleValidator.topChanged(top)#

Parameters: top – double