QGraphicsScale Class
Die Klasse „QGraphicsScale“ bietet eine Skalierungstransformation. Mehr...
| Header: | #include <QGraphicsScale> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | QGraphicsTransform |
Eigenschaften
Öffentliche Funktionen
| QGraphicsScale(QObject *parent = nullptr) | |
| virtual | ~QGraphicsScale() |
| QVector3D | origin() const |
| void | setOrigin(const QVector3D &point) |
| void | setXScale(qreal) |
| void | setYScale(qreal) |
| void | setZScale(qreal) |
| qreal | xScale() const |
| qreal | yScale() const |
| qreal | zScale() const |
Neu implementierte öffentliche Funktionen
| virtual void | applyTo(QMatrix4x4 *matrix) const override |
Signale
| void | originChanged() |
| void | scaleChanged() |
| void | xScaleChanged() |
| void | yScaleChanged() |
| void | zScaleChanged() |
Detaillierte Beschreibung
QGraphicsScene stellt bestimmte Parameter bereit, mit denen sich steuern lässt, wie die Skalierung angewendet werden soll.
Der Ursprung ist der Punkt, von dem aus das Element skaliert wird (d. h., er bleibt relativ zum übergeordneten Element fest, während der Rest des Elements vergrößert wird). Standardmäßig ist der Ursprung QPointF(0, 0).
Die Parameter xScale, yScale und zScale beschreiben die Skalierungsfaktoren, die in horizontaler, vertikaler und Tiefenrichtung anzuwenden sind. Sie können beliebige Werte annehmen, einschließlich 0 (um das Element auf einen Punkt zu reduzieren) oder negative Werte. Ein negativer Wert für xScale spiegelt das Element horizontal. Ein negativer Wert für yScale dreht das Element vertikal um. Ein negativer Wert für zScale dreht das Element um seine eigene Achse.
Siehe auch „ QGraphicsTransform“ , „ QGraphicsItem::setScale()“ und „ QTransform::scale()“.
Dokumentation zu den Eigenschaften
origin : QVector3D
Diese Eigenschaft enthält den Ursprung der Skalierung im 3D-Raum.
Alle Skalierungen erfolgen relativ zu diesem Punkt (d. h., dieser Punkt bleibt relativ zum übergeordneten Element fest, wenn das Element skaliert wird).
Zugriffsfunktionen:
| QVector3D | origin() const |
| void | setOrigin(const QVector3D &point) |
Benachrichtigungssignal:
| void | originChanged() |
Siehe auch xScale, yScale und zScale.
xScale : qreal
Diese Eigenschaft enthält den horizontalen Skalierungsfaktor.
Der Skalierungsfaktor kann eine beliebige reelle Zahl sein; der Standardwert ist 1,0. Wenn Sie den Faktor auf 0,0 setzen, wird das Element auf einen einzigen Punkt reduziert. Wenn Sie einen negativen Wert angeben, wird das Element horizontal um seinen Ursprung gespiegelt.
Zugriffsfunktionen:
| qreal | xScale() const |
| void | setXScale(qreal) |
Benachrichtigungssignal:
| void | xScaleChanged() |
Siehe auch „ yScale “, „ zScale “ und „origin“.
yScale : qreal
Diese Eigenschaft enthält den vertikalen Skalierungsfaktor.
Der Skalierungsfaktor kann eine beliebige reelle Zahl sein; der Standardwert ist 1,0. Wenn Sie den Faktor auf 0,0 setzen, wird das Element auf einen einzigen Punkt reduziert. Wenn Sie einen negativen Wert angeben, wird das Element vertikal um seinen Ursprung gespiegelt.
Zugriffsfunktionen:
| qreal | yScale() const |
| void | setYScale(qreal) |
Benachrichtigungssignal:
| void | yScaleChanged() |
Siehe auch „ xScale“ , „ zScale “ und „origin“.
zScale : qreal
Diese Eigenschaft enthält den Skalierungsfaktor für die Tiefe.
Der Skalierungsfaktor kann eine beliebige reelle Zahl sein; der Standardwert ist 1,0. Wenn Sie den Faktor auf 0,0 setzen, wird das Element auf einen einzigen Punkt reduziert. Wenn Sie einen negativen Wert angeben, wird das Element um seinen Ursprung gespiegelt.
Zugriffsfunktionen:
| qreal | zScale() const |
| void | setZScale(qreal) |
Benachrichtigungssignal:
| void | zScaleChanged() |
Dokumentation der Mitgliedsfunktionen
QGraphicsScale::QGraphicsScale(QObject *parent = nullptr)
Erstellt ein leeres QGraphicsScale-Objekt mit dem angegebenen „ parent “.
[virtual noexcept] QGraphicsScale::~QGraphicsScale()
Zerstört die Grafikskala.
[override virtual] void QGraphicsScale::applyTo(QMatrix4x4 *matrix) const
Implementiert: ` QGraphicsTransform::applyTo(QMatrix4x4 *matrix) const`.
[signal] void QGraphicsScale::originChanged()
QGraphicsScale gibt dieses Signal aus, wenn sich sein Ursprung ändert.
Hinweis: Notifier -Signal für die Eigenschaft „origin“.
Siehe auch „ QGraphicsScale::origin “.
[signal] void QGraphicsScale::scaleChanged()
Dieses Signal wird immer dann ausgelöst, wenn sich die Eigenschaften „ xScale “, „ yScale “ oder „ zScale “ des Objekts ändern.
Siehe auch „ QGraphicsScale::xScale “, „ QGraphicsScale::yScale “ und „ QGraphicsScale::zScale “.
[signal] void QGraphicsScale::xScaleChanged()
Dieses Signal wird immer dann ausgelöst, wenn sich die Eigenschaft „ xScale “ ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ xScale “.
[signal] void QGraphicsScale::yScaleChanged()
Dieses Signal wird immer dann ausgelöst, wenn sich die Eigenschaft „ yScale “ ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ yScale “.
[signal] void QGraphicsScale::zScaleChanged()
Dieses Signal wird immer dann ausgelöst, wenn sich die Eigenschaft „ zScale “ ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ zScale “.
© 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.
