Sur cette page

QScrollEvent Class

La classe QScrollEvent est déclenchée lors du défilement. En savoir plus...

En-tête : #include <QScrollEvent>
CMake : find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake : QT += gui
Hérite de : QEvent

Types publics

enum ScrollState { ScrollStarted, ScrollUpdated, ScrollFinished }

Fonctions publiques

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

Fonctions protégées

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

Description détaillée

L'événement de défilement est envoyé pour indiquer que l'élément récepteur doit être défilé. Généralement, l'élément récepteur doit être un élément visuel tel que QWidget ou QGraphicsObject.

Il convient de veiller à ce qu’aucun événement QScrollEvent conflictuel ne soit envoyé par deux sources différentes. L’utilisation de QScroller::scrollTo est toutefois sans risque.

Voir également QScrollPrepareEvent et QScroller.

Documentation sur les types de membres

enum QScrollEvent::ScrollState

Cette énumération décrit les états possibles d'un événement de défilement.

ConstanteValeurDescription
QScrollEvent::ScrollStarted0Définie pour le premier événement de défilement d’une activité de défilement.
QScrollEvent::ScrollUpdated1Définie pour tous les événements de défilement d'une activité de défilement, à l'exception du premier et du dernier.
QScrollEvent::ScrollFinished2Définie pour le dernier événement de défilement d'une activité de défilement.

Voir également QScrollEvent::scrollState().

Documentation des fonctions membres

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

Crée un nouvel objet `QScrollEvent` : ` contentPos ` correspond à la nouvelle position du contenu, ` overshootDistance ` à la nouvelle distance de dépassement, tandis que ` scrollState ` indique si cet événement de défilement est le premier, le dernier ou un événement intermédiaire.

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

Crée par « move » une instance de ` QScrollEvent`. Cette fonction est supprimée.

QPointF QScrollEvent::contentPos() const

Renvoie la nouvelle position de défilement.

QPointF QScrollEvent::overshootDistance() const

Renvoie la nouvelle distance de dépassement. Voir QScroller pour une explication du terme « dépassement ».

Voir également QScroller.

QScrollEvent::ScrollState QScrollEvent::scrollState() const

Renvoie l'état actuel du défilement sous la forme d'une combinaison de valeurs ScrollStateFlag. La valeur « ScrollStarted » (ou « ScrollFinished ») sera définie si cet événement de défilement est le premier (ou le dernier) d'une séquence de défilement. Veuillez noter que ces deux valeurs peuvent être définies simultanément si l’activité se compose d’un seul événement « QScrollEvent ». Tous les autres événements de défilement intermédiaires verront leur état défini sur « ScrollUpdated ».

Un widget pourrait, par exemple, annuler les sélections lorsque le défilement démarre et s’arrête.

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

La commande « Move » affecte « other » à cette instance « QScrollEvent ». Cette fonction est supprimée.

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

Attribue par copie l'other à cette instance d'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.