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
このプロパティは、3D空間におけるスケーリングの原点を保持します。
すべての拡大縮小は、この点を基準に行われます（つまり、アイテムが拡大縮小される際、この点は親要素に対して固定されたままになります）。
アクセス関数：
| 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`、`zScale`、および`origin`。
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に関する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.
