En esta página

IntValidator QML Type

Define un validador para valores enteros. Más...

Import Statement: import QtQuick
In C++: QIntValidator

Propiedades

Descripción detallada

El tipo IntValidator proporciona un validador para valores enteros.

Si no se ha establecido ningún objeto ` locale `, `IntValidator` utiliza el objeto ` default locale ` para interpretar el número y aceptará los dígitos, los separadores de grupos y los signos positivos y negativos específicos de la configuración regional. Además, se garantiza que `IntValidator` siempre aceptará un número formateado según la configuración regional «C».

El siguiente ejemplo muestra un objeto ` TextInput ` con un `IntValidator` para comprobar que el usuario ha introducido un número entero dentro del rango especificado, actualizando el color del texto para resaltar las entradas no válidas:

import QtQuick

TextInput {
    focus: true
    validator: IntValidator {
        bottom: 0
        top: 100
    }
    color: acceptableInput ? "black" : "red";
}

El validador impedirá el envío de texto que sea imposible que sea válido. Sin embargo, durante la edición, solo se bloquearán las invalidaciones fácilmente identificables, como por ejemplo conflictos de signo o un número excesivo de dígitos distintos de cero. Esto puede resultar sorprendente en ocasiones. El validador del ejemplo anterior permitirá, por ejemplo, introducir «999», ya que los valores que constan de un número de dígitos igual o inferior al valor máximo se consideran «intermedios», lo que significa que se encuentran en un estado en el que no son válidos, pero podrían ajustarse para que lo sean. 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 iniciales.

Añadir un indicador visual basado en la propiedad acceptableInput de TextInput puede dejar claro al usuario si lo que ha escrito se aceptará realmente.

Véase también DoubleValidator, RegularExpressionValidator y Validación del texto introducido.

Documentación de la propiedad

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 (normalmente -2147483647).

locale : string

Esta propiedad contiene el nombre de la configuración regional utilizada para interpretar el número.

Véase también ` Qt.locale()`.

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 grande disponible (normalmente 2147483647).

© 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.