DoubleSpinBox QML Type

Permite al usuario seleccionar entre un conjunto de valores de coma flotante preestablecidos. Más...

• Lista de todos los miembros, incluidos los heredados

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 : int
• 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

• valueModified()

Métodos

• void decrease()
• void increase()

Descripción detallada

DoubleSpinBox es similar a SpinBox, excepto que admite valores dobles en lugar de enteros. El usuario puede elegir un valor haciendo clic en los botones indicadores arriba o abajo, o pulsando arriba o abajo en el teclado. Opcionalmente, DoubleSpinBox también puede convertirse en editable, de modo que el usuario puede introducir un valor de texto en el campo de entrada.

Por defecto, DoubleSpinBox proporciona valores discretos en el 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 Enfoque en Qt Quick Controls.

Documentación de propiedades

decimals : int

Esta propiedad indica cuántos decimales utilizará el spinbox para mostrar e interpretar los dobles.

El valor por defecto es 2.

Cambiar el valor de esta propiedad puede afectar a from, to y value.

displayText : string [read-only]

Esta propiedad contiene el valor textual del spinbox.

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

Esta propiedad agrupada contiene el elemento indicador de bajada y sus propiedades asociadas.

Véase también decrease().

editable : bool

Esta propiedad indica si el spinbox 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.

Véase también to y value.

inputMethodComposing : bool [read-only]

Esta propiedad indica si un cuadro de giro editable tiene texto parcial introducido por un método de entrada.

Mientras se está componiendo, un método de entrada puede depender de eventos de ratón o tecla de la caja de giro para editar o confirmar el texto parcial. Esta propiedad se puede utilizar para determinar cuándo desactivar los manejadores de eventos que puedan interferir con el correcto funcionamiento de un método de entrada.

inputMethodHints : flags [since QtQuick.Controls 2.2 (Qt 5.9)]

Esta propiedad proporciona pistas al método de entrada sobre el contenido esperado del cuadro de giro y cómo debe funcionar.

El valor por defecto es Qt.ImhDigitsOnly.

El valor es una combinación de bit a bit de flags o Qt.ImhNone si no hay ninguna sugerencia.

Las banderas que alteran el comportamiento son:

• Qt.ImhHiddenText - Los caracteres deben estar ocultos, como se usa típicamente al introducir contraseñas.
• Qt.ImhSensitiveData - El texto tecleado 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 debería intentar cambiar automáticamente a mayúsculas cuando termina una frase.
• Qt.ImhPreferNumbers - Se prefieren los números (pero no son obligatorios).
• Qt.ImhPreferUppercase - Se prefieren las mayúsculas (pero no son obligatorias).
• Qt.ImhPreferLowercase - Se prefieren las minúsculas (pero no son obligatorias).
• Qt.ImhNoPredictiveText - No utilizar texto predictivo (es decir, búsqueda en 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 tiempo.

Las banderas que restringen la entrada (banderas exclusivas) son:

• Qt.ImhDigitsOnly - Sólo se permiten dígitos.
• Qt.ImhFormattedNumbersOnly - Sólo se permite la entrada de números. Esto incluye el punto decimal y el signo menos.
• Qt.ImhUppercaseOnly - Sólo se permite la introducción de letras mayúsculas.
• Qt.ImhLowercaseOnly - Sólo se permite la entrada de letras minúsculas.
• Qt.ImhDialableCharactersOnly - Sólo se permiten caracteres adecuados para la marcación telefónica.
• Qt.ImhEmailCharactersOnly - Sólo se permiten caracteres adecuados para direcciones de correo electrónico.
• Qt.ImhUrlCharactersOnly - Sólo se permiten caracteres adecuados para URLs.

Máscaras:

• Qt.ImhExclusiveInputMask - Esta máscara devuelve un valor distinto de cero si se utiliza alguno 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 llamada de retorno que se llama cada vez que un valor doble necesita ser convertido para mostrar texto.

La función por defecto puede ser sobreescrita para mostrar texto personalizado para un valor dado. Esto se aplica tanto a los spinboxes editables como a los no editables; por ejemplo, cuando se utilizan los botones arriba y abajo o la rueda del ratón para incrementar y decrementar el valor, el nuevo valor se convierte en texto para mostrar utilizando 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, donde el primer argumento es el valor a convertir, el segundo argumento es el número de decimales, y el tercer argumento opcional es la configuración regional que debe utilizarse para la conversión, si procede.

La implementación por defecto realiza la conversión utilizando Number.toLocaleString():

textFromValue: function(value, decimals, locale) {
    return Number(value).toLocaleString(locale, 'f', decimals);
}

Véase también valueFromText, validator, y locale.

to : int

Esta propiedad contiene el valor final del rango. El valor por defecto es 2.

Véase también from y value.

up group

Esta propiedad agrupada contiene el elemento indicador de subida y sus propiedades asociadas.

Véase también increase().

validator : Validator

Esta propiedad contiene el validador de texto de entrada para los spinboxes editables. Por defecto, DoubleSpinBox utiliza DoubleValidator para aceptar la entrada de números dobles.

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 de entrada.

value : double

Esta propiedad mantiene el valor en el rango from - to. El valor por defecto es 0.0.

valueFromText : function

Esta propiedad contiene una función callback que es llamada cada vez que el texto de entrada necesita ser convertido a un valor doble.

Esta función sólo necesita ser sobreescrita cuando textFromValue es sobreescrita para un spinbox 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, donde el primer argumento es el texto a convertir, y el segundo argumento opcional es la configuración regional que debe utilizarse 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); }

Véase también textFromValue, validator, y locale.

wrap : bool [since QtQuick.Controls 2.3 (Qt 5.10)]

Esta propiedad indica si el spinbox se envuelve. El valor por defecto es false.

Si wrap es true, pasando de to cambia el valor 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 valor del cuadro de giro ha sido modificado interactivamente por el usuario, ya sea mediante el tacto, el ratón, la rueda o las teclas. En el caso de interacción a través del teclado, la señal sólo se emite cuando el texto ha sido aceptado; es decir, cuando se pulsan las teclas intro o retorno, o el campo de entrada pierde el foco.

Documentación del método

void decrease()

Disminuye el valor en stepSize, o 1 si stepSize no está definido.

Véase también stepSize.

void increase()

Aumenta el valor en stepSize, o 1 si stepSize no está definido.

Véase también stepSize.