Slider QML Type

Se utiliza para seleccionar un valor deslizando un tirador a lo largo de una pista. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

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

Señales

• moved() (since QtQuick.Controls 2.2 (Qt 5.9))

Métodos

• void decrease()
• void increase()
• real valueAt(real position) (since QtQuick.Controls 2.1 (Qt 5.8))

Descripción detallada

Slider se utiliza para seleccionar un valor deslizando un tirador a lo largo de una pista.

En el ejemplo siguiente, se establecen los valores personalizados from, value, y to:

Slider {
    from: 1
    value: 25
    to: 100
}

La propiedad position se expresa como una fracción del tamaño del control, en el rango 0.0 - 1.0. La propiedad visualPosition es la misma, excepto que se invierte en una aplicación de derecha a izquierda. La propiedad visualPosition es útil para posicionar el manejador cuando se estiliza el Slider. En el ejemplo anterior, 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 permite al usuario seleccionar un rango proporcionando dos manejadores, ver RangeSlider.

Véase también Personalización de controlesdeslizantes y de entrada.

Documentación de propiedades

from : real

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

Véase también to y value.

handle : Item

Esta propiedad contiene el elemento manejador.

Véase también Personalización del deslizador.

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.

implicitHandleHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Esta propiedad contiene la altura implícita del asa.

El valor es igual a handle ? handle.implicitHeight : 0.

Se utiliza normalmente, junto con implicitContentHeight y implicitBackgroundHeight, para calcular la implicitHeight.

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

Véase también implicitHandleWidth.

implicitHandleWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Esta propiedad contiene la anchura implícita del asa.

El valor es igual a handle ? handle.implicitWidth : 0.

Se utiliza normalmente, junto con implicitContentWidth y implicitBackgroundWidth, para calcular el implicitWidth.

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

Véase también implicitHandleHeight.

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

Esta propiedad establece si el deslizador proporciona actualizaciones en tiempo real para la propiedad value mientras se arrastra el manejador.

El valor por defecto es true.

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

Ver también value y valueAt().

orientation : enumeration

Esta propiedad contiene la orientación.

Valores posibles:

Véase también horizontal y vertical.

position : real [read-only]

Esta propiedad contiene la posición lógica del control.

La posición se expresa como una fracción del tamaño del control, en el rango 0.0 - 1.0. Para visualizar un deslizador, se debe utilizar en su lugar la consciente de derecha a izquierda visualPosition.

Véase también value, visualPosition, y valueAt().

pressed : bool

Esta propiedad indica si el deslizador se pulsa mediante el tacto, el ratón o las teclas.

snapMode : enumeration

Esta propiedad contiene el modo de ajuste.

El modo de ajuste determina cómo se comporta el control deslizante con respecto a stepSize.

Valores posibles:

En la tabla siguiente se ilustran los distintos modos con animaciones. El movimiento del cursor del ratón y la dirección stepSize (0.2) son idénticos en cada animación.

Valor	Ejemplo
Slider.NoSnap
Slider.SnapAlways
Slider.SnapOnRelease

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, increase(), y decrease().

to : real

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

Véase también from y 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.

value : real

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

Véase también position.

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

Véase también orientation.

visualPosition : real [read-only]

Esta propiedad contiene la posición visual del control.

La posición se expresa como una fracción del tamaño del control, en el rango 0.0 - 1.0. Cuando el control es mirrored, el valor es igual a 1.0 - position. Esto hace que el valor sea adecuado para visualizar el deslizador, teniendo en cuenta el soporte de derecha a izquierda.

Véase también position.

Documentación de la señal

[since QtQuick.Controls 2.2 (Qt 5.9)] moved()

Esta señal se emite cuando el deslizador ha sido movido interactivamente por el usuario, ya sea mediante el tacto, el ratón, la rueda o las teclas.

Esta señal fue introducida en QtQuick.Controls 2.2 (Qt 5.9).

Documentación del método

void decrease()

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

Véase también stepSize.

void increase()

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

Véase también stepSize.

[since QtQuick.Controls 2.1 (Qt 5.8)] real valueAt(real position)

Devuelve el valor de position.

Este método se introdujo en QtQuick.Controls 2.1 (Qt 5.8).

Véase también value y position.