Класс 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 будет принимать арабские цифры.

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

См. также QDoubleValidator, QRegExpValidator, QLocale::toInt() и Пример использования Line Edits.

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

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

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

QIntValidator::QIntValidator(QObject *parent = nullptr)

Конструирует валидатор с объектом parent, который принимает все целые числа.

[virtual] QIntValidator::~QIntValidator()

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

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

Переопределяет: QValidator::fixup(QString &input) const.

[virtual] 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 не используется этим валидатором.