ScrollIndicator QML Type
Indicador de desplazamiento vertical u horizontal no interactivo. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades
- active : bool
- horizontal : bool
(since QtQuick.Controls 2.3 (Qt 5.10)) - minimumSize : real
(since QtQuick.Controls 2.4 (Qt 5.11)) - orientation : enumeration
- position : real
- size : real
- vertical : bool
(since QtQuick.Controls 2.3 (Qt 5.10)) - visualPosition : real
(since QtQuick.Controls 2.4 (Qt 5.11)) - visualSize : real
(since QtQuick.Controls 2.4 (Qt 5.11))
Propiedades adjuntas
- horizontal : ScrollIndicator
- vertical : ScrollIndicator
Descripción detallada
ScrollIndicator es un indicador no interactivo que muestra la posición actual de desplazamiento. Un indicador de desplazamiento puede ser de tipo « vertical » o « horizontal », y puede asociarse a cualquier « Flickable », como « ListView » y « GridView ».
Flickable {
// ...
ScrollIndicator.vertical: ScrollIndicator { }
}Adjuntar un ScrollIndicator a un Flickable
Nota: Cuando se vincula ScrollIndicator vertically o horizontally a un Flickable, su geometría y las siguientes propiedades se configuran y actualizan automáticamente según corresponda:
Un ScrollIndicator asociado se vincula al Flickable de destino. Un ScrollIndicator asociado verticalmente se redimensiona a la altura del Flickable y se coloca a uno de sus lados en función de la propiedad layout direction. Un ScrollIndicator asociado horizontalmente se redimensiona al ancho del Flickable y se coloca en la parte inferior. La gestión automática de la geometría se puede desactivar especificando otro elemento padre para el ScrollIndicator adjunto. Esto puede resultar útil, por ejemplo, si el ScrollIndicator debe colocarse fuera de un Flickable de recorte. Así se ilustra en el siguiente ejemplo:
Flickable {
id: flickable
clip: true
// ...
ScrollIndicator.vertical: ScrollIndicator {
parent: flickable.parent
anchors.top: flickable.top
anchors.left: flickable.right
anchors.bottom: flickable.bottom
}
}Vinculación del estado activo de los indicadores de desplazamiento horizontal y vertical
Los indicadores de desplazamiento horizontal y vertical no comparten entre sí el estado « active » de forma predeterminada. Para mantener ambos indicadores visibles mientras se desplaza en cualquier dirección, establezca un enlace bidireccional entre los estados activos tal y como se muestra en el siguiente ejemplo:
Flickable {
anchors.fill: parent
contentWidth: parent.width * 2
contentHeight: parent.height * 2
ScrollIndicator.horizontal: ScrollIndicator { id: hbar; active: vbar.active }
ScrollIndicator.vertical: ScrollIndicator { id: vbar; active: hbar.active }
}Indicadores de desplazamiento no adjuntos
Es posible crear una instancia de `ScrollIndicator` sin utilizar la API de propiedades adjuntas. Esto resulta útil cuando el comportamiento del indicador de desplazamiento adjunto no es suficiente o no se utiliza ` Flickable `. En el siguiente ejemplo, se utilizan indicadores de desplazamiento horizontal y vertical para indicar hasta dónde ha desplazado el usuario el texto (utilizando ` MouseArea ` en lugar de ` Flickable`):
Rectangle {
id: frame
clip: true
width: 160
height: 160
border.color: "black"
anchors.centerIn: parent
Text {
id: content
text: "ABC"
font.pixelSize: 169
MouseArea {
id: mouseArea
drag.target: content
drag.minimumX: frame.width - width
drag.minimumY: frame.height - height
drag.maximumX: 0
drag.maximumY: 0
anchors.fill: content
}
}
ScrollIndicator {
id: verticalIndicator
active: mouseArea.pressed
orientation: Qt.Vertical
size: frame.height / content.height
position: -content.y / content.height
anchors { top: parent.top; right: parent.right; bottom: parent.bottom }
}
ScrollIndicator {
id: horizontalIndicator
active: mouseArea.pressed
orientation: Qt.Horizontal
size: frame.width / content.width
position: -content.x / content.width
anchors { left: parent.left; right: parent.right; bottom: parent.bottom }
}
}
Tamaños variables de los delegados
Los tamaños variables de los delegados pueden hacer que ScrollIndicator «dé saltos» a medida que se cargan nuevos delegados en la vista. Por este motivo, se recomienda que los delegados tengan el mismo tamaño. Consulte Variable Delegate Size and Section Labels para obtener más información.
Véase también ScrollBar, Personalización de ScrollIndicator y Controles de indicador.
Documentación de propiedades
active : bool
Esta propiedad se mantiene independientemente de si el indicador está activo, es decir, cuando el Flickable asociado está en modo « moving ».
Es posible mantener « both horizontal and vertical indicators visible » mientras se desplaza en cualquier dirección.
Esta propiedad se establece automáticamente cuando el indicador de desplazamiento está en « attached to a flickable ».
horizontal : bool [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]
Esta propiedad indica si el indicador de desplazamiento es horizontal.
Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
Véase también orientation.
minimumSize : real [since QtQuick.Controls 2.4 (Qt 5.11)]
Esta propiedad contiene el tamaño mínimo del indicador, escalado a 0.0 - 1.0.
Esta propiedad se introdujo en QtQuick.Controls 2.4 (Qt 5.11).
Véase también size, visualSize y visualPosition.
orientation : enumeration
Esta propiedad define la orientación del indicador.
Valores posibles:
| Constante | Descripción |
|---|---|
Qt.Horizontal | Horizontal |
Qt.Vertical | Vertical (por defecto) |
Esta propiedad se establece automáticamente cuando el indicador de desplazamiento es « attached to a flickable ».
Véase también « horizontal » y « vertical ».
position : real
Esta propiedad contiene la posición del indicador, escalada a 0.0 - 1.0.
Esta propiedad se establece automáticamente cuando el indicador de desplazamiento es attached to a flickable.
Véase también « Flickable::visibleArea » y « visualPosition ».
size : real
Esta propiedad contiene el tamaño del indicador, escalado a 0.0 - 1.0.
Esta propiedad se establece automáticamente cuando el indicador de desplazamiento es « attached to a flickable ».
Véase también « Flickable::visibleArea », « minimumSize » y « visualSize ».
vertical : bool [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]
Esta propiedad indica si el indicador de desplazamiento es vertical.
Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
Véase también orientation.
visualPosition : real [since QtQuick.Controls 2.4 (Qt 5.11)]
Esta propiedad contiene la posición visual efectiva del indicador, que puede verse limitada por la propiedad « minimum size ».
Esta propiedad se introdujo en QtQuick.Controls 2.4 (Qt 5.11).
Véase también « position » y « minimumSize ».
visualSize : real [since QtQuick.Controls 2.4 (Qt 5.11)]
Esta propiedad contiene el tamaño visual efectivo del indicador, que puede verse limitado por la propiedad « minimum size ».
Esta propiedad se introdujo en QtQuick.Controls 2.4 (Qt 5.11).
Véase también « size » y « minimumSize ».
Documentación de la propiedad adjunta
ScrollIndicator.horizontal : ScrollIndicator [attached]
Esta propiedad añade un indicador de desplazamiento horizontal a un elemento ` Flickable`.
Flickable {
contentWidth: 2000
ScrollIndicator.horizontal: ScrollIndicator { }
}Véase también « Attaching ScrollIndicator to a Flickable ».
ScrollIndicator.vertical : ScrollIndicator [attached]
Esta propiedad añade un indicador de desplazamiento vertical a un elemento « Flickable ».
Flickable {
contentHeight: 2000
ScrollIndicator.vertical: ScrollIndicator { }
}Véase también « Attaching ScrollIndicator to a Flickable ».
© 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.