QGraphicsScale Class
QGraphicsScale 类提供了一种缩放变换。更多内容...
| 头文件： | #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 、yScale 以及zScale 。
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 当其来源发生变化时，会发出此信号。
注意： 用于属性来源的Notifier 信号。
另请参阅 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`的通知器 信号。
© 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.
