QPinchGesture Class
Die Klasse QPinchGesture beschreibt eine vom Benutzer ausgeführte Pinch-Geste. Mehr...
| Kopfzeile: | #include <QPinchGesture> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Vererbungen: | QGesture |
Öffentliche Typen
| enum | ChangeFlag { ScaleFactorChanged, RotationAngleChanged, CenterPointChanged } |
| flags | ChangeFlags |
Eigenschaften
|
|
Öffentliche Funktionen
| virtual | ~QPinchGesture() |
| QPointF | centerPoint() const |
| QPinchGesture::ChangeFlags | changeFlags() const |
| QPointF | lastCenterPoint() const |
| qreal | lastRotationAngle() const |
| qreal | lastScaleFactor() const |
| qreal | rotationAngle() const |
| qreal | scaleFactor() const |
| void | setCenterPoint(const QPointF &value) |
| void | setChangeFlags(QPinchGesture::ChangeFlags value) |
| void | setLastCenterPoint(const QPointF &value) |
| void | setLastRotationAngle(qreal value) |
| void | setLastScaleFactor(qreal value) |
| void | setRotationAngle(qreal value) |
| void | setScaleFactor(qreal value) |
| void | setStartCenterPoint(const QPointF &value) |
| void | setTotalChangeFlags(QPinchGesture::ChangeFlags value) |
| void | setTotalRotationAngle(qreal value) |
| void | setTotalScaleFactor(qreal value) |
| QPointF | startCenterPoint() const |
| QPinchGesture::ChangeFlags | totalChangeFlags() const |
| qreal | totalRotationAngle() const |
| qreal | totalScaleFactor() const |
Detaillierte Beschreibung
Eine Pinch-Geste ist eine Form der Touch-Benutzereingabe, bei der der Benutzer typischerweise zwei Punkte auf dem Eingabegerät mit einem Daumen und einem Finger berührt, bevor er sie näher zusammen oder weiter auseinander bewegt, um den Skalierungsfaktor, den Zoom oder die Detailstufe der Benutzeroberfläche zu ändern.
Einen Überblick über die Handhabung von Gesten in Qt und Informationen über die Verwendung von Gesten in Ihren Anwendungen finden Sie im Dokument Gesten in Widgets und Grafikansicht.
Anstatt die gleiche Geste wiederholt zu drücken, kann der Benutzer das Eingabegerät an einer Stelle berühren und eine zweite Berührung an einem neuen Punkt vornehmen, um die Geste fortzusetzen. In diesem Fall werden die Gestenereignisse weiterhin an das Zielobjekt geliefert, das eine Instanz von QPinchGesture im Zustand Qt::GestureUpdated enthält.
Siehe auch QPanGesture und QSwipeGesture.
Dokumentation der Mitgliedstypen
enum QPinchGesture::ChangeFlag
flags QPinchGesture::ChangeFlags
Diese Aufzählung beschreibt die Änderungen, die an den Eigenschaften des Gestenobjekts vorgenommen werden können.
| Konstante | Wert | Beschreibung |
|---|---|---|
QPinchGesture::ScaleFactorChanged | 0x1 | Der von scaleFactor festgelegte Skalierungsfaktor wurde geändert. |
QPinchGesture::RotationAngleChanged | 0x2 | Der von rotationAngle festgelegte Drehwinkel wurde geändert. |
QPinchGesture::CenterPointChanged | 0x4 | Der von centerPoint gehaltene Mittelpunkt hat sich geändert. |
Der Typ ChangeFlags ist ein Typedef für QFlags<ChangeFlag>. Er speichert eine ODER-Kombination von ChangeFlag-Werten.
Siehe auch changeFlags und totalChangeFlags.
Dokumentation der Eigenschaft
centerPoint : QPointF
Diese Eigenschaft enthält den aktuellen Mittelpunkt
Der Mittelpunkt ist der mittlere Punkt zwischen den beiden Eingabepunkten in der Geste.
Zugriffsfunktionen:
| QPointF | centerPoint() const |
| void | setCenterPoint(const QPointF &value) |
Siehe auch startCenterPoint und lastCenterPoint.
changeFlags : ChangeFlags
Diese Eigenschaft enthält die Eigenschaft der Geste, die sich im aktuellen Schritt geändert hat
Diese Eigenschaft zeigt an, welche der anderen Eigenschaften sich geändert hat, seit das vorherige Gestenereignis Informationen über diese Geste enthielt. Anhand dieser Informationen können Sie feststellen, welcher Aspekt Ihrer Benutzeroberfläche aktualisiert werden muss.
Zugriffsfunktionen:
| QPinchGesture::ChangeFlags | changeFlags() const |
| void | setChangeFlags(QPinchGesture::ChangeFlags value) |
Siehe auch totalChangeFlags, scaleFactor, rotationAngle, und centerPoint.
lastCenterPoint : QPointF
Diese Eigenschaft enthält die letzte Position des Mittelpunkts, die für diese Geste aufgezeichnet wurde.
Zugriffsfunktionen:
| QPointF | lastCenterPoint() const |
| void | setLastCenterPoint(const QPointF &value) |
Siehe auch centerPoint und startCenterPoint.
lastRotationAngle : qreal
Diese Eigenschaft enthält den zuletzt gemeldeten Winkel, der von der Gestenbewegung abgedeckt wurde
Der letzte Drehwinkel ist der Winkel, der in der Eigenschaft rotationAngle gemeldet wurde, als ein vorheriges Gestenereignis für diese Geste geliefert wurde.
Zugriffsfunktionen:
| qreal | lastRotationAngle() const |
| void | setLastRotationAngle(qreal value) |
Siehe auch rotationAngle und totalRotationAngle.
lastScaleFactor : qreal
Diese Eigenschaft enthält den zuletzt für diese Geste aufgezeichneten Skalierungsfaktor
Der letzte Skalierungsfaktor enthält den Skalierungsfaktor, der in der Eigenschaft scaleFactor gemeldet wurde, wenn ein vorheriges Gestenereignis Informationen über diese Geste enthielt.
Wenn kein vorheriges Ereignis mit Informationen über diese Geste geliefert wurde (d. h. dieses Gestenobjekt enthält Informationen über die erste Bewegung in der Geste), dann enthält diese Eigenschaft Null.
Zugriffsfunktionen:
| qreal | lastScaleFactor() const |
| void | setLastScaleFactor(qreal value) |
Siehe auch scaleFactor und totalScaleFactor.
rotationAngle : qreal
Diese Eigenschaft gibt den Winkel an, der von der Gestenbewegung abgedeckt wird.
Zugriffsfunktionen:
| qreal | rotationAngle() const |
| void | setRotationAngle(qreal value) |
Siehe auch totalRotationAngle und lastRotationAngle.
scaleFactor : qreal
Diese Eigenschaft enthält den aktuellen Skalierungsfaktor
Der Skalierungsfaktor misst den Skalierungsfaktor, der mit dem Abstand zwischen zwei Eingaben des Benutzers auf einem Touch-Gerät verbunden ist.
Zugriffsfunktionen:
| qreal | scaleFactor() const |
| void | setScaleFactor(qreal value) |
Siehe auch totalScaleFactor und lastScaleFactor.
startCenterPoint : QPointF
Diese Eigenschaft enthält die Startposition des Mittelpunkts
Zugriffsfunktionen:
| QPointF | startCenterPoint() const |
| void | setStartCenterPoint(const QPointF &value) |
Siehe auch centerPoint und lastCenterPoint.
totalChangeFlags : ChangeFlags
Diese Eigenschaft enthält die Eigenschaft der Geste, die sich geändert hat
Diese Eigenschaft zeigt an, welche der anderen Eigenschaften sich seit Beginn der Geste geändert hat. Anhand dieser Informationen können Sie feststellen, welcher Aspekt Ihrer Benutzeroberfläche aktualisiert werden muss.
Zugriffsfunktionen:
| QPinchGesture::ChangeFlags | totalChangeFlags() const |
| void | setTotalChangeFlags(QPinchGesture::ChangeFlags value) |
Siehe auch changeFlags, scaleFactor, rotationAngle, und centerPoint.
totalRotationAngle : qreal
Diese Eigenschaft enthält den Gesamtwinkel, der von der Geste abgedeckt wird
Dieser Gesamtwinkel misst den gesamten von der Geste abgedeckten Winkel. In der Regel entspricht dies dem Wert der Eigenschaft rotationAngle, es sei denn, der Benutzer führt mehrere Drehungen aus, indem er einen der Berührungspunkte entfernt und neu positioniert, wie oben beschrieben. In diesem Fall ist der Gesamtwinkel die Summe der Drehwinkel für die verschiedenen Phasen der Geste.
Zugriffsfunktionen:
| qreal | totalRotationAngle() const |
| void | setTotalRotationAngle(qreal value) |
Siehe auch rotationAngle und lastRotationAngle.
totalScaleFactor : qreal
Diese Eigenschaft enthält den Gesamtskalierungsfaktor
Der Gesamtskalierungsfaktor misst die gesamte Änderung des Skalierungsfaktors vom ursprünglichen Wert zum aktuellen Skalierungsfaktor.
Zugriffsfunktionen:
| qreal | totalScaleFactor() const |
| void | setTotalScaleFactor(qreal value) |
Siehe auch scaleFactor und lastScaleFactor.
© 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.
