QScrollEvent Class

Die Klasse QScrollEvent wird beim Scrollen gesendet. Mehr...

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

Öffentliche Typen

enum ScrollState { ScrollStarted, ScrollUpdated, ScrollFinished }

Öffentliche Funktionen

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

Detaillierte Beschreibung

Das Scroll-Ereignis wird gesendet, um anzuzeigen, dass der Empfänger gescrollt werden soll. Normalerweise sollte der Empfänger etwas Visuelles wie QWidget oder QGraphicsObject sein.

Es sollte darauf geachtet werden, dass keine widersprüchlichen QScrollEvents von zwei Quellen gesendet werden. Die Verwendung von QScroller::scrollTo ist jedoch sicher.

Siehe auch QScrollPrepareEvent und QScroller.

Dokumentation der Membertypen

enum QScrollEvent::ScrollState

Diese Aufzählung beschreibt die Zustände, die ein Bildlaufereignis annehmen kann.

KonstanteWertBeschreibung
QScrollEvent::ScrollStarted0Für das erste Bildlaufereignis einer Bildlaufaktivität gesetzt.
QScrollEvent::ScrollUpdated1Gesetzt für alle Ereignisse außer dem ersten und dem letzten Bildlaufereignis einer Bildlaufaktivität.
QScrollEvent::ScrollFinished2Wird für das letzte Bildlaufereignis einer Bildlaufaktivität gesetzt.

Siehe auch QScrollEvent::scrollState().

Dokumentation der Mitgliedsfunktionen

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

Erstellt ein neues QScrollEvent contentPos ist die neue Position des Inhalts, overshootDistance ist der neue Überlaufabstand und scrollState gibt an, ob dieses Scroll-Ereignis das erste, das letzte oder ein Ereignis dazwischen ist.

QPointF QScrollEvent::contentPos() const

Gibt die neue Bildlaufposition zurück.

QPointF QScrollEvent::overshootDistance() const

Gibt den neuen Überschwingungsabstand zurück. Siehe QScroller für eine Erklärung des Begriffs "Überschwingen".

Siehe auch QScroller.

QScrollEvent::ScrollState QScrollEvent::scrollState() const

Gibt den aktuellen Bildlaufzustand als Kombination von ScrollStateFlag-Werten zurück. ScrollStarted (oder ScrollFinished) wird gesetzt, wenn dieses Scroll-Ereignis das erste (oder letzte) Ereignis in einer Scroll-Aktivität ist. Bitte beachten Sie, dass beide Werte gleichzeitig gesetzt werden können, wenn die Aktivität aus einem einzigen QScrollEvent besteht. Bei allen anderen Scroll-Ereignissen dazwischen wird der Status auf ScrollUpdated gesetzt.

Ein Widget könnte zum Beispiel die Auswahl umkehren, wenn der Bildlauf gestartet und gestoppt wird.

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