QScrollerProperties Class
Die Klasse QScrollerProperties speichert die Einstellungen für ein QScroller. Mehr...
| Kopfzeile: | #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 Mitglieder
| void | setDefaultScrollerProperties(const QScrollerProperties &sp) |
| void | unsetDefaultScrollerProperties() |
Detaillierte Beschreibung
Die Klasse QScrollerProperties speichert die von QScroller verwendeten Parameter.
Die Standardeinstellungen sind plattformabhängig, so dass Qt das Verhalten der Plattform für kinetisches Scrollen emuliert.
Als Konvention sind die QScrollerProperties in physikalischen Einheiten (Meter, Sekunden) und werden von QScroller unter Verwendung der aktuellen DPI umgerechnet.
Siehe auch QScroller.
Dokumentation der Membertypen
enum QScrollerProperties::FrameRates
Diese Aufzählung 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 ist 60 Bilder pro Sekunde (das entspricht QAbstractAnimation). |
enum QScrollerProperties::OvershootPolicy
Diese Aufzählung beschreibt die verschiedenen Arten des Überschwingens.
| Konstante | Wert | Beschreibung |
|---|---|---|
QScrollerProperties::OvershootWhenScrollable | 0 | Überschwingen ist möglich, wenn der Inhalt scrollbar ist. Dies ist die Standardeinstellung. |
QScrollerProperties::OvershootAlwaysOff | 1 | Überschwingen ist nie aktiviert, auch wenn der Inhalt rollbar ist. |
QScrollerProperties::OvershootAlwaysOn | 2 | Das Überschwingen ist immer aktiviert, auch wenn der Inhalt nicht rollbar ist. |
enum QScrollerProperties::ScrollMetric
Diese Aufzählung enthält die verschiedenen metrischen Typen der Schriftrolle. Wenn nicht anders angegeben, erwartet die Funktion setScrollMetric eine QVariant vom Typ qreal.
Weitere Einzelheiten zu den Konzepten hinter den verschiedenen Werten finden Sie in der Dokumentation QScroller.
| Konstante | Wert | Beschreibung |
|---|---|---|
QScrollerProperties::MousePressEventDelay | 0 | Dies ist die Zeit, um die ein Mausdruckereignis beim Starten einer Flick-Geste in [s] verzögert wird. Wenn die Geste innerhalb dieser Zeit ausgelöst wird, wird kein Mausdruck oder Loslassen an das gescrollte Objekt gesendet. Wird die Geste nach dieser Zeit ausgelöst, wird der verzögerte Mausdruck plus ein vorgetäuschtes Loslass-Ereignis an der globalen Position QPoint(-QWIDGETSIZE_MAX, -QWIDGETSIZE_MAX) gesendet. Wenn die Geste abgebrochen wird, werden sowohl der verzögerte Mausdruck als auch das echte Loslass-Ereignis gesendet. |
QScrollerProperties::DragStartDistance | 1 | Dies ist die minimale Distanz, 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 Scroll-Geschwindigkeit einfließen. Dieser Wert sollte in einem Bereich zwischen 0 und 1 liegen. Je niedriger der Wert, desto stärker wird die Ziehgeschwindigkeit geglättet. |
QScrollerProperties::AxisLockThreshold | 3 | Begrenzt die Bewegung auf eine Achse, wenn die Bewegung innerhalb eines Winkels um die Achse erfolgt. Der Schwellenwert muss im Bereich von 0 bis 1 liegen. |
QScrollerProperties::ScrollingCurve | 4 | Die QEasingCurve, die verwendet wird, wenn die Bildlaufgeschwindigkeit nach einer vom Benutzer initiierten Bewegung verlangsamt wird. Bitte beachten Sie, dass es sich hierbei um die Abschwächungskurve für die Positionen und nicht für die Geschwindigkeit handelt: Die Vorgabe 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 der Scroller braucht, um auf Geschwindigkeit 0 abzubremsen. 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 Loslassen der Maus erforderlich ist, um den Bildlauf 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 Scroll-Geschwindigkeit für einen Click-Through in m/s. Das bedeutet, dass ein Klick auf ein aktuell (langsam) scrollendes Objekt nicht nur das Scrollen stoppt, sondern auch das Click-Ereignis an das UI-Control übermittelt wird. Dies ist nützlich, wenn Sie exponentielle Bildlaufkurven verwenden. |
QScrollerProperties::AcceleratingFlickMaximumTime | 9 | Dies ist die maximale Zeit in seconds, die eine Flick-Geste dauern kann, um als beschleunigendes Flick erkannt zu werden. Ist dieser Wert auf Null gesetzt, 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 Bildlaufgeschwindigkeit mit AcceleratingFlickSpeedupFactor multipliziert, um sie zu beschleunigen. |
QScrollerProperties::AcceleratingFlickSpeedupFactor | 10 | Die aktuelle Geschwindigkeit wird mit dieser Zahl multipliziert, wenn ein beschleunigender Flick erkannt wird. Sollte >= 1 sein. |
QScrollerProperties::SnapPositionRatio | 11 | Dies ist der Abstand, den der Benutzer den Bereich zwischen zwei Fangpunkten ziehen muss, damit er an der nächsten Position einrastet. 0.33 bedeutet, dass der Bildlauf nur ein Drittel des Abstands zwischen zwei Fangpunkten erreichen muss, um an der nächsten Position einzurasten. Das Verhältnis muss zwischen 0 und 1 liegen. |
QScrollerProperties::SnapTime | 12 | Dies ist der Zeitfaktor für die Bildlaufkurve. Ein kleinerer Wert bedeutet, dass der Bildlauf länger dauert. Der Bildlaufabstand ist unabhängig von diesem Wert. |
QScrollerProperties::OvershootDragResistanceFactor | 13 | Dieser Wert ist der Faktor zwischen dem Ziehen der Maus und der tatsächlichen Bewegung des Bildlaufbereichs (während des Überschwingens). Der Faktor muss zwischen 0 und 1 liegen. |
QScrollerProperties::OvershootDragDistanceFactor | 14 | Dies ist der maximale Abstand für Überschwingbewegungen beim Ziehen. Der tatsächliche Überschwingungsabstand wird berechnet, indem dieser Wert mit der Größe des Ansichtsfensters des gescrollten Objekts multipliziert wird. Der Faktor muss zwischen 0 und 1 liegen. |
QScrollerProperties::OvershootScrollDistanceFactor | 15 | Dies ist der maximale Abstand für Überschwingbewegungen beim Scrollen. Der tatsächliche Überschreitungsabstand wird berechnet, indem dieser Wert mit der Größe des Ansichtsfensters des gescrollten Objekts multipliziert wird. Der Faktor muss zwischen 0 und 1 liegen. |
QScrollerProperties::OvershootScrollTime | 16 | Dies ist die Zeit in seconds, die zum Abspielen der kompletten Überschwingungsanimation verwendet wird. |
QScrollerProperties::HorizontalOvershootPolicy | 17 | Dies ist die Richtlinie für das horizontale Ü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 verwendet 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 schnell ist, kann er mit dieser Einstellung gesenkt werden, wobei er immer noch mit QAbstractAnimation synchronisiert ist. Bitte beachten Sie, dass hier nur die Werte des FrameRates enum erlaubt sind. |
QScrollerProperties::ScrollMetricCount | 20 | Dies ist immer der letzte Eintrag. |
Dokumentation der Mitgliedsfunktionen
QScrollerProperties::QScrollerProperties()
Konstruiert neue Scroller-Eigenschaften.
QScrollerProperties::QScrollerProperties(const QScrollerProperties &sp)
Konstruiert eine Kopie von sp.
[virtual noexcept] QScrollerProperties::~QScrollerProperties()
Zerstört die Eigenschaften der Bildlaufleiste.
QVariant QScrollerProperties::scrollMetric(QScrollerProperties::ScrollMetric metric) const
Abfrage des metric Wertes der Scroller-Eigenschaften.
Siehe auch setScrollMetric() und ScrollMetric.
[static] void QScrollerProperties::setDefaultScrollerProperties(const QScrollerProperties &sp)
Setzt die Scroller-Eigenschaften für alle neuen QScrollerProperties Objekte auf sp.
Verwenden Sie diese Funktion, um die vom Standardkonstruktor zurückgegebenen Plattform-Standardeigenschaften außer Kraft zu setzen. Wenn Sie nur die Scroller-Eigenschaften eines einzelnen Scrollers ändern wollen, verwenden Sie QScroller::setScrollerProperties()
Hinweis: Der Aufruf dieser Funktion ändert nicht den Inhalt von bereits existierenden QScrollerProperties Objekten.
Siehe auch unsetDefaultScrollerProperties().
void QScrollerProperties::setScrollMetric(QScrollerProperties::ScrollMetric metric, const QVariant &value)
Setzen Sie einen bestimmten Wert der metric ScrollerMetric auf value.
Siehe auch scrollMetric() und ScrollMetric.
[static] void QScrollerProperties::unsetDefaultScrollerProperties()
Setzt die vom Standardkonstruktor zurückgegebenen Scroller-Eigenschaften 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 sp diesen Scrollereigenschaften zu und gibt einen Verweis auf diese Scrollereigenschaften zurück.
bool QScrollerProperties::operator==(const QScrollerProperties &sp) const
Gibt true zurück, wenn diese Scroller-Eigenschaften gleich sp sind; andernfalls wird false zurückgegeben.
© 2025 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.
