En esta página

QIntValidator Class

La clase QIntValidator proporciona un validador que garantiza que una cadena contenga un número entero válido dentro de un rango especificado. Más información...

Encabezado: #include <QIntValidator>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Heredado de: QValidator

Propiedades

Funciones públicas

QIntValidator(QObject *parent = nullptr)
QIntValidator(int minimum, int maximum, QObject *parent = nullptr)
virtual ~QIntValidator()
int bottom() const
void setBottom(int)
void setRange(int bottom, int top)
void setTop(int)
int top() const

Funciones públicas reimplementadas

virtual void fixup(QString &input) const override
virtual QValidator::State validate(QString &input, int &pos) const override

Descripción detallada

Ejemplo de uso:

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);

A continuación presentamos algunos ejemplos de validadores. En la práctica, normalmente se asociarían a un widget, como en el ejemplo anterior.

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

Obsérvese que la función ` 999 ` devuelve «Intermedio». Se consideran intermedios los valores que constan de un número de dígitos igual o inferior al valor máximo. Esto es intencionado, ya que el dígito que impide que un número se encuentre dentro del rango no es necesariamente el último dígito introducido. Esto también significa que un número intermedio puede tener ceros a la izquierda.

Los valores mínimo y máximo se establecen en una sola llamada con ` setRange()`, o individualmente con ` setBottom()` y ` setTop()`.

QIntValidator utiliza su locale() para interpretar el número. Por ejemplo, en las configuraciones regionales árabes, QIntValidator aceptará dígitos árabes.

Nota: El valor de « QLocale::NumberOptions » establecido en « locale » () también afecta a la forma en que se interpreta el número. Por ejemplo, dado que « QLocale::RejectGroupSeparator » no está activado por defecto, el validador aceptará separadores de grupos. Por lo tanto, se recomienda utilizar « QLocale::toInt » () para obtener el valor numérico.

Véase también QDoubleValidator, QRegularExpressionValidator, QLocale::toInt() y el ejemplo de campos de edición de línea.

Documentación de propiedades

bottom : int

Esta propiedad contiene el valor mínimo aceptable del validador

Por defecto, el valor de esta propiedad se deriva del entero con signo más pequeño disponible (-2147483648).

Funciones de acceso:

int bottom() const
void setBottom(int)

Véase también setRange().

top : int

Esta propiedad contiene el valor máximo aceptable del validador

Por defecto, el valor de esta propiedad se deriva del entero con signo más alto disponible (2147483647).

Funciones de acceso:

int top() const
void setTop(int)

Véase también setRange().

Documentación de funciones miembro

[explicit] QIntValidator::QIntValidator(QObject *parent = nullptr)

Crea un validador con un objeto ` parent ` que acepta todos los números enteros.

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

Crea un validador con un « parent » que acepta números enteros comprendidos entre « minimum » y « maximum », ambos inclusive.

[virtual noexcept] QIntValidator::~QIntValidator()

Elimina el validador.

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

Reimplementa: ` QValidator::fixup` (QString &input) const.

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

Establece el rango del validador para que solo acepte números enteros comprendidos entre bottom y top, ambos inclusive.

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

Reimplementa: QValidator::validate(QString &input, int &pos) const.

Devuelve ` Acceptable ` si ` input ` es un entero dentro del rango válido. Si ` input ` tiene como máximo tantos dígitos como el límite superior del rango, o es un prefijo de un entero dentro del rango válido, devuelve ` Intermediate`. En caso contrario, devuelve ` Invalid`.

Si el rango válido está formado únicamente por números enteros positivos (por ejemplo, de 32 a 100) y input es un número entero negativo, se devuelve «Invalid». (Por otro lado, si el rango está formado por números enteros negativos (p. ej., de -100 a -32) y input es un número entero positivo sin signo más inicial, se devuelve «Intermediate», ya que el usuario podría estar a punto de escribir el signo menos (especialmente en idiomas que se escriben de derecha a izquierda).

Del mismo modo, si el rango válido está entre 46 y 53, entonces 41 y 59 se evaluarán como « Intermediate », ya que, de lo contrario, el usuario no podría cambiar un valor de 49 a 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

Por defecto, este validador no utiliza el parámetro « pos ».

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.