QScrollerProperties Class
Die Klasse „QScrollerProperties“ speichert die Einstellungen für einen „ QScroller “. Mehr...
| Header: | #include <QScrollerProperties> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
Öffentliche Typen
| enum | FrameRates { Fps60, Fps30, Fps20, Standard } |
| enum | OvershootPolicy { OvershootWhenScrollable, OvershootAlwaysOff, OvershootAlwaysOn } |
| enum | ScrollMetric { MousePressEventDelay, DragStartDistance, DragVelocitySmoothingFactor, AxisLockThreshold, ScrollingCurve, …, ScrollMetricCount } |
Öffentliche Funktionen
| 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 |
Statische öffentliche Elemente
| void | setDefaultScrollerProperties(const QScrollerProperties &sp) |
| void | unsetDefaultScrollerProperties() |
Ausführliche Beschreibung
Die Klasse `QScrollerProperties` speichert die von ` QScroller` verwendeten Parameter.
Die Standardeinstellungen sind plattformabhängig, sodass Qt das Plattformverhalten für kinetisches Scrollen emuliert.
Gemäß einer Konvention liegen die QScrollerProperties in physikalischen Einheiten (Meter, Sekunden) vor und werden von QScroller unter Verwendung der aktuellen DPI-Einstellung umgerechnet.
Siehe auch „ QScroller “.
Dokumentation zu den Mitgliedstypen
enum QScrollerProperties::FrameRates
Diese Enumeration beschreibt die verfügbaren Bildraten, die beim Ziehen oder Scrollen verwendet werden.
| Konstante | Wert | Beschreibung |
|---|---|---|
QScrollerProperties::Fps60 | 1 | 60 Bilder pro Sekunde |
QScrollerProperties::Fps30 | 2 | 30 Bilder pro Sekunde |
QScrollerProperties::Fps20 | 3 | 20 Bilder pro Sekunde |
QScrollerProperties::Standard | 0 | Der Standardwert beträgt 60 Bilder pro Sekunde (was QAbstractAnimation entspricht). |
enum QScrollerProperties::OvershootPolicy
Diese Enumeration beschreibt die verschiedenen Arten des Überschwingens.
| Konstante | Wert | Beschreibung |
|---|---|---|
QScrollerProperties::OvershootWhenScrollable | 0 | Ein Überschwingen ist möglich, wenn der Inhalt scrollbar ist. Dies ist die Standardeinstellung. |
QScrollerProperties::OvershootAlwaysOff | 1 | Ein Überschießen ist niemals aktiviert, selbst wenn der Inhalt scrollbar ist. |
QScrollerProperties::OvershootAlwaysOn | 2 | Das Überschreiten ist immer aktiviert, auch wenn der Inhalt nicht scrollbar ist. |
enum QScrollerProperties::ScrollMetric
Diese Enumeration enthält die verschiedenen Arten von Scroll-Metriken. Sofern nicht anders angegeben, erwartet die Funktion „ setScrollMetric “ einen „ QVariant “ vom Typ „qreal“.
Weitere Einzelheiten zu den Konzepten hinter den verschiedenen Werten finden Sie in der Dokumentation zu „ QScroller “.
| Konstante | Wert | Beschreibung |
|---|---|---|
QScrollerProperties::MousePressEventDelay | 0 | Dies ist die Zeit, um die ein Mausklick-Ereignis verzögert wird, wenn eine Flick-Geste in „ [s] “ gestartet wird. Wird die Geste innerhalb dieser Zeit ausgelöst, wird kein Mausklick oder -loslassen an das gescrollte Objekt gesendet. Wird die Geste nach Ablauf dieser Verzögerung ausgelöst, werden der verzögerte Mausklick sowie ein simuliertes Loslass-Ereignis an der globalen Position QPoint(-QWIDGETSIZE_MAX, -QWIDGETSIZE_MAX) gesendet. Wird die Geste abgebrochen, werden sowohl der verzögerte Mausklick als auch das tatsächliche Loslass-Ereignis übermittelt. |
QScrollerProperties::DragStartDistance | 1 | Dies ist die Mindestdistanz, um die der Touch- oder Mauspunkt bewegt werden muss, bevor die Flick-Geste in ` m` ausgelöst wird. |
QScrollerProperties::DragVelocitySmoothingFactor | 2 | Ein Wert, der beschreibt, inwieweit neue Ziehgeschwindigkeiten in die endgültige Scrollgeschwindigkeit einbezogen werden. Dieser Wert sollte im Bereich zwischen 0 und 1 liegen. Je niedriger der Wert, desto stärker wird die Ziehgeschwindigkeit geglättet. |
QScrollerProperties::AxisLockThreshold | 3 | Schränkt die Bewegung auf eine Achse ein, wenn die Bewegung innerhalb eines bestimmten Winkels um diese Achse erfolgt. Der Schwellenwert muss im Bereich von 0 bis 1 liegen. |
QScrollerProperties::ScrollingCurve | 4 | Der Wert „ QEasingCurve “, der beim Abbremsen der Scrollgeschwindigkeit nach einer vom Benutzer ausgelösten Wischgeste verwendet wird. Bitte beachten Sie, dass es sich hierbei um die Easing-Kurve für die Positionen handelt, nicht um die Geschwindigkeit: Der Standardwert ist „ QEasingCurve::OutQuad “, was zu einer linearen Abnahme der Geschwindigkeit (1. Ableitung) und einer konstanten Verzögerung (2. Ableitung) führt. |
QScrollerProperties::DecelerationFactor | 5 | Dieser Faktor beeinflusst, wie lange es dauert, bis der Scroller auf eine Geschwindigkeit von 0 abbremste. Der tatsächliche Wert hängt von der gewählten ScrollingCurve ab. Für die meisten Typen sollte der Wert im Bereich von 0.1 bis 2.0 |
QScrollerProperties::MinimumVelocity | 6 | Die Mindestgeschwindigkeit, die nach Beendigung der Berührung oder dem Loslassen der Maus erforderlich ist, um das Scrollen in „ m/s “ zu starten. |
QScrollerProperties::MaximumVelocity | 7 | Dies ist die maximale Geschwindigkeit, die in m/s erreicht werden kann. |
QScrollerProperties::MaximumClickThroughVelocity | 8 | Dies ist die maximal zulässige Scrollgeschwindigkeit für einen Klick-Through in m/s. Das bedeutet, dass ein Klick auf ein Objekt, das gerade (langsam) scrollt, nicht nur das Scrollen stoppt, sondern das Klick-Ereignis auch an das UI-Steuerelement weitergeleitet wird. Dies ist nützlich, wenn exponentielle Scrollkurven verwendet werden. |
QScrollerProperties::AcceleratingFlickMaximumTime | 9 | Dies ist die maximale Zeit in „ seconds “, die eine Flick-Geste benötigen darf, um als beschleunigender Flick erkannt zu werden. Bei einer Einstellung von Null wird keine solche Geste erkannt. Ein „beschleunigender Flick“ ist eine Flick-Geste, die auf einem bereits scrollenden Objekt ausgeführt wird. In solchen Fällen wird die Scrollgeschwindigkeit mit dem „AcceleratingFlickSpeedupFactor“ multipliziert, um sie zu beschleunigen. |
QScrollerProperties::AcceleratingFlickSpeedupFactor | 10 | Die aktuelle Geschwindigkeit wird mit diesem Wert multipliziert, wenn ein beschleunigender Flick erkannt wird. Sollte „ >= 1 “ betragen. |
QScrollerProperties::SnapPositionRatio | 11 | Dies ist die Strecke, über die der Benutzer den Bereich zwischen zwei Einrastpunkten ziehen muss, um ihn an der nächsten Position einrasten zu lassen. „ 0.33 “ bedeutet, dass der Bildlauf nur ein Drittel der Strecke zwischen zwei Einrastpunkten zurücklegen muss, um am nächsten Einrastpunkt einzurasten. Das Verhältnis muss zwischen „ 0 “ und „ 1 “ liegen. |
QScrollerProperties::SnapTime | 12 | Dies ist der Zeitfaktor für die Scrollkurve. Ein niedrigerer Wert bedeutet, dass das Scrollen länger dauert. Die Scrollstrecke ist unabhängig von diesem Wert. |
QScrollerProperties::OvershootDragResistanceFactor | 13 | Dieser Wert ist der Faktor zwischen der Mausbewegung und der tatsächlichen Bewegung des Scrollbereichs (während des Überschwingens). Der Faktor muss zwischen 0 und 1 liegen. |
QScrollerProperties::OvershootDragDistanceFactor | 14 | Dies ist die maximale Strecke für Überschwingsbewegungen beim Ziehen. Die tatsächliche Überschwingsstrecke wird durch Multiplikation dieses Werts mit der Ansichtsbereichsgröße des gescrollten Objekts berechnet. Der Faktor muss zwischen 0 und 1 liegen. |
QScrollerProperties::OvershootScrollDistanceFactor | 15 | Dies ist die maximale Entfernung für Überschwingsbewegungen beim Scrollen. Die tatsächliche Überschwingentfernung wird durch Multiplikation dieses Werts mit der Ansichtsfenstergröße des gescrollten Objekts berechnet. Der Faktor muss zwischen 0 und 1 liegen. |
QScrollerProperties::OvershootScrollTime | 16 | Dies ist die Zeit in seconds, die für die Wiedergabe der gesamten Überschwingsanimation verwendet wird. |
QScrollerProperties::HorizontalOvershootPolicy | 17 | Dies ist die Richtlinie für horizontales Überschwingen (siehe OvershootPolicy). |
QScrollerProperties::VerticalOvershootPolicy | 18 | Dies ist die Richtlinie für das horizontale Überschwingen (siehe OvershootPolicy). |
QScrollerProperties::FrameRate | 19 | Dies ist die Bildrate, die beim Ziehen oder Scrollen verwendet werden soll. „ QScroller “ nutzt intern einen „ QAbstractAnimation “-Timer, um alle Scrollvorgänge mit anderen Animationen zu synchronisieren, die möglicherweise gleichzeitig aktiv sind. Wenn der Standardwert von 60 Bildern pro Sekunde zu hoch ist, kann er mit dieser Einstellung gesenkt werden, wobei die Synchronisation mit QAbstractAnimation weiterhin gewährleistet bleibt. Bitte beachten Sie, dass hier nur die Werte der Enumeration „ FrameRates “ zulässig sind. |
QScrollerProperties::ScrollMetricCount | 20 | Dies ist immer der letzte Eintrag. |
Dokumentation der Member-Funktionen
QScrollerProperties::QScrollerProperties()
Erstellt neue Scroller-Eigenschaften.
QScrollerProperties::QScrollerProperties(const QScrollerProperties &sp)
Erstellt eine Kopie von „ sp “.
[virtual noexcept] QScrollerProperties::~QScrollerProperties()
Löscht die Eigenschaften des Scrollers.
QVariant QScrollerProperties::scrollMetric(QScrollerProperties::ScrollMetric metric) const
Fragen Sie den Wert „ metric “ der Scroller-Eigenschaften ab.
Siehe auch „ setScrollMetric()“ und „ ScrollMetric “.
[static] void QScrollerProperties::setDefaultScrollerProperties(const QScrollerProperties &sp)
Legt die Scroller-Eigenschaften für alle neuen „ QScrollerProperties “-Objekte auf „ sp “ fest.
Verwenden Sie diese Funktion, um die vom Standardkonstruktor zurückgegebenen Plattform-Standardeigenschaften zu überschreiben. Wenn Sie nur die Scroller-Eigenschaften eines einzelnen Scrollers ändern möchten, verwenden Sie ` QScroller::setScrollerProperties()`
Hinweis: Der Aufruf dieser Funktion hat keine Auswirkungen auf den Inhalt bereits vorhandener ` QScrollerProperties `-Objekte.
Siehe auch ` unsetDefaultScrollerProperties()`.
void QScrollerProperties::setScrollMetric(QScrollerProperties::ScrollMetric metric, const QVariant &value)
Setzen Sie einen bestimmten Wert für die „ metric “-ScrollerMetric auf „ value “.
Siehe auch „ scrollMetric()“ und „ ScrollMetric “.
[static] void QScrollerProperties::unsetDefaultScrollerProperties()
Setzt die vom Standardkonstruktor zurückgegebenen Eigenschaften des Scrollers wieder auf die Plattform-Standardeigenschaften zurück.
Siehe auch setDefaultScrollerProperties().
bool QScrollerProperties::operator!=(const QScrollerProperties &sp) const
Gibt „ true “ zurück, wenn sich diese Scroller-Eigenschaften von „ sp “ unterscheiden; andernfalls wird „ false “ zurückgegeben.
QScrollerProperties &QScrollerProperties::operator=(const QScrollerProperties &sp)
Weist diesen Scroller-Eigenschaften „ sp “ zu und gibt eine Referenz auf diese Scroller-Eigenschaften zurück.
bool QScrollerProperties::operator==(const QScrollerProperties &sp) const
Gibt „ true “ zurück, wenn diese Scroller-Eigenschaften den Werten „ sp “ entsprechen; andernfalls wird „ false “ zurückgegeben.
© 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.
