En esta página

QScrollEvent Class

La clase QScrollEvent se envía al desplazar la pantalla. Más información...

Encabezado: #include <QScrollEvent>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Heredado de: QEvent

Tipos públicos

enum ScrollState { ScrollStarted, ScrollUpdated, ScrollFinished }

Funciones públicas

QScrollEvent(const QPointF &contentPos, const QPointF &overshootDistance, QScrollEvent::ScrollState scrollState)
QPointF contentPos() const
QPointF overshootDistance() const
QScrollEvent::ScrollState scrollState() const

Funciones protegidas

QScrollEvent(QScrollEvent &&)
QScrollEvent &operator=(QScrollEvent &&)
QScrollEvent &operator=(const QScrollEvent &other)

Descripción detallada

El evento de desplazamiento se envía para indicar que se debe desplazar el receptor. Normalmente, el receptor debe ser un elemento visual, como QWidget o QGraphicsObject.

Hay que tener cuidado de que no se envíen eventos QScrollEvent conflictivos desde dos fuentes. No obstante, el uso de QScroller::scrollTo es seguro.

Véase también QScrollPrepareEvent y QScroller.

Documentación sobre tipos de miembros

enum QScrollEvent::ScrollState

Esta enumeración describe los estados que puede adoptar un evento de desplazamiento.

ConstanteValorDescripción
QScrollEvent::ScrollStarted0Se establece para el primer evento de desplazamiento de una actividad de desplazamiento.
QScrollEvent::ScrollUpdated1Se establece para todos los eventos de desplazamiento de una actividad de desplazamiento, excepto el primero y el último.
QScrollEvent::ScrollFinished2Se establece para el último evento de desplazamiento de una actividad de desplazamiento.

Véase también QScrollEvent::scrollState().

Documentación de funciones de miembro

QScrollEvent::QScrollEvent(const QPointF &contentPos, const QPointF &overshootDistance, QScrollEvent::ScrollState scrollState)

Crea un nuevo objeto `QScrollEvent`: ` contentPos ` es la nueva posición del contenido, ` overshootDistance ` es la nueva distancia de sobrepaso, mientras que ` scrollState ` indica si este evento de desplazamiento es el primero, el último o uno intermedio.

[protected delete] QScrollEvent::QScrollEvent(QScrollEvent &&)

Crea una instancia de « QScrollEvent » mediante «move». Esta función ha sido eliminada.

QPointF QScrollEvent::contentPos() const

Devuelve la nueva posición de desplazamiento.

QPointF QScrollEvent::overshootDistance() const

Devuelve la nueva distancia de sobrepaso. Consulta QScroller para obtener una explicación del término «sobrepaso».

Véase también QScroller.

QScrollEvent::ScrollState QScrollEvent::scrollState() const

Devuelve el estado actual de desplazamiento como una combinación de valores de ScrollStateFlag. Se establecerá « ScrollStarted » (o « ScrollFinished ») si este evento de desplazamiento es el primero (o el último) de una actividad de desplazamiento. Ten en cuenta que ambos valores pueden establecerse al mismo tiempo si la actividad consiste en un único QScrollEvent. El resto de eventos de desplazamiento que se produzcan entre medias tendrán su estado establecido en ScrollUpdated.

Un widget podría, por ejemplo, revertir las selecciones al iniciar y detener el desplazamiento.

[protected delete] QScrollEvent &QScrollEvent::operator=(QScrollEvent &&)

Asigna mediante «move» ` other ` a esta instancia de ` QScrollEvent `. Esta función se elimina.

[noexcept protected default] QScrollEvent &QScrollEvent::operator=(const QScrollEvent &other)

Asigna por copia other a esta instancia de QScrollEvent.

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