QScrollerProperties Class
La classe `QScrollerProperties` stocke les paramètres d'un ` QScroller`. En savoir 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, ce qui permet à Qt d’émuler le comportement de la plate-forme en matière de défilement cinétique.
Par convention, les valeurs de QScrollerProperties sont exprimées en unités physiques (mètres, secondes) et sont converties par QScroller à l’aide du 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 lors d'un glissement ou d'un défilement.
| Constante | Valeur | Description |
|---|---|---|
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 est défilable. 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 mesures de défilement. Sauf indication contraire, la fonction ` setScrollMetric ` attend une valeur de type ` QVariant ` de type `qreal`.
Consultez la documentation de QScroller pour plus de détails sur les concepts sous-jacents aux différentes valeurs.
| Constante | Valeur | Description |
|---|---|---|
QScrollerProperties::MousePressEventDelay | 0 | Il s'agit du délai d'attente d'un événement de clic de souris lors du lancement d'un geste de balayage dans [s]. Si le geste est déclenché pendant ce délai, aucun clic ni relâchement de souris n'est envoyé à l'objet défilé. S'il est déclenché après ce délai, le clic de souris différé ainsi qu'un événement de relâchement simulé à la position globale QPoint(-QWIDGETSIZE_MAX, -QWIDGETSIZE_MAX) sont envoyés. Si le geste est annulé, le clic de souris différé et l'événement de relâchement réel sont tous deux transmis. |
QScrollerProperties::DragStartDistance | 1 | Il s’agit de la distance minimale que le point de contact ou le pointeur de la souris doit parcourir avant que le geste de balayage ne soit déclenché, définie dans ` m`. |
QScrollerProperties::DragVelocitySmoothingFactor | 2 | Valeur décrivant dans quelle mesure les nouvelles vitesses de glissement sont prises en compte dans la vitesse de défilement finale. Cette valeur doit être comprise entre 0 et 1. Plus la valeur est faible, plus le lissage appliqué à la vitesse de glissement est important. |
QScrollerProperties::AxisLockThreshold | 3 | Limite le mouvement à un seul axe si celui-ci se situe dans un certain angle autour de cet axe. Le seuil doit être compris entre 0 et 1. |
QScrollerProperties::ScrollingCurve | 4 | QEasingCurve utilisé lors de la décélération de la vitesse de défilement après un mouvement rapide initié par l'utilisateur. Veuillez noter qu’il s’agit de la courbe d’accélération/décélération pour les positions, et non pour la vitesse : la valeur par défaut est QEasingCurve::OutQuad, ce qui entraîne une diminution linéaire de la vitesse (dérivée première) et une décélération constante (dérivée seconde). |
QScrollerProperties::DecelerationFactor | 5 | Ce facteur influence le temps nécessaire au défilement pour décélérer jusqu’à une vitesse nulle. La valeur réelle dépend de la courbe de défilement (ScrollingCurve) choisie. Pour la plupart des types, la valeur doit se situer dans la plage comprise entre 0.1 et 2.0 |
QScrollerProperties::MinimumVelocity | 6 | La vitesse minimale requise après la fin du toucher ou le relâchement de la souris pour démarrer le défilement dans m/s. |
QScrollerProperties::MaximumVelocity | 7 | Il s’agit de la vitesse maximale pouvant être atteinte, en m/s. |
QScrollerProperties::MaximumClickThroughVelocity | 8 | Il s’agit de la vitesse de défilement maximale autorisée pour un « click-through » 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 | Il s’agit de la durée maximale, dans seconds, pendant laquelle un geste de balayage peut être reconnu comme un « balayage accéléré ». Si cette valeur est définie sur zéro, aucun geste de ce type n’est détecté. Un « flick accéléré » est un geste de flick exécuté sur un objet déjà en 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 un « flick accéléré » est détecté. Doit être défini sur « >= 1 ». |
QScrollerProperties::SnapPositionRatio | 11 | Il s’agit de la distance que l’utilisateur doit faire glisser la zone entre deux points d’accrochage pour l’accrocher à la position suivante. La valeur « 0.33 » signifie que le défilement ne doit atteindre qu’un tiers de la distance entre deux points d’accrochage pour s’accrocher au suivant. Le rapport doit être compris entre 0 et 1. |
QScrollerProperties::SnapTime | 12 | Il s’agit du facteur temporel de 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 correspond au rapport entre le glissement de la souris et le déplacement réel de la zone de défilement (lors d'un dépassement). Ce rapport doit être compris entre 0 et 1. |
QScrollerProperties::OvershootDragDistanceFactor | 14 | Il s'agit de la distance maximale des mouvements de dépassement lors du glissement. La distance réelle de dépassement est calculée en multipliant cette valeur par la taille de la fenêtre d'affichage de l'objet défilé. Le facteur doit être compris entre 0 et 1. |
QScrollerProperties::OvershootScrollDistanceFactor | 15 | Il s'agit de la distance maximale des mouvements de dépassement lors du défilement. La distance réelle de dépassement est calculée en multipliant cette valeur par la taille de la fenêtre d'affichage de l'objet défilé. Le facteur doit être compris entre 0 et 1. |
QScrollerProperties::OvershootScrollTime | 16 | Il s’agit de la durée, exprimée en seconds, nécessaire pour lire 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 à utiliser lors d'un glissement ou d'un défilement. QScroller utilise en interne un minuteur « QAbstractAnimation » pour synchroniser toutes les opérations de défilement avec les autres animations susceptibles d'être actives en même temps. Si la valeur par défaut de 60 images par seconde est trop rapide, elle peut être réduite à l’aide de 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()
Crée de nouvelles propriétés pour le scroller.
QScrollerProperties::QScrollerProperties(const QScrollerProperties &sp)
Crée une copie de sp.
[virtual noexcept] QScrollerProperties::~QScrollerProperties()
Supprime les propriétés du défilement.
QVariant QScrollerProperties::scrollMetric(QScrollerProperties::ScrollMetric metric) const
Interroger la valeur « metric » des propriétés du défilement.
Voir également setScrollMetric() et ScrollMetric.
[static] void QScrollerProperties::setDefaultScrollerProperties(const QScrollerProperties &sp)
Définit les propriétés du scroller pour tous les nouveaux objets ` QScrollerProperties ` sur ` sp`.
Utilisez cette fonction pour remplacer les propriétés par défaut de la plateforme renvoyées par le constructeur par défaut. Si vous souhaitez modifier uniquement les propriétés d'un seul scroller, utilisez QScroller::setScrollerProperties()
Remarque : l'appel de cette fonction ne modifie pas le contenu des objets ` QScrollerProperties ` déjà existants.
Voir également unsetDefaultScrollerProperties().
void QScrollerProperties::setScrollMetric(QScrollerProperties::ScrollMetric metric, const QVariant &value)
Définissez la valeur de la propriété ` metric ` de `ScrollerMetric` sur ` value`.
Voir également scrollMetric() et ScrollMetric.
[static] void QScrollerProperties::unsetDefaultScrollerProperties()
Rétablit les propriétés du défilement renvoyées par le constructeur par défaut aux valeurs par défaut de la plateforme.
Voir également setDefaultScrollerProperties().
bool QScrollerProperties::operator!=(const QScrollerProperties &sp) const
Renvoie « true » si ces propriétés du défilement diffèrent de « sp » ; sinon, renvoie « false ».
QScrollerProperties &QScrollerProperties::operator=(const QScrollerProperties &sp)
Attribue des valeurs « sp » à ces propriétés du défilement et renvoie une référence à ces propriétés.
bool QScrollerProperties::operator==(const QScrollerProperties &sp) const
Renvoie « true » si ces propriétés du 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.
