En esta página

RangeSlider QML Type

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

Import Statement: import QtQuick.Controls
Inherits:

Control

Propiedades

Señales

Métodos

Descripción detallada

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

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

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

Para realizar una acción cuando cambie el valor de un controlador concreto, 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, salvo que se invierten en una aplicación de lectura de derecha a izquierda. La propiedad « visualPosition » resulta útil para posicionar los controladores al aplicar estilos a RangeSlider. En el ejemplo anterior, « first.visualPosition » se convertirá en « 0.24 » en una aplicación de izquierda a derecha, y en « 0.76 » en una aplicación de derecha a izquierda.

Para un control deslizante que permita al usuario seleccionar un único valor, consulta Slider.

Véase también «Personalización de RangeSlider, controles de entrada y gestión del foco» en Qt Quick Controls.

Documentación de propiedades

crossingEnabled : bool [since QtQuick.Controls 6.12]

Esta propiedad determina si los controles deslizantes pueden cruzarse entre sí.

Cuando está activada la opción « false » (valor predeterminado), el primer control deslizante no puede desplazarse más allá del segundo, y viceversa. Los valores están restringidos de tal forma que first.value <= second.value para rangos normales, o first.value >= second.value para rangos invertidos.

Utilice la propiedad « handlesCrossed » para detectar cuándo se han intercambiado los controladores.

El valor por defecto es false.

Cuando la función de cruce está desactivada, si los controladores se han cruzado, sus valores se intercambiarán.

Esta propiedad se introdujo en QtQuick.Controls 6.12.

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

effectiveFirstValue : real [read-only, since QtQuick.Controls 6.12]

Esta propiedad contiene el valor del identificador que se creó originalmente como el «primer» identificador, independientemente de si los identificadores se han cruzado o no.

Cuando ` crossingEnabled ` es ` false ` o los manejadores no se han cruzado, esto es igual a ` first.value`. Cuando los manejadores se han cruzado, representa el valor del manejador situado en la «primera» posición visual (el más a la izquierda en orientación horizontal, el más abajo en orientación vertical).

Esta propiedad se introdujo en QtQuick.Controls 6.12.

Véase también effectiveSecondValue, first.value, handlesCrossed y crossingEnabled.

effectiveSecondValue : real [read-only, since QtQuick.Controls 6.12]

Esta propiedad contiene el valor del controlador situado en la «segunda» posición visual (la más a la derecha en orientación horizontal y la más arriba en orientación vertical).

Cuando ` crossingEnabled ` es ` false ` o los manejadores no se han cruzado, esto es igual a ` second.value`. Cuando los manejadores se han cruzado, esto representa el valor del manejador situado en la «segunda» posición visual (el más a la derecha en orientación horizontal, el más arriba en orientación vertical).

Esta propiedad se introdujo en QtQuick.Controls 6.12.

Véase también effectiveFirstValue, second.value, handlesCrossed y crossingEnabled.

first group

first.handle : Item

first.hovered : bool

first.implicitHandleHeight : real

first.implicitHandleWidth : real

first.position : real

first.pressed : bool

first.value : real

first.visualPosition : real

PropiedadDescripción
valorEsta propiedad contiene el valor del primer identificador dentro del rango from - to.

Si from es mayor que to, el valor del primer identificador debe ser mayor que el del segundo, y viceversa.

El valor por defecto es 0.0.

handleEsta propiedad contiene el primer elemento del manejador.
visualPositionEsta propiedad contiene la posición visual del primer controlador.

La posición se expresa como una fracción del tamaño del control, en el rango 0.0 - 1.0. Cuando el control está en modo « mirrored », el valor es igual a 1.0 - position. Esto hace que el valor sea adecuado para visualizar el control deslizante, teniendo en cuenta la compatibilidad con la escritura de derecha a izquierda.

positionEsta propiedad contiene la posición lógica del primer controlador.

La posición se expresa como una fracción del tamaño del control, en el intervalo 0.0 - 1.0. Para visualizar un control deslizante, se debe utilizar en su lugar la propiedad visualPosition, que tiene en cuenta la lectura de derecha a izquierda.

pressedEsta propiedad indica si el primer controlador está pulsado, ya sea mediante tacto, ratón o teclas.
hoveredEsta propiedad indica si el cursor se encuentra sobre el primer controlador. Esta propiedad se introdujo en QtQuick.Controls 2.1.
implicitHandleWidthEsta propiedad indica el ancho implícito del primer controlador. Esta propiedad se introdujo en QtQuick.Controls 2.5.
implicitHandleHeightEsta propiedad indica la altura implícita del primer controlador. Esta propiedad se introdujo en QtQuick.Controls 2.5.

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.

handlesCrossed : bool [read-only, since QtQuick.Controls 6.12]

Esta propiedad indica si los manejadores se han cruzado entre sí.

Esta propiedad solo es relevante cuando « crossingEnabled » tiene el valor « true ». Cuando los controladores se cruzan, sus roles internos se intercambian para mantener el significado semántico de «primero» y «segundo» como límites inferior y superior, respectivamente.

Esta propiedad se puede utilizar para proporcionar retroalimentación visual cuando los controladores se encuentran en estado cruzado.

Esta propiedad se introdujo en QtQuick.Controls 6.12.

Véase también crossingEnabled y handlesCrossedChanged().

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

Esta propiedad indica si el control deslizante 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 indica si el control deslizante ofrece actualizaciones en tiempo real para las propiedades first.value y second.value mientras se arrastran los controles correspondientes.

El valor por defecto es true.

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

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

orientation : enumeration

Esta propiedad define la orientación.

Valores posibles:

ConstanteDescripción
Qt.HorizontalHorizontal (predeterminado)
Qt.VerticalVertical

Véase también horizontal y vertical.

second group

second.handle : Item

second.hovered : bool

second.implicitHandleHeight : real

second.implicitHandleWidth : real

second.position : real

second.pressed : bool

second.value : real

second.visualPosition : real

PropiedadDescripción
valorEsta propiedad contiene el valor del segundo identificador dentro del intervalo from - to.

Si from es mayor que to, el valor del primer identificador debe ser mayor que el del segundo, y viceversa.

El valor por defecto es 0.0.

handleEsta propiedad contiene el segundo elemento del identificador.
visualPositionEsta propiedad contiene la posición visual del segundo controlador.

La posición se expresa como una fracción del tamaño del control, en el rango 0.0 - 1.0. Cuando el control está en modo « mirrored », el valor es igual a 1.0 - position. Esto hace que el valor sea adecuado para visualizar el control deslizante, teniendo en cuenta la compatibilidad con la escritura de derecha a izquierda.

positionEsta propiedad contiene la posición lógica del segundo controlador.

La posición se expresa como una fracción del tamaño del control, dentro del intervalo 0.0 - 1.0. Para visualizar un control deslizante, se debe utilizar en su lugar la propiedad visualPosition, que tiene en cuenta la lectura de derecha a izquierda.

pressedEsta propiedad indica si el segundo controlador está pulsado, ya sea mediante tacto, ratón o teclas.
hoveredEsta propiedad indica si el cursor se encuentra sobre el segundo controlador. Esta propiedad se introdujo en QtQuick.Controls 2.1.
implicitHandleWidthEsta propiedad indica el ancho implícito del segundo controlador. Esta propiedad se introdujo en QtQuick.Controls 2.5.
implicitHandleHeightEsta propiedad indica la altura implícita del segundo controlador. Esta propiedad se introdujo en QtQuick.Controls 2.5.

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

snapMode : enumeration

Esta propiedad define el modo de ajuste.

El modo de ajuste determina cómo se comportan los controles deslizantes en relación con el « stepSize ».

Valores posibles:

ConstanteDescripción
RangeSlider.NoSnapEl control deslizante no se ajusta (valor predeterminado).
RangeSlider.SnapAlwaysEl control deslizante se ajusta mientras se arrastra el controlador.
RangeSlider.SnapOnReleaseEl control deslizante no se ajusta mientras se arrastra, sino solo después de soltar el controlador.

Para ver explicaciones visuales de los distintos modos, consulta la documentación de « snapMode » en Slider.

Véase también stepSize.

stepSize : real

Esta propiedad indica 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 establece el umbral (en píxeles lógicos) a partir del cual se iniciará un evento de arrastre táctil. El umbral de arrastre con el 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).

Véase también QStyleHints.

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

Esta propiedad indica si el control deslizante es vertical.

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

Véase también orientation.

Documentación sobre señales

[since QtQuick.Controls 2.5] void first.moved()

[since QtQuick.Controls 2.5] void second.moved()

Esta señal se emite cuando el usuario ha movido de forma interactiva el primer o el segundo controlador, ya sea mediante el tacto, el ratón o el teclado.

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

Véase también first y second.

[since QtQuick.Controls 6.12] void handlesCrossedChanged()

Esta señal se emite cuando los manejadores se cruzan entre sí, lo que modifica la propiedad handlesCrossed.

Nota: El controlador correspondiente es onHandlesCrossedChanged.

Esta señal se introdujo en QtQuick.Controls 6.12.

Véase también crossingEnabled.

Documentación de métodos

void first.decrease()

Disminuye el valor del identificador en stepSize, o en 0.1 si no se ha definido stepSize.

Véase también first.

void first.increase()

Aumenta el valor del identificador en ` stepSize`, o en ` 0.1 ` si no se ha definido ` stepSize `.

Véase también first.

void second.decrease()

Disminuye el valor del identificador en ` stepSize`, o en ` 0.1 ` si no se ha definido ` stepSize `.

Véase también second.

void second.increase()

Aumenta el valor del identificador en ` stepSize` o en ` 0.1 ` si no se ha definido ` stepSize `.

Véase también second.

void setValues(real firstValue, real secondValue)

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

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

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

Esta función puede ser necesaria para establecer el primer y el segundo valor una vez finalizado el control, ya que existe una dependencia circular entre firstValue y secondValue que puede provocar que los valores asignados se limiten entre sí.

Véase también stepSize.

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

Devuelve el valor correspondiente al elemento « position » indicado.

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

Véase también first.value, second.value, first.position, second.position y live.

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