QScrollEvent Class
La classe QScrollEvent est envoyée lors du défilement. Plus d'informations...
| En-tête : | #include <QScrollEvent> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
| Héritages : | QEvent |
- Liste de tous les membres, y compris les membres hérités
- QScrollEvent fait partie des classes d'événements.
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 |
Description détaillée
L'événement de défilement est envoyé pour indiquer que le récepteur doit être défilé. En général, le destinataire doit être quelque chose de visuel comme QWidget ou QGraphicsObject.
Il convient de veiller à ce que deux sources n'envoient pas de QScrollEvents contradictoires. L'utilisation de QScroller::scrollTo est toutefois plus sûre.
Voir également QScrollPrepareEvent et QScroller.
Documentation sur les types de membres
enum QScrollEvent::ScrollState
Cette énumération décrit les états que peut avoir un événement de défilement.
| Constante | Valeur | Description de l'événement |
|---|---|---|
QScrollEvent::ScrollStarted | 0 | Défini pour le premier événement de défilement d'une activité de défilement. |
QScrollEvent::ScrollUpdated | 1 | Défini pour tous les événements de défilement d'une activité de défilement, à l'exception du premier et du dernier. |
QScrollEvent::ScrollFinished | 2 | Dé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 événement QScrollEvent contentPos est la nouvelle position du contenu, overshootDistance est la nouvelle distance de dépassement et scrollState indique si cet événement de défilement est le premier, le dernier ou un événement intermédiaire.
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 "overshoot".
Voir également QScroller.
QScrollEvent::ScrollState QScrollEvent::scrollState() const
Renvoie l'état actuel du défilement sous la forme d'une combinaison de valeurs ScrollStateFlag. ScrollStarted (ou ScrollFinished) sera défini si cet événement de défilement est le premier (ou le dernier) événement d'une activité de défilement. Veuillez noter que les deux valeurs peuvent être définies en même temps si l'activité consiste en un seul QScrollEvent. Tous les autres événements de défilement entre les deux auront leur état défini sur ScrollUpdated.
Un widget pourrait par exemple inverser les sélections lorsque le défilement est lancé et arrêté.
© 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.
