En esta página

ScrollView QML Type

Vista desplazable. Más...

Import Statement: import QtQuick.Controls
Inherits:

Pane

Propiedades

Descripción detallada

ScrollView permite el desplazamiento de contenido definido por el usuario. Se puede utilizar tanto para sustituir un ` Flickable` como para personalizar uno ya existente.

Vista de desplazamiento que contiene contenido desplazable

El primer ejemplo muestra el uso más sencillo de ScrollView.

ScrollView {
    width: 200
    height: 200

    Label {
        text: "ABC"
        font.pixelSize: 224
    }
}

El segundo ejemplo ilustra el uso de un « Flickable » ya existente, es decir, un « ListView ».

ScrollView {
    width: 200
    height: 200

    ListView {
        model: 20
        delegate: ItemDelegate {
            text: "Item " + index

            required property int index
        }
    }
}

Nota: A partir de Qt-6.0, ScrollView recorta automáticamente su contenido si no se utiliza un Flickable como elemento secundario. Si no se desea esto, puedes establecer tu propio Flickable como elemento secundario y controlar explícitamente la propiedad clip del Flickable.

Dimensionamiento

Al igual que con Flickable, hay varios aspectos que hay que tener en cuenta al utilizar ScrollView:

  • Si solo se utiliza un único elemento dentro de un ScrollView, el tamaño del contenido se calcula automáticamente en función del tamaño implícito del elemento que contiene. Sin embargo, si se utiliza más de un elemento (o no se proporciona un tamaño implícito), las propiedades « contentWidth » y « contentHeight » deben establecerse en el tamaño combinado de los elementos que contiene.
  • Si el tamaño del contenido es menor o igual que el tamaño del ScrollView, no se podrá desplazar.
  • Si deseas que el ScrollView solo se desplace verticalmente, puedes vincular contentWidth a availableWidth (y viceversa para contentHeight). Esto permitirá que el contenido ocupe todo el espacio disponible horizontalmente dentro del ScrollView, teniendo en cuenta cualquier relleno o barra de desplazamiento.

Barras de desplazamiento

Se puede acceder a las barras de desplazamiento horizontal y vertical y personalizarlas mediante las propiedades asociadas ` ScrollBar.horizontal ` y ` ScrollBar.vertical `. El siguiente ejemplo ajusta las políticas de las barras de desplazamiento de modo que la barra de desplazamiento horizontal esté siempre desactivada y la vertical, siempre activada.

ScrollView {
    // ...
    ScrollBar.horizontal.policy: ScrollBar.AlwaysOff
    ScrollBar.vertical.policy: ScrollBar.AlwaysOn
}

Interacción táctil frente a interacción con el ratón

Al tocar la pantalla, ScrollView habilita el deslizamiento rápido y desactiva la interacción con las barras de desplazamiento.

Al interactuar con un dispositivo de ratón, el deslizamiento rápido se desactiva y las barras de desplazamiento son interactivas.

Las barras de desplazamiento pueden hacerse interactivas al tocar la pantalla, o no interactivas al interactuar con un ratón, estableciendo explícitamente la propiedad « interactive » en « true » o « false », respectivamente.

ScrollView {
    // ...
    ScrollBar.horizontal.interactive: true
    ScrollBar.vertical.interactive: true
}

Tamaños variables de los delegados

Los tamaños variables de los delegados pueden provocar que ScrollBar «salte» 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, ScrollIndicator, Personalización de ScrollView, controles contenedores y gestión del foco en los controles de Qt Quick .

Documentación de propiedades

contentChildren : list<Item>

Esta propiedad contiene la lista de elementos hijos de contenido.

La lista contiene todos los elementos que se han declarado en QML como hijos de la vista.

Nota: A diferencia de contentData, contentChildren no incluye objetos QML no visuales.

Véase también Item::children y contentData.

contentData : list<QtObject> [default]

Esta propiedad contiene la lista de datos de contenido.

La lista contiene todos los objetos que se han declarado en QML como hijos de la vista.

Nota: A diferencia de ` contentChildren`, ` contentData ` sí incluye objetos QML no visuales.

Véase también Item::data y contentChildren.

effectiveScrollBarHeight : real [since 6.6]

Esta propiedad contiene la altura efectiva de la barra de desplazamiento horizontal. Cuando la barra de desplazamiento está visible, esta propiedad corresponde a la altura actual de la barra. Cuando la barra de desplazamiento no está visible o su política está establecida en « QQuickScrollBar::AlwaysOff », esta propiedad es « 0 ».

Esta propiedad se introdujo en Qt 6.6.

Véase también « ScrollBar::policy ».

effectiveScrollBarWidth : real [since 6.6]

Esta propiedad contiene el ancho efectivo de la barra de desplazamiento vertical. Cuando la barra de desplazamiento está visible, esta propiedad corresponde al ancho actual de la barra. Cuando la barra de desplazamiento no está visible o su política está establecida en « QQuickScrollBar::AlwaysOff », esta propiedad es « 0 ».

Esta propiedad se introdujo en Qt 6.6.

Véase también ScrollBar::policy.

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