QGraphicsObject 类

QGraphicsObject 类提供用于需要信号、槽和属性的图形项的基本类。更多信息...

头文件	#include <QGraphicsObject>
CMake	find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake	QT += widgets
继承自	QObject 和 QGraphicsItem
被以下类继承	QGraphicsSvgItem、QGraphicsTextItem 和 QGraphicsWidget

所有成员的列表，包括继承的成员

属性

effect : QGraphicsEffect* const
enabled : const bool
opacity : const qreal
parent : QGraphicsObject* const
pos : const QPointF
rotation : const qreal

scale : const qreal
transformOriginPoint : const QPointF
visible : const bool
x : const qreal
y : const qreal
z : const qreal

公开函数

	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继承，但您应使用QGraphicsItem提供的函数来管理父项和子项之间的关系，而不是QObject。

可以使用parentItem()和childItems()函数来探索项目之间的关系。在场景中项目的层次结构中，parentObject()和parentWidget()函数相当于QWidget子类的QWidget::parent()和QWidget::parentWidget()函数。

另请参阅QGraphicsWidget。

属性文档

effect : QGraphicsEffect* const

此属性保存附加到此项的效果

另请参阅QGraphicsItem::setGraphicsEffect()和QGraphicsItem::graphicsEffect。

enabled : const bool

此属性保存项是否启用

此属性在QGraphicsItem中声明。

默认情况下，此属性为true。

通知信号

void	enabledChanged()

另请参阅QGraphicsItem::isEnabled()和QGraphicsItem::setEnabled。

opacity : const qreal

此属性保存项的不透明度

通知信号

void	opacityChanged()

另请参阅QGraphicsItem::setOpacity()和QGraphicsItem::opacity。

parent : QGraphicsObject* const

此属性保存项的父项

注意：项的父项设置与由QObject::parent返回的父对象设置独立。

通知信号

void	parentChanged()

另请参阅QGraphicsItem::setParentItem()和QGraphicsItem::parentObject。

pos : const QPointF

此属性保存项的位置

描述了项的位置。

另请参阅QGraphicsItem::setPos()和QGraphicsItem::pos。

rotation : const qreal

此属性保存项的角度旋转

此指定对象围绕其transformOrigin旋转多少度。默认旋转是0度（即不旋转）。

通知信号

void	rotationChanged()

scale : const qreal

此属性保存项的缩放比例

小于1的缩放意味着项的显示将小于正常尺寸，大于1的缩放意味着项的显示将大于正常尺寸。负缩放将导致项镜像。

默认情况下，项以1的缩放显示（即正常尺寸）。

缩放从项的transformOrigin开始。

通知信号

void	scaleChanged()

transformOriginPoint : const QPointF

此属性存储变换原点

此属性将项目坐标系中的特定点设置为缩放和旋转的原点。

另请参阅scale、rotation以及QGraphicsItem::transformOriginPoint。

visible : const bool

此属性存储项目是否可见

此属性在QGraphicsItem中声明。

默认情况下，此属性为true。

通知信号

void	visibleChanged()

另请参阅QGraphicsItem::isVisible()和QGraphicsItem::setVisible()。

x : const qreal

此属性存储项目的x位置

描述项目的x位置。

通知信号

void	xChanged()

另请参阅QGraphicsItem::setX和setPos。

y : const qreal

此属性存储项目的y位置

描述项目的y位置。

通知信号

void	yChanged()

另请参阅QGraphicsItem::setY和setPos。

z : const qreal

此属性存储项目的z值

描述项目的z值。

通知信号

void	zChanged()

另请参阅QGraphicsItem::setZValue和zValue。

成员函数文档

`[显式]` QGraphicsObject::QGraphicsObject(QGraphicsItem **parent* = nullptr)

使用父项构造QGraphicsObject。

`[虚拟 noexcept]` QGraphicsObject::~QGraphicsObject()

析构函数。

`[信号]` void QGraphicsObject::enabledChanged()

每当项目被启用或禁用时，都会发射此信号。

注意：属性enabled的通知器信号。

另请参阅isEnabled。

`[覆盖虚拟受保护]` bool QGraphicsObject::event(QEvent *ev)

重新实现：QObject::event(QEvent *e)。

void QGraphicsObject::grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags())

将图形对象订阅给特定的gesture和flags。

另请参阅ungrabGesture()和QGestureEvent。

`[信号]` void QGraphicsObject::opacityChanged()

当物品的不透明度发生变化时，此信号将被发出。

注意：属性 opacity（不透明度）的通知器信号。

另请参阅：QGraphicsItem::opacity。

`[信号]` void QGraphicsObject::parentChanged()

当物品的父对象发生变化时，此信号将被发出。

注意：属性 parent（父对象）的通知器信号。

`[信号]` void QGraphicsObject::rotationChanged()

当物品的旋转发生变化时，此信号将被发出。

注意：属性 rotation（旋转）的通知器信号。

`[信号]` void QGraphicsObject::scaleChanged()

当物品的缩放比例发生变化时，此信号将被发出。

注意：属性 scale（缩放比例）的通知器信号。

void QGraphicsObject::ungrabGesture(Qt::GestureType gesture)

取消图形对象对指定的 gesture（手势） 的订阅。

另请参阅：grabGesture() 和 QGestureEvent。

`[保护槽函数]` void QGraphicsObject::updateMicroFocus()

更新物品的微焦点。这是一个方便的槽。

另请参阅：QInputMethod。

`[信号]` void QGraphicsObject::visibleChanged()

当物品的可见性发生变化时，此信号将被发出。

注意：属性 visible（可见）的通知器信号。

另请参阅：visible（可见）。

`[信号]` void QGraphicsObject::xChanged()

当物品的 x 位置发生变化时，此信号将被发出。

注意：属性 x 的通知器信号。

另请参阅：pos。

`[信号]` void QGraphicsObject::yChanged()

当物品的 y 位置发生变化时，此信号将被发出。

注意：属性 y 的通知器信号。

另请参阅：pos。

`[信号]` void QGraphicsObject::zChanged()

当物品的 z 值发生变化时，此信号将被发出。

注意：属性 z 的通知器信号。

另请参阅：pos。

QGraphicsObject 类

属性

公开函数

信号

重新实现受保护的函数

受保护槽

详细描述

父元素和子元素

属性文档

effect : QGraphicsEffect* const

enabled : const bool

opacity : const qreal

parent : QGraphicsObject* const

pos : const QPointF

rotation : const qreal

scale : const qreal

transformOriginPoint : const QPointF

visible : const bool

x : const qreal

y : const qreal

z : const qreal

成员函数文档

[显式] QGraphicsObject::QGraphicsObject(QGraphicsItem *parent = nullptr)

[虚拟 noexcept] QGraphicsObject::~QGraphicsObject()

[信号] void QGraphicsObject::enabledChanged()

[覆盖虚拟受保护] bool QGraphicsObject::event(QEvent *ev)

void QGraphicsObject::grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags())

[信号] void QGraphicsObject::opacityChanged()

[信号] void QGraphicsObject::parentChanged()

[信号] void QGraphicsObject::rotationChanged()

[信号] void QGraphicsObject::scaleChanged()

void QGraphicsObject::ungrabGesture(Qt::GestureType gesture)

[保护槽函数] void QGraphicsObject::updateMicroFocus()

[信号] void QGraphicsObject::visibleChanged()

[信号] void QGraphicsObject::xChanged()

[信号] void QGraphicsObject::yChanged()

[信号] void QGraphicsObject::zChanged()

`[显式]` QGraphicsObject::QGraphicsObject(QGraphicsItem **parent* = nullptr)

`[虚拟 noexcept]` QGraphicsObject::~QGraphicsObject()

`[信号]` void QGraphicsObject::enabledChanged()

`[覆盖虚拟受保护]` bool QGraphicsObject::event(QEvent *ev)

`[信号]` void QGraphicsObject::opacityChanged()

`[信号]` void QGraphicsObject::parentChanged()

`[信号]` void QGraphicsObject::rotationChanged()

`[信号]` void QGraphicsObject::scaleChanged()

`[保护槽函数]` void QGraphicsObject::updateMicroFocus()

`[信号]` void QGraphicsObject::visibleChanged()

`[信号]` void QGraphicsObject::xChanged()

`[信号]` void QGraphicsObject::yChanged()

`[信号]` void QGraphicsObject::zChanged()