Класс 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 — целое число в допустимом диапазоне, Intermediate, если input — префикс целого числа в допустимом диапазоне, и Invalid в противном случае.

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

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