QScroller Class

Dokumentation der Member-Funktionen

[static] QList<QScroller *> QScroller::activeScrollers()

Gibt eine anwendungsweite Liste der derzeit aktiven „ QScroller “-Objekte zurück. Aktive „ QScroller “-Objekte befinden sich in einem „ state()“, das nicht „ QScroller::Inactive “ ist. Diese Funktion ist nützlich, wenn Sie einen eigenen Gestenerkäufer erstellen.

[slot] void QScroller::ensureVisible(const QRectF &rect, qreal xmargin, qreal ymargin)

Es wird so gescrollt, dass das Rechteck rect innerhalb des Ansichtsbereichs sichtbar ist, wobei um das Rechteck herum zusätzliche Ränder in Pixeln gemäß xmargin und ymargin festgelegt werden.

In Fällen, in denen das Rechteck zusammen mit den Rändern nicht vollständig in den Ansichtsbereich passt, wird der Inhalt so gescrollt, dass so viel wie möglich von rect sichtbar ist.

Die Bildlaufgeschwindigkeit wird so berechnet, dass die angegebene Position nach einer plattformabhängigen Zeitspanne erreicht wird.

Diese Funktion führt das eigentliche Scrollen durch, indem sie scrollTo() aufruft.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        scroller, qOverload(&QScroller::ensureVisible));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        scroller, [receiver = scroller](const QRectF &rect, qreal xmargin, qreal ymargin) { receiver->ensureVisible(rect, xmargin, ymargin); });

Siehe auch ` scrollTo()`.

[slot] void QScroller::ensureVisible(const QRectF &rect, qreal xmargin, qreal ymargin, int scrollTime)

Diese Version wird ihre Zielposition in scrollTime Millisekunden erreichen.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        scroller, qOverload(&QScroller::ensureVisible));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        scroller, [receiver = scroller](const QRectF &rect, qreal xmargin, qreal ymargin, int scrollTime) { receiver->ensureVisible(rect, xmargin, ymargin, scrollTime); });

QPointF QScroller::finalPosition() const

Gibt die geschätzte Endposition für die aktuelle Bildlaufbewegung zurück. Gibt die aktuelle Position zurück, wenn der Status des Bildlaufelements nicht „Scrolling“ ist. Das Ergebnis ist undefiniert, wenn der Status des Bildlaufelements „Inactive“ ist.

Die Zielposition wird in Pixeln angegeben.

Siehe auch „ pixelPerMeter()“ und „ scrollTo()“.

[static] Qt::GestureType QScroller::grabGesture(QObject *target, QScroller::ScrollerGestureType scrollGestureType = TouchGesture)

Registriert einen benutzerdefinierten Erkenner für Scroll-Gesten, bindet ihn an die „ target “ und gibt den resultierenden Gestentyp zurück. Wenn „ scrollGestureType “ auf „ TouchGesture “ gesetzt ist, wird die Geste bei Berührungsereignissen ausgelöst. Ist sie auf einen der Werte „ LeftMouseButtonGesture “, „ RightMouseButtonGesture “ oder „ MiddleMouseButtonGesture “ gesetzt, wird sie bei Mausereignissen der entsprechenden Schaltfläche ausgelöst.

Auf einem einzelnen Objekt kann jeweils nur eine Scroll-Geste aktiv sein. Wenn Sie diese Funktion zweimal für dasselbe Objekt aufrufen, wird die bestehende Geste aufgehoben, bevor die neue Geste aktiviert wird.

Siehe auch ungrabGesture() und grabbedGesture().

[static] Qt::GestureType QScroller::grabbedGesture(QObject *target)

Gibt den derzeit für die „ target “ erfassten Gestentyp zurück oder 0, wenn keine Geste erfasst wurde.

Siehe auch „ grabGesture()“ und „ ungrabGesture()“.

bool QScroller::handleInput(QScroller::Input input, const QPointF &position, qint64 timestamp = 0)

Diese Funktion wird von Gestenerkennungsprogrammen verwendet, um den Scroller über ein neues Eingabeereignis zu informieren. Der Scroller passt seine interne „ state()“-Funktion entsprechend dem Eingabeereignis und den damit verbundenen Scroller-Eigenschaften an. Der Scroller unterscheidet nicht zwischen den verschiedenen Arten von Eingabegeräten, von denen das Ereignis stammt. Daher muss das Ereignis in den Typ „ input “, einen „ position “ und einen „ timestamp “ in Millisekunden aufgeteilt werden. Die „ position “ muss im Koordinatensystem des Ziels angegeben werden.

Der Rückgabewert ist „ true “, wenn das Ereignis vom aufrufenden Filter verarbeitet werden soll, oder „ false “, wenn das Ereignis an das Steuerelement weitergeleitet werden soll.

[static] bool QScroller::hasScroller(QObject *target)

Gibt „ true “ zurück, wenn bereits ein „ QScroller “-Objekt für „ target “ erstellt wurde; andernfalls „ false “.

Siehe auch scroller().

QPointF QScroller::pixelPerMeter() const

Gibt die Metrik „Pixel pro Meter“ für das gescrollte Widget zurück.

Der Wert wird für die x- und die y-Achse separat mithilfe von ` QPointF` zurückgegeben.

[slot] void QScroller::resendPrepareEvent()

Diese Funktion sendet das „ QScrollPrepareEvent “ erneut. Der Aufruf von „resendPrepareEvent“ löst ein „ QScrollPrepareEvent “ vom Scroller aus. Dadurch kann der Empfänger die Position und Größe des Inhalts während des Scrollens neu festlegen. Der Aufruf dieser Funktion im inaktiven Zustand ist sinnlos, da das „Prepare Event“ vor Beginn des Scrollens erneut gesendet wird.

[slot] void QScroller::scrollTo(const QPointF &pos)

Löst das Scrollen des Widgets aus, sodass der Punkt pos an der Position oben links im Ansichtsbereich liegt.

Das Verhalten beim Scrollen außerhalb des gültigen Scrollbereichs ist undefiniert. In diesem Fall kann der Scroller die Position überschreiten oder auch nicht.

Die Scrollgeschwindigkeit wird so berechnet, dass die angegebene Position nach einer plattformdefinierten Zeitspanne erreicht wird.

pos wird in Ansichtsbereichskoordinaten angegeben.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        scroller, qOverload(&QScroller::scrollTo));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        scroller, [receiver = scroller](const QPointF &pos) { receiver->scrollTo(pos); });

Siehe auch ` ensureVisible()`.

[slot] void QScroller::scrollTo(const QPointF &pos, int scrollTime)

Diese Version wird ihre Zielposition in scrollTime Millisekunden erreichen.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        scroller, qOverload(&QScroller::scrollTo));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        scroller, [receiver = scroller](const QPointF &pos, int scrollTime) { receiver->scrollTo(pos, scrollTime); });

[static] QScroller *QScroller::scroller(QObject *target)

Gibt den Scroller für das angegebene „ target “ zurück. Solange das Objekt existiert, gibt diese Funktion immer dieselbe „ QScroller “-Instanz zurück. Falls für „ target “ kein „ QScroller “ existiert, wird implizit eines erstellt. Zu keinem Zeitpunkt ist mehr als ein „ QScroller “ für ein Objekt aktiv.

Siehe auch „ hasScroller()“ und „ target()“.

[static] const QScroller *QScroller::scroller(const QObject *target)

Dies ist die „const“-Version von scroller().

[signal] void QScroller::scrollerPropertiesChanged(const QScrollerProperties &newProperties)

QScroller gibt dieses Signal aus, sobald sich die Eigenschaften des Scrollers ändern. „ newProperties “ sind die neuen Eigenschaften des Scrollers.

Siehe auch „ scrollerProperties “.

void QScroller::setSnapPositionsX(const QList<qreal> &positions)

Legen Sie die Einrastpositionen für die horizontale Achse als Liste fest: positions. Dadurch werden alle zuvor festgelegten Einrastpositionen sowie ein zuvor festgelegtes Einrastintervall überschrieben. Das Einrasten kann deaktiviert werden, indem eine leere Liste von Positionen festgelegt wird.

void QScroller::setSnapPositionsX(qreal first, qreal interval)

Legen Sie die Einrastpositionen für die horizontale Achse in regelmäßigen Abständen fest. Die erste Einrastposition liegt bei first. Die nächste bei first + interval. Dies kann zur Umsetzung einer Listenüberschrift verwendet werden. Dadurch werden alle zuvor festgelegten Einrastpositionen sowie ein zuvor festgelegtes Einrastintervall überschrieben. Das Einrasten kann durch Festlegen eines Intervalls von 0,0 deaktiviert werden.

void QScroller::setSnapPositionsY(const QList<qreal> &positions)

Legen Sie die Einrastpositionen für die vertikale Achse als Liste fest: positions. Dadurch werden alle zuvor festgelegten Einrastpositionen sowie ein zuvor festgelegtes Einrastintervall überschrieben. Das Einrasten kann deaktiviert werden, indem eine leere Liste von Positionen festgelegt wird.

void QScroller::setSnapPositionsY(qreal first, qreal interval)

Stellen Sie die Einrastpositionen für die vertikale Achse auf gleichmäßige Abstände ein. Die erste Einrastposition liegt bei first. Die nächste bei first + interval. Dadurch werden alle zuvor festgelegten Einrastpositionen sowie ein zuvor festgelegtes Einrastintervall überschrieben. Das Einrasten kann deaktiviert werden, indem ein Intervall von 0,0 festgelegt wird.

[signal] void QScroller::stateChanged(QScroller::State newState)

QScroller gibt dieses Signal aus, sobald sich der Zustand ändert. „ newState “ ist der neue Zustand.

Siehe auch „ state “.

void QScroller::stop()

Hält den Scroller an und setzt seinen Status wieder auf „Inaktiv“ zurück.

QObject *QScroller::target() const

Gibt das Zielobjekt dieses Scrollers zurück.

Siehe auch „ hasScroller()“ und „ scroller()“.

[static] void QScroller::ungrabGesture(QObject *target)

Gibt die Geste für den target frei. Führt keine Aktion aus, wenn keine Geste erfasst wurde.

Siehe auch ` grabGesture()` und ` grabbedGesture()`.

QPointF QScroller::velocity() const

Gibt die aktuelle Bildlaufgeschwindigkeit in Metern pro Sekunde zurück, wenn der Status „Scrolling“ oder „Dragging“ ist. Andernfalls wird eine Geschwindigkeit von Null zurückgegeben.

Die Geschwindigkeit wird für die x- und die y-Achse separat mithilfe von ` QPointF` gemeldet.

Siehe auch ` pixelPerMeter()`.