QGraphicsObject Class
QGraphicsObject クラスは、シグナル、スロット、およびプロパティを必要とするすべてのグラフィックアイテムの基底クラスを提供します。詳細...
| ヘッダー: | #include <QGraphicsObject> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 継承元: | QObject およびQGraphicsItem |
| 継承元: |
プロパティ
パブリック関数
| QGraphicsObject(QGraphicsItem *parent = nullptr) | |
| virtual | ~QGraphicsObject() |
| void | grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags()) |
| void | ungrabGesture(Qt::GestureType gesture) |
シグナル
| void | enabledChanged() |
| void | opacityChanged() |
| void | parentChanged() |
| void | rotationChanged() |
| void | scaleChanged() |
| void | visibleChanged() |
| void | xChanged() |
| void | yChanged() |
| void | zChanged() |
再実装された保護関数
| virtual bool | event(QEvent *ev) override |
保護スロット
| void | updateMicroFocus() |
詳細な説明
このクラスは、QGraphicsItem を拡張し、QObject のシグナル／スロットおよびプロパティの仕組みを備えています。QGraphicsItem の基本的なセッターやゲッターの多くをプロパティにマッピングし、その多くに通知シグナルを追加しています。
親と子
各グラフィックオブジェクトは、親アイテムを指定して構築することができます。これにより、親アイテムが破棄されたときに、その子アイテムも確実に破棄されるようになります。QGraphicsObjectはQObject とQGraphicsItem の両方から継承していますが、親アイテムと子アイテムの関係を管理するには、QObjectではなく、QGraphicsItem が提供する関数を使用する必要があります。
アイテム間の関係は、parentItem() およびchildItems() 関数を使用して調べることができます。シーン内のアイテムの階層において、parentObject() およびparentWidget() 関数は、QWidget のサブクラスにおけるQWidget::parent() およびQWidget::parentWidget() 関数に相当します。
QGraphicsWidgetも参照してください 。
プロパティのドキュメント
effect : QGraphicsEffect*
このプロパティには、このアイテムに紐付けられたエフェクトが格納されます
QGraphicsItem::setGraphicsEffect() およびQGraphicsItem::graphicsEffect()も参照してください 。
enabled : bool
このプロパティは、その項目が有効か無効かに関係なく保持されます
このプロパティは、QGraphicsItem で宣言されています。
デフォルトでは、このプロパティの値はtrue です。
通知シグナル：
| void | enabledChanged() |
QGraphicsItem::isEnabled() およびQGraphicsItem::setEnabled()も参照してください 。
opacity : qreal
このプロパティは、アイテムの不透明度を保持します
通知シグナル：
| void | opacityChanged() |
QGraphicsItem::setOpacity() およびQGraphicsItem::opacity()も参照してください 。
parent : QGraphicsObject*
このプロパティには、アイテムの親が格納されます
注： 項目の親は 、QObject::parent() によって返される親オブジェクトとは独立して設定されます。
通知シグナル：
| void | parentChanged() |
関連項目： QGraphicsItem::setParentItem() およびQGraphicsItem::parentObject()。
pos : QPointF
このプロパティは、アイテムの位置を保持します
アイテムの位置を表します。
QGraphicsItem::setPos() およびQGraphicsItem::pos()も参照してください 。
rotation : qreal
このプロパティには、アイテムの回転角度（度単位）が格納されます。
これは、アイテムをその transformOrigin を中心として何度回転させるかを指定します。デフォルトの回転角度は 0 度（つまり、回転しない）です。
通知シグナル：
| void | rotationChanged() |
scale : qreal
このプロパティは、アイテムの拡大率を指定します。
スケールが 1 未満の場合、アイテムは通常より小さく表示され、スケールが 1 より大きい場合は、通常より大きく表示されます。スケールが負の値の場合、アイテムは反転表示されます。
デフォルトでは、アイテムはスケール 1（つまり通常のサイズ）で表示されます。
スケーリングは、アイテムの transformOrigin を基準に行われます。
通知シグナル：
| void | scaleChanged() |
transformOriginPoint : QPointF
このプロパティは、変形の原点を保持します
このプロパティは、項目の座標系内の特定の点を、拡大縮小および回転の原点として設定します。
関連項目：scale 、rotation 、およびQGraphicsItem::transformOriginPoint()も参照してください 。
visible : bool
このプロパティは、その項目が表示されているかどうかにかかわらず保持されます
このプロパティはQGraphicsItem で宣言されています。
デフォルトでは、このプロパティはtrue です。
通知シグナル：
| void | visibleChanged() |
関連項目: QGraphicsItem::isVisible() およびQGraphicsItem::setVisible()。
x : qreal
このプロパティは、アイテムの x 座標を保持します
アイテムの x 座標を表します。
通知シグナル：
| void | xChanged() |
QGraphicsItem::setX() およびsetPos()も参照してください 。
y : qreal
このプロパティは、アイテムの y 座標を保持します
アイテムの y 座標を表します。
通知シグナル：
| void | yChanged() |
QGraphicsItem::setY() およびsetPos()も参照してください 。
z : qreal
このプロパティは、アイテムのz値を保持します
アイテムの z 値を記述します。
通知シグナル：
| void | zChanged() |
QGraphicsItem::setZValue() およびzValue()も参照してください 。
メンバ関数のドキュメント
[explicit] QGraphicsObject::QGraphicsObject(QGraphicsItem *parent = nullptr)
parent を使用して QGraphicsObject を生成します。
[virtual noexcept] QGraphicsObject::~QGraphicsObject()
デストラクタ。
[signal] void QGraphicsObject::enabledChanged()
このシグナルは、アイテムが有効または無効になったときに発火します。
注： プロパティ `enabled` に対する通知 シグナルです。
isEnabled()も参照してください 。
[override virtual protected] bool QGraphicsObject::event(QEvent *ev)
QObject::event(QEvent *e) を再実装します。
void QGraphicsObject::grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags())
指定されたgesture に、特定のflags を持つグラフィックオブジェクトを登録します。
ungrabGesture() およびQGestureEventも参照してください 。
[signal] void QGraphicsObject::opacityChanged()
この信号は、アイテムの不透明度が変化するたびに発火します
注： プロパティ `opacity`の通知 シグナルです。
QGraphicsItem::opacity()も参照してください 。
[signal] void QGraphicsObject::parentChanged()
このシグナルは、アイテムの親が変更されるたびに発生します
注： プロパティ `parent` に対する通知 シグナルです。
[signal] void QGraphicsObject::rotationChanged()
このシグナルは、アイテムの回転が変化するたびに発火します。
注： プロパティ `rotation`の通知 シグナルです。
[signal] void QGraphicsObject::scaleChanged()
このシグナルは、項目のスケールが変更されたときに発行されます。
注： プロパティ `scale` に対する通知 シグナルです。
void QGraphicsObject::ungrabGesture(Qt::GestureType gesture)
指定されたgesture からグラフィックオブジェクトの登録を解除します。
grabGesture() およびQGestureEventも参照してください 。
[protected slot] void QGraphicsObject::updateMicroFocus()
アイテムのマイクロフォーカスを更新します。これは便宜上のスロットです。
QInputMethodも参照してください 。
[signal] void QGraphicsObject::visibleChanged()
このシグナルは、アイテムの可視状態が変更されるたびに発火します
注： プロパティ `visible` に対する通知 シグナルです。
「visible」も参照してください 。
[signal] void QGraphicsObject::xChanged()
このシグナルは、アイテムのx座標が変化するたびに発火します
注： プロパティ `x` に対する通知 シグナルです。
pos()も参照してください 。
[signal] void QGraphicsObject::yChanged()
このシグナルは、アイテムのY座標が変化するたびに発火します。
注： プロパティ `y` に対する通知 シグナルです。
pos()も参照してください 。
[signal] void QGraphicsObject::zChanged()
このシグナルは、アイテムの z 値が変更されるたびに発火します。
注： プロパティ `z`の通知 シグナルです。
pos()も参照してください 。
© 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.
