DoubleValidator QML Type

Define un validador para números no enteros. Más...

Import Statement:	`import QtQuick`
In C++:	QDoubleValidator

Lista de todos los miembros, incluidos los heredados

Propiedades

bottom : real
decimals : int
locale : string
notation : enumeration
top : real

Descripción detallada

El tipo DoubleValidator proporciona un validador para números no enteros.

Entrada aceptada: La entrada es aceptada si contiene un doble que está dentro del rango válido y tiene el formato correcto.
Entrada aceptada pero no válida: La entrada se acepta pero se considera inválida si contiene un doble que está fuera del rango válido o tiene un formato incorrecto (por ejemplo, demasiados dígitos después del punto decimal o está vacío).
Entrada rechazada: La entrada se rechaza si no es un doble.

Nota: Si el rango válido consiste sólo en dobles positivos (por ejemplo, 0.0 a 100.0) y la entrada es un doble negativo, se rechaza. Si notation es DoubleValidator.StandardNotation y la entrada contiene más dígitos antes del punto decimal de los que puede tener un doble en el rango válido, también se rechaza. Si notation es DoubleValidator.ScientificNotation y la entrada no está en el rango válido, se acepta pero no es válida. El valor puede volverse válido cambiando el exponente.

El siguiente ejemplo muestra un objeto TextInput con un DoubleValidator para comprobar que el usuario ha introducido un doble dentro del rango especificado, actualizando el color del texto para resaltar la entrada no válida:

import QtQuick

TextInput {
    focus: true
    validator: DoubleValidator {
        bottom: 0.00
        top: 100.00
        decimals: 2
        notation: DoubleValidator.StandardNotation
    }
    onAcceptableInputChanged:
        color = acceptableInput ? "black" : "red";
}

Consulte también IntValidator, RegularExpressionValidator, y Validación del texto introducido.

Documentación de Propiedades

bottom : real

Esta propiedad contiene el valor mínimo aceptable del validador. Por defecto, esta propiedad contiene un valor de -infinito.

decimals : int

Esta propiedad contiene el número máximo de dígitos del validador después del punto decimal. Por defecto, esta propiedad contiene un valor de 1000.

locale : string

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

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

notation : enumeration

Esta propiedad contiene la notación de cómo una cadena puede describir un número.

Los valores posibles para esta propiedad son

Constante	Descripción
`DoubleValidator.StandardNotation`	sólo números decimales con signo opcional (por ejemplo, `-0.015`)
`DoubleValidator.ScientificNotation`	(por defecto) el número escrito puede tener una parte de exponente (por ejemplo `1.5E-2`)

top : real

Esta propiedad contiene el valor máximo aceptable del validador. Por defecto, esta propiedad contiene un valor de infinito.

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