En esta página

DoubleValidator QML Type

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

Import Statement: import QtQuick
In C++: QDoubleValidator

Propiedades

Descripción detallada

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

  • Entrada aceptada: La entrada se acepta si contiene un número de tipo «double» que se encuentre dentro del rango válido y tenga el formato correcto.
  • Entrada aceptada pero no válida: La entrada se acepta, pero se considera no válida si contiene un valor de tipo «double» que se encuentra fuera del rango válido o tiene un formato incorrecto (por ejemplo, demasiados dígitos después de la coma decimal o está vacía).
  • Entrada rechazada: La entrada se rechaza si no es un valor de tipo «double».

Nota: Si el rango válido está compuesto únicamente por valores «double» positivos (por ejemplo, de 0,0 a 100,0) y la entrada es un valor «double» negativo, se rechaza. Si « notation » está establecido en « DoubleValidator.StandardNotation » y la entrada contiene más dígitos antes del punto decimal de los que puede tener un valor «double» dentro del rango válido, también se rechaza. Si notation es DoubleValidator.ScientificNotation y el valor introducido no se encuentra dentro del rango válido, se acepta pero se considera no válido. El valor puede pasar a ser válido cambiando el exponente.

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

import QtQuick

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

Véase 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 tiene un valor de -infinito.

decimals : int

Esta propiedad contiene el número máximo de dígitos después de la coma que admite el validador. Por defecto, esta propiedad tiene 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 que indica cómo una cadena de caracteres puede representar un número.

Los valores posibles para esta propiedad son:

ConstanteDescripción
DoubleValidator.StandardNotationsolo números decimales con signo opcional (p. ej., -0.015)
DoubleValidator.ScientificNotation(por defecto) el número escrito puede tener una parte exponencial (p. ej., 1.5E-2)

top : real

Esta propiedad contiene el valor máximo aceptable del validador. Por defecto, esta propiedad tiene un valor 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.