QGraphicsScale Class
QGraphicsScale 类提供了一种缩放变换。更多
| Header： | #include <QGraphicsScale> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake： | QT += widgets |
| 继承： | QGraphicsTransform |
属性
公共函数
| 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 |
重新实现的公共函数
| virtual void | applyTo(QMatrix4x4 *matrix) const override |
信号
| void | originChanged() |
| void | scaleChanged() |
| void | xScaleChanged() |
| void | yScaleChanged() |
| void | zScaleChanged() |
详细说明
QGraphicsScene 提供了一些参数来帮助控制缩放的应用方式。
原点是项目缩放的起始点（即在项目其他部分增长时，原点相对于父项目保持固定）。默认情况下，原点是QPointF(0, 0)。
参数xScale 、yScale 和zScale 描述了应用于水平、垂直和深度方向的缩放因子。它们可以是任何值，包括 0（将项目折叠为一个点）或负值。xScale 的负值将水平镜像项目。yScale 的负值将垂直翻转项目。zScale 的负值将使项目从头到尾翻转。
另请参阅 QGraphicsTransform,QGraphicsItem::setScale() 和QTransform::scale()。
属性文档
origin : QVector3D
此属性表示三维空间中缩放的原点。
所有缩放都将相对于此点进行（也就是说，当项目缩放时，相对于父项目，此点将保持固定）。
访问功能：
| QVector3D | origin() const |
| void | setOrigin(const QVector3D &point) |
通知信号：
| void | originChanged() |
xScale : qreal
该属性用于保存水平缩放因子。
缩放因子可以是任何实数；默认值为 1.0。如果将系数设置为 0.0，项目将折叠为一个点。如果提供一个负值，项目将围绕其原点水平镜像。
访问功能：
| qreal | xScale() const |
| void | setXScale(qreal) |
通知信号：
| void | xScaleChanged() |
yScale : qreal
该属性用于保存垂直比例因子。
缩放因子可以是任何实数；默认值为 1.0。如果将系数设为 0.0，项目将折叠为一个点。如果提供一个负值，项目将围绕其原点垂直翻转。
访问功能：
| qreal | yScale() const |
| void | setYScale(qreal) |
通知信号：
| void | yScaleChanged() |
zScale : qreal
该属性用于保存深度比例因子。
缩放因子可以是任何实数；默认值为 1.0。如果将系数设置为 0.0，项目将折叠为单点。如果提供的是负值，项目将围绕原点逐端翻转。
访问功能：
| qreal | zScale() const |
| void | setZScale(qreal) |
通知信号：
| void | zScaleChanged() |
成员函数文档
QGraphicsScale::QGraphicsScale(QObject *parent = nullptr)
用给定的parent 构建一个空的 QGraphicsScale 对象。
[virtual noexcept] QGraphicsScale::~QGraphicsScale()
破坏图形比例。
[override virtual] void QGraphicsScale::applyTo(QMatrix4x4 *matrix) const
重实现：QGraphicsTransform::applyTo(QMatrix4x4 *matrix) const.
[signal] void QGraphicsScale::originChanged()
QGraphicsScale 属性的起源发生变化时会发出该信号。
注： 属性origin 的通知信号。
另请参阅 QGraphicsScale::origin 。
[signal] void QGraphicsScale::scaleChanged()
每当对象的xScale 、yScale 或zScale 发生变化时，就会发出该信号。
另请参见 QGraphicsScale::xScale,QGraphicsScale::yScale, 和QGraphicsScale::zScale 。
[signal] void QGraphicsScale::xScaleChanged()
只要xScale 属性发生变化，就会发出该信号。
注： 属性xScale 的通知信号。
[signal] void QGraphicsScale::yScaleChanged()
只要yScale 属性发生变化，就会发出该信号。
注： 属性yScale 的通知信号。
[signal] void QGraphicsScale::zScaleChanged()
只要zScale 属性发生变化，就会发出该信号。
注： 属性zScale 的通知信号。
© 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.
