RangeSlider QML Type

Se utiliza para seleccionar un rango de valores deslizando dos tiradores a lo largo de una pista. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• first
  • first.handle : Item
  • first.hovered : bool
  • first.implicitHandleHeight : real
  • first.implicitHandleWidth : real
  • first.position : real
  • first.pressed : bool
  • first.value : real
  • first.visualPosition : real
• from : real
• horizontal : bool (since QtQuick.Controls 2.3 (Qt 5.10))
• live : bool (since QtQuick.Controls 2.2 (Qt 5.9))
• orientation : enumeration
• second
  • second.handle : Item
  • second.hovered : bool
  • second.implicitHandleHeight : real
  • second.implicitHandleWidth : real
  • second.position : real
  • second.pressed : bool
  • second.value : real
  • second.visualPosition : real
• snapMode : enumeration
• stepSize : real
• to : real
• touchDragThreshold : real (since QtQuick.Controls 2.5 (Qt 5.12))
• vertical : bool (since QtQuick.Controls 2.3 (Qt 5.10))

Señales

• void first.moved() (since QtQuick.Controls 2.5)
• void second.moved() (since QtQuick.Controls 2.5)

Métodos

• void first.decrease()
• void first.increase()
• void second.decrease()
• void second.increase()
• void setValues(real firstValue, real secondValue)
• real valueAt(real position) (since QtQuick.Controls 2.5 (Qt 5.12))

Descripción detallada

RangeSlider se utiliza para seleccionar un rango especificado por dos valores, deslizando cada tirador a lo largo de una pista.

En el ejemplo siguiente, se establecen los valores personalizados from y to, y las posiciones iniciales de los manejadores first y second:

RangeSlider {
    from: 1
    to: 100
    first.value: 25
    second.value: 75
}

Para realizar una acción cuando cambia el valor de un manejador determinado, utilice la siguiente sintaxis:

first.onMoved: console.log("first.value changed to " + first.value)

Las propiedades first.position y second.position se expresan como fracciones del tamaño del control, en el rango 0.0 - 1.0. Las propiedades first.visualPosition y second.visualPosition son iguales, excepto que se invierten en una aplicación de derecha a izquierda. El visualPosition es útil para posicionar los manejadores cuando se estiliza el RangeSlider. En el ejemplo anterior, first.visualPosition será 0.24 en una aplicación de izquierda a derecha, y 0.76 en una aplicación de derecha a izquierda.

Para un deslizador que permita al usuario seleccionar un único valor, consulte Slider.

Consulte también Personalización de RangeSlider, Controles de entrada y Gestión del enfoque en Qt Quick Controls.

Documentación de propiedades

first group

Véase también first.moved(), first.increase() y first.decrease().

from : real

Esta propiedad contiene el valor inicial del rango. El valor por defecto es 0.0.

Véase también to, first.value, y second.value.

horizontal : bool [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

Esta propiedad indica si el deslizador es horizontal.

Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).

Véase también orientation.

live : bool [since QtQuick.Controls 2.2 (Qt 5.9)]

Esta propiedad establece si el deslizador proporciona actualizaciones en tiempo real para las propiedades first.value y second.value mientras se arrastran los respectivos tiradores.

El valor por defecto es true.

Esta propiedad se introdujo en QtQuick.Controls 2.2 (Qt 5.9).

Ver también first.value y second.value.

orientation : enumeration

Esta propiedad contiene la orientación.

Valores posibles:

Véase también horizontal y vertical.

second group

Véase también second.moved(), second.increase() y second.decrease().

snapMode : enumeration

Esta propiedad contiene el modo de ajuste.

El modo de ajuste determina cómo se comportan los controles deslizantes con respecto a stepSize.

Valores posibles:

Para obtener explicaciones visuales de los distintos modos, consulte la documentación snapMode de Slider.

Véase también stepSize.

stepSize : real

Esta propiedad contiene el tamaño del paso. El valor por defecto es 0.0.

Véase también snapMode, first.increase(), y first.decrease().

to : real

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

Véase también from, first.value, y second.value.

touchDragThreshold : real [since QtQuick.Controls 2.5 (Qt 5.12)]

Esta propiedad contiene el umbral (en píxeles lógicos) en el que se iniciará un evento de arrastre táctil. El umbral de arrastre del ratón no se verá afectado. El valor por defecto es Application.styleHints.startDragDistance.

Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).

Ver también QStyleHints.

vertical : bool [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

Esta propiedad indica si el deslizador es vertical.

Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).

Ver también orientation.

Documentación de Señales

Esta señal se emite cuando el primer o el segundo control han sido movidos interactivamente por el usuario, ya sea mediante el tacto, el ratón o las teclas.

Estas señales se introdujeron en QtQuick.Controls 2.5.

Ver también first y second.

Documentación del método

void first.decrease()

Disminuye el valor del manejador en stepSize, o 0.1 si stepSize no está definido.

Véase también first.

void first.increase()

Aumenta el valor del manejador en stepSize, o 0.1 si stepSize no está definido.

Véase también first.

void second.decrease()

Disminuye el valor del manejador en stepSize, o 0.1 si stepSize no está definido.

Véase también second.

void second.increase()

Aumenta el valor del manejador en stepSize, o 0.1 si stepSize no está definido.

Véase también second.

void setValues(real firstValue, real secondValue)

Establece first.value y second.value con los argumentos dados.

Si to es mayor que from y firstValue es mayor que secondValue, firstValue se ajustará a secondValue.

Si from es mayor que to y secondValue es mayor que firstValue, secondValue se ajustará a firstValue.

Esta función puede ser necesaria para fijar los valores primero y segundo una vez finalizado el control, ya que existe una dependencia circular entre firstValue y secondValue que puede hacer que los valores asignados se sujeten entre sí.

Véase también stepSize.

[since QtQuick.Controls 2.5 (Qt 5.12)] real valueAt(real position)

Devuelve el valor de position.

Este método se introdujo en QtQuick.Controls 2.5 (Qt 5.12).

Ver también first.value, second.value, first.position, second.position, y live.