QScrollerProperties Class
La classe QScrollerProperties stocke les paramètres d'un QScroller. Plus....
| En-tête : | #include <QScrollerProperties> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
Types publics
| enum | FrameRates { Fps60, Fps30, Fps20, Standard } |
| enum | OvershootPolicy { OvershootWhenScrollable, OvershootAlwaysOff, OvershootAlwaysOn } |
| enum | ScrollMetric { MousePressEventDelay, DragStartDistance, DragVelocitySmoothingFactor, AxisLockThreshold, ScrollingCurve, …, ScrollMetricCount } |
Fonctions publiques
| QScrollerProperties() | |
| QScrollerProperties(const QScrollerProperties &sp) | |
| virtual | ~QScrollerProperties() |
| QVariant | scrollMetric(QScrollerProperties::ScrollMetric metric) const |
| void | setScrollMetric(QScrollerProperties::ScrollMetric metric, const QVariant &value) |
| bool | operator!=(const QScrollerProperties &sp) const |
| QScrollerProperties & | operator=(const QScrollerProperties &sp) |
| bool | operator==(const QScrollerProperties &sp) const |
Membres publics statiques
| void | setDefaultScrollerProperties(const QScrollerProperties &sp) |
| void | unsetDefaultScrollerProperties() |
Description détaillée
La classe QScrollerProperties stocke les paramètres utilisés par QScroller.
Les paramètres par défaut dépendent de la plate-forme, de sorte que Qt émule le comportement de la plate-forme pour le défilement cinétique.
Par convention, les QScrollerProperties sont exprimées en unités physiques (mètres, secondes) et sont converties par QScroller en utilisant le DPI actuel.
Voir également QScroller.
Documentation sur les types de membres
enum QScrollerProperties::FrameRates
Cette énumération décrit les fréquences d'images disponibles utilisées lors d'un déplacement ou d'un défilement.
| Constante | Valeur | Description de la constante |
|---|---|---|
QScrollerProperties::Fps60 | 1 | 60 images par seconde |
QScrollerProperties::Fps30 | 2 | 30 images par seconde |
QScrollerProperties::Fps20 | 3 | 20 images par seconde |
QScrollerProperties::Standard | 0 | la valeur par défaut est de 60 images par seconde (ce qui correspond à QAbstractAnimation). |
enum QScrollerProperties::OvershootPolicy
Cette énumération décrit les différents modes de dépassement.
| Constante | Valeur | Description |
|---|---|---|
QScrollerProperties::OvershootWhenScrollable | 0 | Le dépassement est possible lorsque le contenu peut être déroulé. Il s'agit de la valeur par défaut. |
QScrollerProperties::OvershootAlwaysOff | 1 | Le dépassement n'est jamais activé, même lorsque le contenu est défilable. |
QScrollerProperties::OvershootAlwaysOn | 2 | Le dépassement est toujours activé, même lorsque le contenu n'est pas défilable. |
enum QScrollerProperties::ScrollMetric
Cette énumération contient les différents types de métriques de défilement. Sauf indication contraire, la fonction setScrollMetric attend une valeur QVariant de type qreal.
Voir la documentation QScroller pour plus de détails sur les concepts qui sous-tendent les différentes valeurs.
| Constante | Valeur | Description |
|---|---|---|
QScrollerProperties::MousePressEventDelay | 0 | C'est le temps de retard d'un événement de pression de la souris lors du démarrage d'un geste de pichenette dans [s]. Si le geste est déclenché dans ce délai, aucune pression ou relâchement de la souris n'est envoyé à l'objet défilant. S'il est déclenché après ce délai, la pression retardée de la souris ainsi qu'un faux événement de relâchement à la position globale QPoint(-QWIDGETSIZE_MAX, -QWIDGETSIZE_MAX) sont envoyés. Si le geste est annulé, la pression différée de la souris et l'événement de relâchement réel sont envoyés. |
QScrollerProperties::DragStartDistance | 1 | Il s'agit de la distance minimale à laquelle le point de contact ou le point de la souris doit être déplacé avant que le geste de pichenette ne soit déclenché à l'adresse m. |
QScrollerProperties::DragVelocitySmoothingFactor | 2 | Une valeur qui décrit dans quelle mesure les nouvelles vitesses de traînée sont incluses dans la vitesse de défilement finale. Cette valeur doit être comprise entre 0 et 1. Plus la valeur est faible, plus la vitesse de glissement est lissée. |
QScrollerProperties::AxisLockThreshold | 3 | Limite le mouvement à un axe si le mouvement se situe à l'intérieur d'un angle autour de l'axe. Le seuil doit être compris entre 0 et 1. |
QScrollerProperties::ScrollingCurve | 4 | QEasingCurve utilisé pour décélérer la vitesse de défilement après une pichenette initiée par l'utilisateur. Veuillez noter qu'il s'agit de la courbe d'assouplissement des positions, et non de la vitesse : la valeur par défaut est QEasingCurve::OutQuad, ce qui se traduit par une diminution linéaire de la vitesse (dérivée 1) et une décélération constante (dérivée 2). |
QScrollerProperties::DecelerationFactor | 5 | Ce facteur influence le temps nécessaire au défilement pour décélérer jusqu'à la vitesse 0. La valeur réelle dépend de la courbe de défilement choisie. Pour la plupart des types, la valeur doit être comprise entre 0.1 et 2.0 |
QScrollerProperties::MinimumVelocity | 6 | La vitesse minimale nécessaire après la fin du toucher ou le relâchement de la souris pour commencer le défilement à l'adresse m/s. |
QScrollerProperties::MaximumVelocity | 7 | C'est la vitesse maximale qui peut être atteinte dans m/s. |
QScrollerProperties::MaximumClickThroughVelocity | 8 | C'est la vitesse de défilement maximale autorisée pour un clic dans m/s. Cela signifie qu'un clic sur un objet en cours de défilement (lent) n'arrêtera pas seulement le défilement, mais que l'événement de clic sera également transmis au contrôle de l'interface utilisateur. Ceci est utile lors de l'utilisation de courbes de défilement de type exponentiel. |
QScrollerProperties::AcceleratingFlickMaximumTime | 9 | C'est le temps maximum en seconds qu'un geste de pichenette peut prendre pour être reconnu comme une pichenette accélérée. S'il est fixé à zéro, aucun geste de ce type n'est détecté. Une "pichenette accélérée" est un geste de pichenette exécuté sur un objet déjà en cours de défilement. Dans ce cas, la vitesse de défilement est multipliée par AcceleratingFlickSpeedupFactor afin de l'accélérer. |
QScrollerProperties::AcceleratingFlickSpeedupFactor | 10 | La vitesse actuelle est multipliée par ce nombre si une pichenette d'accélération est détectée. Doit être >= 1. |
QScrollerProperties::SnapPositionRatio | 11 | Il s'agit de la distance sur laquelle l'utilisateur doit faire glisser la zone entre deux points d'accrochage pour l'accrocher à la position suivante. 0.33 signifie que le défilement ne doit atteindre qu'un tiers de la distance entre deux points d'accrochage pour s'accrocher à la position suivante. Le rapport doit être compris entre 0 et 1. |
QScrollerProperties::SnapTime | 12 | Il s'agit du facteur de temps pour la courbe de défilement. Une valeur plus faible signifie que le défilement prendra plus de temps. La distance de défilement est indépendante de cette valeur. |
QScrollerProperties::OvershootDragResistanceFactor | 13 | Cette valeur est le facteur entre le glissement de la souris et le mouvement réel de la zone de défilement (pendant le dépassement). Le facteur doit être compris entre 0 et 1. |
QScrollerProperties::OvershootDragDistanceFactor | 14 | Il s'agit de la distance maximale pour les mouvements de dépassement lors du glissement de la souris. La distance de dépassement réelle est calculée en multipliant cette valeur par la taille de la fenêtre de l'objet à faire défiler. Le facteur doit être compris entre 0 et 1. |
QScrollerProperties::OvershootScrollDistanceFactor | 15 | Il s'agit de la distance maximale pour les mouvements de dépassement lors du défilement. La distance de dépassement réelle est calculée en multipliant cette valeur par la taille de la fenêtre de l'objet défilant. Le facteur doit être compris entre 0 et 1. |
QScrollerProperties::OvershootScrollTime | 16 | C'est le temps en seconds qui est utilisé pour jouer l'animation complète de dépassement. |
QScrollerProperties::HorizontalOvershootPolicy | 17 | Il s'agit de la politique de dépassement horizontal (voir OvershootPolicy). |
QScrollerProperties::VerticalOvershootPolicy | 18 | Il s'agit de la politique de dépassement horizontal (voir OvershootPolicy). |
QScrollerProperties::FrameRate | 19 | Il s'agit de la fréquence d'images qui doit être utilisée lors du glissement ou du défilement. QScroller utilise une minuterie QAbstractAnimation en interne pour synchroniser toutes les opérations de défilement avec d'autres animations susceptibles d'être actives en même temps. Si la valeur standard de 60 images par seconde est trop rapide, elle peut être abaissée avec ce paramètre, tout en restant synchronisée avec QAbstractAnimation. Veuillez noter que seules les valeurs de l'énumération FrameRates sont autorisées ici. |
QScrollerProperties::ScrollMetricCount | 20 | Il s'agit toujours de la dernière entrée. |
Documentation des fonctions membres
QScrollerProperties::QScrollerProperties()
Construit de nouvelles propriétés de défilement.
QScrollerProperties::QScrollerProperties(const QScrollerProperties &sp)
Construit une copie de sp.
[virtual noexcept] QScrollerProperties::~QScrollerProperties()
Détruit les propriétés du défilement.
QVariant QScrollerProperties::scrollMetric(QScrollerProperties::ScrollMetric metric) const
Demande la valeur metric des propriétés du scroller.
Voir aussi setScrollMetric() et ScrollMetric.
[static] void QScrollerProperties::setDefaultScrollerProperties(const QScrollerProperties &sp)
Définit les propriétés du défilement pour tous les nouveaux objets QScrollerProperties à sp.
Utilisez cette fonction pour remplacer les propriétés par défaut de la plate-forme renvoyées par le constructeur par défaut. Si vous souhaitez modifier les propriétés de défilement d'un seul défileur, utilisez QScroller::setScrollerProperties().
Remarque : l'appel à cette fonction ne modifiera pas le contenu des objets QScrollerProperties déjà existants.
Voir également unsetDefaultScrollerProperties().
void QScrollerProperties::setScrollMetric(QScrollerProperties::ScrollMetric metric, const QVariant &value)
Définir une valeur spécifique de metric ScrollerMetric à value.
Voir aussi scrollMetric() et ScrollMetric.
[static] void QScrollerProperties::unsetDefaultScrollerProperties()
Remet les propriétés du scroller renvoyées par le constructeur par défaut aux propriétés par défaut de la plate-forme.
Voir aussi setDefaultScrollerProperties().
bool QScrollerProperties::operator!=(const QScrollerProperties &sp) const
Renvoie true si ces propriétés de défilement sont différentes de sp; sinon, renvoie false.
QScrollerProperties &QScrollerProperties::operator=(const QScrollerProperties &sp)
Attribue sp à ces propriétés de défilement et renvoie une référence à ces propriétés de défilement.
bool QScrollerProperties::operator==(const QScrollerProperties &sp) const
Renvoie true si ces propriétés de défilement sont égales à sp; sinon, renvoie false.
© 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.
