DoubleSpinBox QML Type
Permite al usuario seleccionar entre un conjunto de valores de coma flotante predefinidos. Más...
| Import Statement: | import QtQuick.Controls |
| Since: | Qt 6.11 |
| Inherits: |
Propiedades
- decimals : int
- displayText : string
- down
- down.hovered : bool
- down.implicitIndicatorHeight : real
- down.implicitIndicatorWidth : real
- down.indicator : Item
- down.pressed : bool
- editable : bool
- from : double
- inputMethodComposing : bool
- inputMethodHints : flags
(since QtQuick.Controls 2.2 (Qt 5.9)) - stepSize : double
- textFromValue : function
- to : double
- up
- up.hovered : bool
- up.implicitIndicatorHeight : real
- up.implicitIndicatorWidth : real
- up.indicator : Item
- up.pressed : bool
- validator : Validator
- value : double
- valueFromText : function
- wrap : bool
(since QtQuick.Controls 2.3 (Qt 5.10))
Señales
Métodos
Descripción detallada

DoubleSpinBox es similar a SpinBox, salvo que admite valores de doble precisión en lugar de enteros. El usuario puede seleccionar un valor haciendo clic en los botones indicadores de subir o bajar, o pulsando las teclas de flecha arriba o abajo del teclado. Opcionalmente, DoubleSpinBox también puede configurarse como editable, de modo que el usuario pueda introducir un valor de texto en el campo de entrada.
Por defecto, DoubleSpinBox proporciona valores discretos dentro del rango de [0.00-99.99] con un stepSize de 1.0.
DoubleSpinBox {
id: doubleSpinBox
from: 0
value: 1.1
to: 100
stepSize: Math.pow(10, -decimals)
decimals: 2
editable: true
anchors.centerIn: parent
}Véase también SpinBox, Tumbler, Personalización de DoubleSpinBox y Gestión del foco en los controles de Qt Quick .
Documentación de propiedades
decimals : int
Esta propiedad determina el número de decimales que utilizará el cuadro de selección para mostrar e interpretar valores de tipo «double».
El valor por defecto es 2.
Cambiar el valor de esta propiedad puede afectar a from, to y value.
Advertencia: El valor máximo de « decimals » es « DBL_MAX_10_EXP + DBL_DIG » (323) debido a las limitaciones del tipo «double».
displayText : string [read-only]
Esta propiedad contiene el valor textual del cuadro de selección.
El valor de la propiedad se basa en textFromValue y locale, y es igual a:
let text = spinBox.textFromValue(spinBox.value, spinBox.decimals, spinBox.locale)Véase también textFromValue.
down group
down.hovered : bool
down.implicitIndicatorHeight : real
down.implicitIndicatorWidth : real
down.indicator : Item
down.pressed : bool
Esta propiedad agrupada contiene el elemento indicador «abajo» y sus propiedades asociadas.
Véase también decrease().
editable : bool
Esta propiedad indica si el cuadro de selección de valores es editable. El valor por defecto es « false ».
Véase también validator.
from : double
Esta propiedad contiene el valor inicial del rango. El valor por defecto es 0.0.
inputMethodComposing : bool [read-only]
Esta propiedad indica si un cuadro giratorio editable contiene texto introducido parcialmente mediante un método de entrada.
Durante la redacción, un método de entrada puede basarse en eventos del ratón o del teclado procedentes del cuadro de selección para editar o confirmar el texto parcial. Esta propiedad se puede utilizar para determinar cuándo desactivar los controladores de eventos que puedan interferir en el correcto funcionamiento de un método de entrada.
inputMethodHints : flags [since QtQuick.Controls 2.2 (Qt 5.9)]
Esta propiedad proporciona indicaciones al método de entrada sobre el contenido esperado del cuadro de selección y sobre cómo debe funcionar.
El valor por defecto es Qt.ImhDigitsOnly.
El valor es una combinación bit a bit de indicadores o « Qt.ImhNone » si no se ha establecido ninguna sugerencia.
Los indicadores que modifican el comportamiento son:
- Qt.ImhHiddenText: los caracteres deben aparecer ocultos, como suele ocurrir al introducir contraseñas.
- Qt.ImhSensitiveData: el texto escrito no debe ser almacenado por el método de entrada activo en ningún almacenamiento persistente, como el diccionario predictivo del usuario.
- Qt.ImhNoAutoUppercase: el método de entrada no debe intentar cambiar automáticamente a mayúsculas al finalizar una frase.
- Qt.ImhPreferNumbers: se da preferencia a los números (aunque no es obligatorio).
- Qt.ImhPreferUppercase: se prefieren las mayúsculas (aunque no son obligatorias).
- Qt.ImhPreferLowercase: Se prefieren las letras minúsculas (aunque no son obligatorias).
- Qt.ImhNoPredictiveText: no se debe utilizar el texto predictivo (es decir, la búsqueda en el diccionario) mientras se escribe.
- Qt.ImhDate: el editor de texto funciona como un campo de fecha.
- Qt.ImhTime: el editor de texto funciona como un campo de hora.
Los indicadores que restringen la entrada (indicadores exclusivos) son:
- Qt.ImhDigitsOnly: solo se permiten dígitos.
- Qt.ImhFormattedNumbersOnly: solo se permite la introducción de números. Esto incluye el punto decimal y el signo menos.
- Qt.ImhUppercaseOnly: solo se permite introducir letras mayúsculas.
- Qt.ImhLowercaseOnly: solo se permite la introducción de letras minúsculas.
- Qt.ImhDialableCharactersOnly: solo se permiten caracteres aptos para marcar un número de teléfono.
- Qt.ImhEmailCharactersOnly: solo se permiten caracteres adecuados para direcciones de correo electrónico.
- Qt.ImhUrlCharactersOnly: solo se permiten caracteres aptos para direcciones URL.
Máscaras:
- Qt.ImhExclusiveInputMask: esta máscara devuelve un valor distinto de cero si se utiliza cualquiera de los indicadores exclusivos.
Esta propiedad se introdujo en QtQuick.Controls 2.2 (Qt 5.9).
stepSize : double
Esta propiedad contiene el tamaño del paso. El valor por defecto es 1.0.
Véase también increase() y decrease().
textFromValue : function
Esta propiedad contiene una función de devolución de llamada que se ejecuta cada vez que es necesario convertir un valor de tipo «double» para mostrarlo como texto.
La función predeterminada se puede sobrescribir para mostrar un texto personalizado para un valor determinado. Esto se aplica tanto a los cuadros de selección editables como a los no editables; por ejemplo, al utilizar los botones arriba y abajo o la rueda del ratón para incrementar o disminuir el valor, el nuevo valor se convierte a texto de visualización mediante esta función.
La firma de la función de devolución de llamada es string function(value, decimals, locale). La función puede tener dos o tres argumentos: el primero es el valor que se va a convertir, el segundo es el número de decimales y el tercero, opcional, es la configuración regional que se debe utilizar para la conversión, si procede.
La implementación predeterminada realiza la conversión mediante Number.toLocaleString():
textFromValue: function(value, decimals, locale) {
return Number(value).toLocaleString(locale, 'f', decimals);
}Nota: Al aplicar una implementación personalizada de ` textFromValue ` para los cuadros de selección editables, debe proporcionarse una implementación correspondiente de ` valueFromText ` para poder volver a convertir el texto personalizado en un valor de tipo `double`.
Véase también valueFromText, validator y locale.
to : double
Esta propiedad contiene el valor final del rango. El valor por defecto es 99.99.
up group
up.hovered : bool
up.implicitIndicatorHeight : real
up.implicitIndicatorWidth : real
up.indicator : Item
up.pressed : bool
Esta propiedad agrupada contiene el elemento indicador «arriba» y sus propiedades asociadas.
Véase también increase().
validator : Validator
Esta propiedad contiene el validador de texto de entrada para los campos de selección editables. Por defecto, DoubleSpinBox utiliza DoubleValidator para aceptar entradas de números de tipo «double».
DoubleSpinBox {
id: control
validator: DoubleValidator {
locale: control.locale.name
bottom: Math.min(control.from, control.to)
top: Math.max(control.from, control.to)
}
}Véase también editable, textFromValue, valueFromText, locale y Validación del texto introducido.
value : double
Esta propiedad toma valores comprendidos entre from y to. El valor por defecto es 0.0.
valueFromText : function
Esta propiedad contiene una función de devolución de llamada que se invoca cada vez que es necesario convertir el texto introducido en un valor de tipo «double».
Solo es necesario sobrescribir esta función cuando se sobrescribe ` textFromValue ` para un cuadro de selección editable.
La firma de la función de llamada de retorno es int function(text, locale). La función puede tener uno o dos argumentos: el primero es el texto que se va a convertir y el segundo, opcional, es la configuración regional que se debe utilizar para la conversión, si procede.
La implementación por defecto realiza la conversión utilizando ` Number.fromLocaleString()`:
valueFromText: function(text, locale) { return Number.fromLocaleString(locale, text); }Nota: Al aplicar una implementación personalizada de ` textFromValue ` para los cuadros de selección editables, se debe proporcionar una implementación correspondiente de ` valueFromText ` para poder volver a convertir el texto personalizado en un valor de tipo double.
Véanse también textFromValue, validator y locale.
wrap : bool [since QtQuick.Controls 2.3 (Qt 5.10)]
Esta propiedad determina si el cuadro de selección de valor se ajusta a la anchura de la línea. El valor por defecto es « false ».
Si wrap es true, al pasar de to, el valor cambia a from y viceversa.
Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
Documentación de señales
valueModified()
Esta señal se emite cuando el usuario ha modificado de forma interactiva el valor del cuadro de selección mediante el tacto, el ratón, la rueda o las teclas. En el caso de la interacción mediante el teclado, la señal solo se emite cuando se ha aceptado el texto; es decir, cuando se pulsan las teclas «Intro» o «Retorno», o cuando el campo de entrada pierde el foco.
Nota: El controlador correspondiente es onValueModified.
Documentación del método
void decrease()
Reduce el valor en stepSize, o en 1 si stepSize no está definido.
Véase también stepSize.
void increase()
Aumenta el valor en stepSize, o en 1 si stepSize no está definido.
Véase también stepSize.
© 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.