En esta página

QScrollEvent Class

La clase QScrollEvent es enviada al desplazarse. Más...

Cabecera: #include <QScrollEvent>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Hereda: 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

Descripción Detallada

El evento scroll es enviado para indicar que el receptor debe ser desplazado. Usualmente el receptor debe ser algo visual como QWidget o QGraphicsObject.

Se debe tener cuidado de que no se envien QScrollEvents conflictivos desde dos fuentes. Sin embargo, se puede usar QScroller::scrollTo.

Ver también QScrollPrepareEvent y QScroller.

Documentación de tipos de miembros

enum QScrollEvent::ScrollState

Este enum describe los estados que puede tener un evento de desplazamiento.

ConstanteValorDescripción
QScrollEvent::ScrollStarted0Establecido para el primer evento de desplazamiento de una actividad de desplazamiento.
QScrollEvent::ScrollUpdated1Establecido 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 la función miembro

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

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

QPointF QScrollEvent::contentPos() const

Devuelve la nueva posición de desplazamiento.

QPointF QScrollEvent::overshootDistance() const

Devuelve la nueva distancia de rebasamiento. Véase QScroller para una explicación del término rebasamiento.

Véase también QScroller.

QScrollEvent::ScrollState QScrollEvent::scrollState() const

Devuelve el estado de desplazamiento actual como una combinación de valores ScrollStateFlag. ScrollStarted (o ScrollFinished) si este evento de desplazamiento es el primero (o el último) de una actividad de desplazamiento. Tenga en cuenta que ambos valores pueden establecerse al mismo tiempo, si la actividad consiste en un único QScrollEvent. Todos los demás eventos de desplazamiento intermedios tendrán su estado establecido en ScrollUpdated.

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

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