QDoubleValidator#
The QDoubleValidator
class provides range checking of floating-point numbers. More…
Synopsis#
Properties#
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)
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 QLocale::NumberOptions set on the locale()
also affect the way the number is interpreted. For example, since QLocale::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.
See also
QIntValidator
QRegularExpressionValidator
toDouble()Line Edits Example
- class PySide6.QtGui.QDoubleValidator([parent=None])#
PySide6.QtGui.QDoubleValidator(bottom, top, decimals[, parent=None])
- Parameters:
bottom – float
top – float
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.
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: float#
This property holds the validator’s minimum acceptable value.
By default, this property contains a value of -infinity.
See also
- Access functions:
bottom
()setBottom
(arg__1)Signal
bottomChanged
(bottom)
- 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
- Access functions:
decimals
()setDecimals
(arg__1)Signal
decimalsChanged
(decimals)
- 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:
notation
()setNotation
(arg__1)Signal
notationChanged
(notation)
- property PᅟySide6.QtGui.QDoubleValidator.top: float#
This property holds the validator’s maximum acceptable value.
By default, this property contains a value of infinity.
See also
- Access functions:
top
()setTop
(arg__1)Signal
topChanged
(top)
- 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 QLocale::RejectGroupSeparator is set in locale().numberOptions()
.
See also
negativeSign()
- PySide6.QtGui.QDoubleValidator.bottom()#
- Return type:
float
See also
Getter of property bottom
.
- PySide6.QtGui.QDoubleValidator.bottomChanged(bottom)#
- Parameters:
bottom – float
Notification signal of property bottom
.
- PySide6.QtGui.QDoubleValidator.decimals()#
- Return type:
int
See also
Getter of property decimals
.
- PySide6.QtGui.QDoubleValidator.decimalsChanged(decimals)#
- Parameters:
decimals – int
Notification signal of property decimals
.
- PySide6.QtGui.QDoubleValidator.notation()#
- Return type:
See also
Getter of property notation
.
Notification signal of property notation
.
Setter of property bottom
.
- PySide6.QtGui.QDoubleValidator.setDecimals(arg__1)#
- Parameters:
arg__1 – int
See also
Setter of property decimals
.
Setter of property notation
.
- PySide6.QtGui.QDoubleValidator.setRange(bottom, top)#
- Parameters:
bottom – float
top – float
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 – float
top – float
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.
Setter of property top
.
Getter of property top
.
- PySide6.QtGui.QDoubleValidator.topChanged(top)#
- Parameters:
top – float
Notification signal of property top
.