QScrollEvent Class
Die Klasse „QScrollEvent“ wird beim Scrollen ausgelöst. Mehr...
| Header: | #include <QScrollEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Erbt von: | QEvent |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QScrollEvent ist Teil der Ereignisklassen.
Ö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 |
Geschützte Funktionen
| QScrollEvent(QScrollEvent &&) | |
| QScrollEvent & | operator=(QScrollEvent &&) |
| QScrollEvent & | operator=(const QScrollEvent &other) |
Ausführliche Beschreibung
Das Scroll-Ereignis wird gesendet, um anzuzeigen, dass der Empfänger gescrollt werden soll. In der Regel sollte es sich bei dem Empfänger um ein visuelles Element handeln, wie beispielsweise QWidget oder QGraphicsObject.
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 zu Mitgliedstypen
enum QScrollEvent::ScrollState
Diese Enumeration beschreibt die möglichen Zustände eines Scroll-Ereignisses.
| Konstante | Wert | Beschreibung |
|---|---|---|
QScrollEvent::ScrollStarted | 0 | Wird für das erste Scroll-Ereignis einer Scroll-Aktivität gesetzt. |
QScrollEvent::ScrollUpdated | 1 | Wird für alle Scroll-Ereignisse einer Scroll-Aktivität außer dem ersten und dem letzten gesetzt. |
QScrollEvent::ScrollFinished | 2 | Wird für das letzte Scroll-Ereignis einer Scroll-Aktivität gesetzt. |
Siehe auch „ QScrollEvent::scrollState()“.
Dokumentation der Member-Funktionen
QScrollEvent::QScrollEvent(const QPointF &contentPos, const QPointF &overshootDistance, QScrollEvent::ScrollState scrollState)
Erzeugt ein neues QScrollEvent- contentPos ist die neue Position des Inhalts, overshootDistance ist die neue Überlaufdistanz, während scrollState angibt, ob es sich bei diesem Scroll-Ereignis um das erste, das letzte oder ein dazwischenliegendes Ereignis handelt.
[protected delete] QScrollEvent::QScrollEvent(QScrollEvent &&)
Erstellt eine Instanz von ` QScrollEvent`. Diese Funktion wurde gelöscht.
QPointF QScrollEvent::contentPos() const
Gibt die neue Bildlaufposition zurück.
QPointF QScrollEvent::overshootDistance() const
Gibt den neuen Überschwingungsabstand zurück. Eine Erläuterung des Begriffs „Überschwingung“ finden Sie unter QScroller.
Siehe auch QScroller.
QScrollEvent::ScrollState QScrollEvent::scrollState() const
Gibt den aktuellen Scroll-Zustand als Kombination von ScrollStateFlag-Werten zurück. „ ScrollStarted “ (oder „ ScrollFinished “) wird gesetzt, wenn dieses Scroll-Ereignis das erste (bzw. letzte) Ereignis innerhalb 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 beispielsweise Auswahlen beim Starten und Beenden des Scrollvorgangs zurücksetzen.
[protected delete] QScrollEvent &QScrollEvent::operator=(QScrollEvent &&)
Weist „ other “ dieser „ QScrollEvent “-Instanz zu. Diese Funktion wird gelöscht.
[noexcept protected default] QScrollEvent &QScrollEvent::operator=(const QScrollEvent &other)
Weist dieser „ QScrollEvent “-Instanz „ other “ zu.
© 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.
