Spec-Zone.ru › Qt 5.11

Класс QDoubleValidator

Класс QDoubleValidator обеспечивает проверку диапазона для чисел с плавающей точкой. Подробнее...

Заголовок: #include <QDoubleValidator>
qmake: QT += gui
Наследуется от: QValidator
  • Список всех членов, включая унаследованные

Общедоступные типы

перечисление Notation { СтандартнаяФорма, ЭкспоненциальнаяФорма }

Свойства

  • bottom : double
  • decimals : int
  • notation : Notation
  • top : double
  • 1 свойство унаследовано от QObject

Общедоступные функции

QDoubleValidator(QObject *parent = nullptr)
QDoubleValidator(double bottom, double top, int decimals, QObject *parent = nullptr)
virtual ~QDoubleValidator()
double bottom() const
int decimals() const
QDoubleValidator::Notation notation() const
void setBottom(double)
void setDecimals(int)
void setNotation(QDoubleValidator::Notation)
virtual void setRange(double minimum, double maximum, int decimals = 0)
void setTop(double)
double top() const

Переопределённые общедоступные функции

virtual QValidator::State validate(QString &input, int &pos) const override
  • 4 общедоступных функции унаследованы от QValidator
  • 34 общедоступных функции унаследованы от QObject

Дополнительные унаследованные члены

  • 1 общедоступный слот унаследован от QObject
  • 1 сигнал унаследован от QValidator
  • 2 сигнала унаследованы от QObject
  • 1 общедоступная переменная унаследована от QObject
  • 10 статические общедоступные члены унаследованы от QObject
  • 9 защищённых функций унаследованы от QObject
  • 2 защищённые переменные унаследованы от QObject

Подробное описание

Класс QDoubleValidator обеспечивает проверку диапазона для чисел с плавающей точкой.

QDoubleValidator предоставляет верхнюю и нижнюю границы, а также ограничение на количество цифр после запятой. Он не предоставляет функцию fixup().

Вы можете задать допустимый диапазон в одном вызове с помощью setRange() или с помощью setBottom() и setTop(). Установите количество знаков после запятой с помощью setDecimals(). Функция validate() возвращает состояние валидации.

QDoubleValidator использует свой locale() для интерпретации числа. Например, в немецком локали "1,234" будет интерпретирован как дробное число 1.234. В арабских локалях QDoubleValidator будет принимать арабские цифры.

Примечание: QLocale::NumberOptions, установленные в locale(), также влияют на способ интерпретации числа. Например, так как QLocale::RejectGroupSeparator по умолчанию не установлено, валидатор будет принимать разделители групп. Поэтому рекомендуется использовать QLocale::toDouble() для получения числового значения.

См. также QIntValidator, QRegExpValidator, QLocale::toDouble() и Пример с полями ввода.

Документация по типам членов

перечисление QDoubleValidator::Notation

Это перечисление определяет допустимые записи для ввода double.

Постоянная Значение Описание
QDoubleValidator::StandardNotation 0 Строка записана как стандартное число (например, 0.015).
QDoubleValidator::ScientificNotation 1 Строка записана в экспоненциальной форме. Она может содержать экспоненциальную часть (например, 1.5E-2).

Это перечисление было добавлено или изменено в Qt 4.3.

Документация свойств

bottom : double

Это свойство содержит минимальное допустимое значение валидатора

По умолчанию это свойство содержит значение -бесконечность.

Функции доступа:

double bottom() const
void setBottom(double)

См. также setRange().

decimals : int

Это свойство содержит максимальное количество цифр после запятой валидатора

По умолчанию это свойство содержит значение 1000.

Функции доступа:

int decimals() const
void setDecimals(int)

См. также setRange().

notation : Notation

Это свойство содержит обозначение того, как строка может описывать число

По умолчанию это свойство установлено в ЭкспоненциальнаяФорма.

Это свойство было добавлено в Qt 4.3.

Функции доступа:

QDoubleValidator::Notation notation() const
void setNotation(QDoubleValidator::Notation)

См. также Notation.

top : double

Это свойство содержит максимальное допустимое значение валидатора

По умолчанию это свойство содержит значение бесконечности.

Функции доступа:

double top() const
void setTop(double)

См. также setRange().

Документация по функциям членов

QDoubleValidator::QDoubleValidator(QObject *parent = nullptr)

Создаёт объект валидатора с родительским объектом, принимающим любое double.

QDoubleValidator::QDoubleValidator(double bottom, double top, int decimals, QObject *parent = nullptr)

Создаёт объект валидатора с объектом parent. Этот валидатор будет принимать числа с плавающей точкой от bottom до top включительно, с максимальным количеством decimals цифр после десятичной точки.

[virtual] QDoubleValidator::~QDoubleValidator()

Уничтожает валидатор.

[virtual] void QDoubleValidator::setRange(double minimum, double maximum, int decimals = 0)

Устанавливает валидатор, который будет принимать числа с плавающей точкой от minimum до maximum включительно, с максимальным количеством decimals цифр после десятичной точки.

[override virtual] QValidator::State QDoubleValidator::validate(QString &input, int &pos) const

Переопределён из QValidator::validate().

Возвращает Acceptable, если строка input содержит число с плавающей точкой, которое находится в допустимом диапазоне и имеет правильный формат.

Возвращает Intermediate, если input содержит число с плавающей точкой, которое находится вне диапазона или имеет неправильный формат; например, слишком много цифр после десятичной точки или строка пустая.

Возвращает Invalid, если input не является числом с плавающей точкой.

Примечание: Если допустимый диапазон состоит только из положительных чисел с плавающей точкой (например, от 0,0 до 100,0) и input — отрицательное число с плавающей точкой, то возвращается Invalid. Если notation() установлено в StandardNotation, и входная строка содержит больше цифр перед десятичной точкой, чем может иметь число с плавающей точкой в допустимом диапазоне, возвращается Invalid. Если notation() равно ScientificNotation, и входная строка не находится в допустимом диапазоне, возвращается Intermediate. Значение может стать допустимым после изменения экспоненты.

По умолчанию параметр pos этим валидатором не используется.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.11/qdoublevalidator.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API