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 InvalidObsé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 AcceptablePor 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.