Класс QIntValidator

Класс QIntValidator предоставляет валидатор, который гарантирует, что строка содержит целое число в заданном диапазоне. Подробнее...

• Список всех членов, включая наследуемые

Свойства

• bottom : int
• top : int

Открытые функции

Переопределенные открытые функции

Сигналы

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

Пример использования:

QValidator *validator = new QIntValidator(100, 999, this);
QLineEdit *edit = new QLineEdit(this);

// the edit lineedit will only accept integers between 100 and 999
edit->setValidator(validator);

Ниже приведены некоторые примеры валидаторов. На практике они обычно связываются с виджетом, как в примере выше.

QString str;
int pos = 0;
QIntValidator v(100, 900, this);

str = "1";
v.validate(str, pos);     // returns Intermediate
str = "012";
v.validate(str, pos);     // returns Intermediate

str = "123";
v.validate(str, pos);     // returns Acceptable
str = "678";
v.validate(str, pos);     // returns Acceptable

str = "999";
v.validate(str, pos);    // returns Intermediate

str = "1234";
v.validate(str, pos);     // returns Invalid
str = "-123";
v.validate(str, pos);     // returns Invalid
str = "abc";
v.validate(str, pos);     // returns Invalid
str = "12cm";
v.validate(str, pos);     // returns Invalid

Обратите внимание, что значение 999 возвращает Intermediate. Значения, состоящие из количества цифр, равного или меньшего максимального значения, считаются промежуточными. Это сделано намеренно, потому что цифра, которая предотвращает попадание числа в диапазон, необязательно является последней набранной цифрой. Это также означает, что промежуточное число может иметь ведущие нули.

Минимальное и максимальное значения устанавливаются в одном вызове с помощью setRange() или индивидуально с помощью setBottom() и setTop().

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

См. также QDoubleValidator, QRegularExpressionValidator, QLocale::toInt() и Пример Line Edits.

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

QIntValidator::QIntValidator(int minimum, int maximum, QObject *parent = nullptr)

Конструктор валидатора, принимающего целые числа от minimum до maximum включительно.

QIntValidator::QIntValidator(QObject *parent = nullptr)

Конструктор валидатора, принимающего все целые числа.

[virtual] QIntValidator::~QIntValidator()

Деструктор валидатора.

[override virtual] void QIntValidator::fixup(QString &input) const

Реализация: QValidator::fixup(QString &input) const.

void QIntValidator::setRange(int bottom, int top)

Устанавливает диапазон валидатора, принимающего только целые числа от bottom до top включительно.

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

Реализация: QValidator::validate(QString &input, int &pos) const.

Возвращает Acceptable, если input является целым числом в допустимом диапазоне. Если input имеет не более количества цифр, чем верхняя граница диапазона, или является префиксом целого числа в допустимом диапазоне, возвращает Intermediate. В противном случае возвращает Invalid.

Если допустимый диапазон состоит только из положительных целых чисел (например, от 32 до 100) и input является отрицательным целым числом, возвращается Invalid. (С другой стороны, если диапазон состоит из отрицательных целых чисел (например, от -100 до -32) и input является положительным целым числом, возвращается Intermediate, потому что пользователь, возможно, собирается набрать минус (особенно для языков с правонаправленной письменностью)).

Аналогично, если допустимый диапазон находится между 46 и 53, то 41 и 59 будут оценены как Intermediate, так как в противном случае пользователь не сможет изменить значение с 49 на 51.

int pos = 0;

s = "abc";
v.validate(s, pos);    // returns Invalid

s = "5";
v.validate(s, pos);    // returns Intermediate

s = "50";
v.validate(s, pos);    // returns Acceptable

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