IntValidator QML Type

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

• Lista de todos los miembros, incluidos los heredados

Propiedades

• bottom : int
• locale : string
• top : int

Descripción detallada

El tipo IntValidator proporciona un validador para valores enteros.

Si no se define locale, IntValidator utiliza default locale para interpretar el número y aceptará dígitos específicos de la configuración regional, separadores de grupo y signos positivos y negativos. Además, IntValidator siempre acepta 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 la entrada no válida:

import QtQuick

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

El validador impedirá el envío de texto que no pueda ser válido. Sin embargo, durante la edición, sólo se bloqueará la invalidez fácilmente identificable, por ejemplo, conflictos de signos o demasiados dígitos distintos de cero. Esto a veces puede resultar sorprendente. 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 serlo. Esto se debe a que el dígito que impide que un número esté dentro del rango no es necesariamente el último dígito tecleado. Esto también significa que un número intermedio puede tener ceros a la izquierda.

Añadiendo un indicador visual basado en la propiedad acceptableInput de TextInput se puede aclarar al usuario si lo que ha escrito será realmente aceptado.

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

Documentación de propiedades

bottom : int

Esta propiedad contiene el valor más bajo aceptable del validador. Por defecto, el valor de esta propiedad se deriva del número entero con signo más bajo 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ás alto aceptable del validador. Por defecto, el valor de esta propiedad se deriva del entero con signo más alto disponible (normalmente 2147483647).