Slider QML Type
Se utiliza para seleccionar un valor deslizando un controlador a lo largo de una pista. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
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
Descripción detallada
El control deslizante se utiliza para seleccionar un valor deslizando un controlador 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, dentro del rango 0.0 - 1.0. La propiedad visualPosition es igual, salvo que se invierte en una aplicación de lectura de derecha a izquierda. La propiedad ` visualPosition ` resulta útil para posicionar el control deslizante al aplicar estilos al `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 control deslizante que permita al usuario seleccionar un rango mediante dos controladores, consulte 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.
handle : Item
Esta propiedad contiene el elemento de identificador.
Véase también «Personalización delcontrol deslizante».
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.
implicitHandleHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad contiene la altura implícita del control.
El valor es igual a handle ? handle.implicitHeight : 0.
Normalmente se utiliza, junto con ` implicitContentHeight ` y ` implicitBackgroundHeight`, para calcular el ` 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 el ancho implícito del control.
El valor es igual a handle ? handle.implicitWidth : 0.
Normalmente se utiliza, 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 indica si el control deslizante ofrece actualizaciones en tiempo real para la propiedad value mientras se arrastra el controlador.
El valor por defecto es true.
Esta propiedad se introdujo en QtQuick.Controls 2.2 (Qt 5.9).
Véase también value y valueAt().
orientation : enumeration
Esta propiedad define la orientación.
Valores posibles:
| Constante | Descripción |
|---|---|
Qt.Horizontal | Horizontal (por defecto) |
Qt.Vertical | Vertical |
Véase también horizontal y vertical.
position : real [read-only]
Esta propiedad contiene la posición lógica del control deslizante.
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 dirección de lectura de derecha a izquierda.
Véanse también ` value`, ` visualPosition` y ` valueAt()`.
pressed : bool
Esta propiedad se mantiene independientemente de si se pulsa el control deslizante mediante el tacto, el ratón o las teclas.
snapMode : enumeration
Esta propiedad define el modo de ajuste.
El modo de ajuste determina cómo se comporta el control deslizante en relación con la función « stepSize ».
Valores posibles:
| Constante | Descripción |
|---|---|
Slider.NoSnap | El control deslizante no se ajusta (valor predeterminado). |
Slider.SnapAlways | El control deslizante se ajusta mientras se arrastra el controlador. |
Slider.SnapOnRelease | El control deslizante no se ajusta mientras se arrastra, sino solo después de soltar el controlador. |
En la siguiente tabla se ilustran los distintos modos mediante animaciones. El movimiento del cursor del ratón y el de 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 indica 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.
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 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).
Véase también QStyleHints.
value : real
Esta propiedad toma valores comprendidos en el intervalo 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 control deslizante 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 define la posición visual del 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 lectura de derecha a izquierda.
Véase también position.
Documentación de Signal
[since QtQuick.Controls 2.2 (Qt 5.9)] moved()
Esta señal se emite cuando el usuario ha movido el control deslizante de forma interactiva mediante el tacto, el ratón, la rueda o las teclas.
Nota: El controlador correspondiente es onMoved.
Esta señal se introdujo en QtQuick.Controls 2.2 (Qt 5.9).
Documentación del método
void decrease()
Reduce el valor en stepSize o 0.1 si no se ha definido stepSize.
Véase también stepSize.
void increase()
Aumenta el valor en stepSize o en 0.1 si no se ha definido stepSize.
Véase también stepSize.
[since QtQuick.Controls 2.1 (Qt 5.8)] real valueAt(real position)
Devuelve el valor correspondiente al elemento « position » indicado.
Este método se introdujo en QtQuick.Controls 2.1 (Qt 5.8).
© 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.