PySide6.QtWidgets.QGraphicsObject¶

class QGraphicsObject¶

QGraphicsObject 类为所有需要信号、槽和属性的图形项提供了一个基类。更多…

继承自： QGraphicsWidget, QGraphicsProxyWidget, QGraphicsTextItem, QGraphicsSvgItem, QGraphicsVideoItem, QLegend, QChart, QPolarChart

在版本4.6中添加。

概要¶

属性¶

effectᅟ - 附加到此项目的效果
enabledᅟ - 项目是否启用
opacityᅟ - 项目的不透明度
parentᅟ - 项目的父级
posᅟ - 项目的位置
rotationᅟ - 项目的旋转角度
scaleᅟ - 项目的规模
transformOriginPointᅟ - 变换原点
visibleᅟ - 项目是否可见
xᅟ - 项目的x位置
yᅟ - 项目的y位置
zᅟ - 项目的z值

信号¶

def childrenChanged()
def enabledChanged()
def heightChanged()
def opacityChanged()
def parentChanged()
def rotationChanged()
def scaleChanged()
def visibleChanged()
def widthChanged()
def xChanged()
def yChanged()
def zChanged()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

该类通过QObject的信号/槽和属性机制扩展了QGraphicsItem。它将QGraphicsItem的许多基本设置器和获取器映射到属性，并为其中许多属性添加了通知信号。

父母与子女¶

每个图形对象都可以使用父项进行构造。这确保了当父项被销毁时，该项也将被销毁。尽管QGraphicsObject继承自QObject和QGraphicsItem，你应该使用QGraphicsItem提供的函数，而不是QObject，来管理父子项之间的关系。

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

另请参阅

QGraphicsWidget

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property effectᅟ: QGraphicsEffect¶

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

另请参阅

setGraphicsEffect() graphicsEffect()

访问函数：

property enabledᅟ: bool¶

此属性表示项目是否启用。

此属性在 QGraphicsItem 中声明。

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

另请参阅

isEnabled() setEnabled()

Access functions:

信号 enabledChanged()

property opacityᅟ: float¶

此属性表示项目的不透明度。

另请参阅

setOpacity() opacity()

Access functions:

信号 opacityChanged()

property parentᅟ: QGraphicsObject¶

此属性保存项目的父项。

注意

项目的父级是独立于QObject::parent()返回的父对象设置的。

另请参阅

setParentItem() parentObject()

Access functions:

信号 parentChanged()

property posᅟ: QPointF¶

此属性保存项目的位置。

描述项目的位置。

另请参阅

setPos() pos()

访问函数：

property rotationᅟ: float¶

此属性保存项目的旋转角度。

这指定了项目围绕其transformOrigin旋转的度数。默认旋转为0度（即完全不旋转）。

Access functions:

信号 rotationChanged()

property scaleᅟ: float¶

此属性保存项目的比例。

小于1的比例意味着项目将显示得比正常小，大于1的比例意味着项目将显示得比正常大。负比例意味着项目将被镜像。

默认情况下，项目以1的比例显示（即以其正常大小）。

缩放是从项目的transformOrigin开始的。

Access functions:

信号 scaleChanged()

property transformOriginPointᅟ: QPointF¶

此属性保存变换原点。

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

另请参阅

scale rotation transformOriginPoint()

访问函数：

property visibleᅟ: bool¶

此属性表示项目是否可见。

此属性在 QGraphicsItem 中声明。

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

另请参阅

isVisible() setVisible()

Access functions:

信号 visibleChanged()

property xᅟ: float¶

此属性保存项目的x位置。

描述项目x的位置。

另请参阅

setX() setPos()

Access functions:

信号 xChanged()

property yᅟ: float¶

此属性保存项目的y位置。

描述项目的y位置。

另请参阅

setY() setPos()

Access functions:

信号 yChanged()

property zᅟ: float¶

此属性保存项目的 z 值。

描述项目的z值。

另请参阅

setZValue() zValue()

Access functions:

信号 zChanged()

__init__([parent=None])¶

Parameters:: 父级 – QGraphicsItem

构造一个带有parent的QGraphicsObject。

childrenChanged()¶

enabledChanged()¶

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

另请参阅

isEnabled()

属性 enabledᅟ 的通知信号。

grabGesture(type[, flags=Qt.GestureFlags()])¶

Parameters:

type – GestureType
flags – GestureFlag 的组合

将图形对象订阅到给定的gesture，并带有特定的flags。

另请参阅

ungrabGesture() QGestureEvent

heightChanged()¶

opacityChanged()¶

每当项目的不透明度发生变化时，此信号就会发出

另请参阅

opacity()

属性 opacityᅟ 的通知信号。

parentChanged()¶

每当项目的父项发生变化时，此信号就会发出

属性 parentᅟ 的通知信号。

rotationChanged()¶

每当项目的旋转发生变化时，就会发出此信号。

属性 rotationᅟ 的通知信号。

scaleChanged()¶

当项目的比例发生变化时，会发出此信号。

属性 scaleᅟ 的通知信号。

ungrabGesture(type)¶

Parameters:: 类型 – GestureType

从给定的gesture中取消订阅图形对象。

另请参阅

grabGesture() QGestureEvent

visibleChanged()¶

每当项目的可见性发生变化时，此信号就会被发出

另请参阅

visible

属性 visibleᅟ 的通知信号。

widthChanged()¶

xChanged()¶

每当项目的x位置发生变化时，此信号会被发出

另请参阅

pos()

属性 xᅟ 的通知信号。

yChanged()¶

每当项目的y位置发生变化时，就会发出此信号。

另请参阅

pos()

属性 yᅟ 的通知信号。

zChanged()¶

每当项目的z值发生变化时，此信号会被发出。

另请参阅

pos()

属性 zᅟ 的通知信号。