图形视图(04)：【类】QGraphicsItem [官翻]

hitzsf

已于 2023-12-09 15:42:49 修改

阅读量2.7k

点赞数 3

分类专栏： # Qt 图形视图文章标签： qt 开发语言 gv

于 2021-03-04 10:38:45 首次发布

本文链接：https://blog.csdn.net/hitzsf/article/details/114362542

版权

Qt 图形视图专栏收录该内容

27 篇文章 20 订阅

订阅专栏

QGraphicsItem 类

QGraphicsItem类是QGraphicsScene中所有图形项的基类。

Header:	#include < QGraphicsItem >
qmake:	QT += widgets
Inherits:
Inherited By:	QAbstractGraphicsShapeItem, QGraphicsItemGroup, QGraphicsLineItem, QGraphicsObject, QGraphicsPixmapItem
Since:	Qt 4.2

详述

它为编写您自己的自定义项目提供了一个轻量级的基础。这包括定义项目的几何形状，碰撞检测，其绘画实现以及通过事件处理程序进行的项目交互。 QGraphicsItem是Graphics View Framework的一部分。

为方便起见，Qt为最常见的形状提供了一组标准图形项目。这些是：

QGraphicsEllipseItem 提供一个椭圆项
QGraphicsLineItem 提供一个线条项
QGraphicsPathItem 提供一个任意路径项
QGraphicsPixmapItem 提供一个像素图项
QGraphicsPolygonItem 提供一个多边形项目
QGraphicsRectItem 提供一个矩形项目
QGraphicsSimpleTextItem 提供一个简单的文本标签项
QGraphicsTextItem 提供了一个高级文本浏览器项

项的所有几何信息均基于其局部坐标系。项目的位置pos() 是唯一不在本地坐标中运行的函数，因为它在父坐标中返回一个位置。图形视图坐标系详细描述了坐标系。

您可以通过调用setVisible() 设置项目是否应可见（即，绘制并接受事件）。隐藏项目也会隐藏其子项。同样，您可以通过调用setEnabled() 启用或禁用项目。如果禁用某个项目，则其所有子项也将被禁用。默认情况下，项目既可见又启用。若要切换是否选择项目，请首先通过设置ItemIsSelectable标志启用选择，然后调用setSelected() 。通常，作为用户交互的结果，场景会切换选择。

要编写自己的图形项，首先要创建QGraphicsItem的子类，然后从实现其两个纯虚拟公共函数开始：boundingRect() 返回该项目绘制的面积的估计值，paint() 实现实际绘画。例如：

 class SimpleItem : public QGraphicsItem
 {
 public:
     QRectF boundingRect() const override
     {
         qreal penWidth = 1;
         return QRectF(-10 - penWidth / 2, -10 - penWidth / 2,
                       20 + penWidth, 20 + penWidth);
     }

     void paint(QPainter *painter, const QStyleOptionGraphicsItem *option,
                QWidget *widget) override
     {
         painter->drawRoundedRect(-10, -10, 20, 20, 5, 5);
     }
 };

boundingRect() 函数具有许多不同的用途。 QGraphicsScene的项目索引基于boundingRect() ，而QGraphicsView则使用它来剔除不可见的项目，并确定绘制重叠项目时需要重新组合的区域。此外，QGraphicsItem的冲突检测机制使用boundingRect() 提供有效的截止点。 collidesWithItem() 中的细粒度碰撞算法基于调用shape() 的方法，该方法返回项目形状的准确轮廓作为QPainterPath。

QGraphicsScene期望所有项目boundingRect() 和shape() 保持不变，除非得到通知。如果要以任何方式更改项目的几何形状，则必须首先调用prepareGeometryChange() 以允许QGraphicsScene更新其簿记。

冲突检测可以通过两种方式完成：

重新实现shape() 以为您的项目返回准确的形状，并依靠collidesWithItem() 的默认实现来进行形状与形状的交点。如果形状复杂，这可能会非常昂贵。
重新实现collidesWithItem() 以提供您自己的自定义项目和形状碰撞算法。

可以调用contains() 函数来确定该项目是否包含一个点。该功能也可以通过项重新实现。 contains() 的默认行为是基于调用shape() 的。

项目可以包含其他项目，也可以包含在其他项目中。所有项目都可以有一个父项和一个子项列表。除非该项目没有父对象，否则它的位置是父对象的坐标（即父对象的本地坐标）。父项将其位置和转换都传播给所有子项。

变换

QGraphicsItem除了其基本位置pos() 外，还支持投影变换。有几种更改项目转换的方法。对于简单的转换，可以调用便捷函数setRotation() 或setScale() ，也可以将任何转换矩阵传递给setTransform() 。对于高级转换控制，您还可以通过调用setTransformations() 来设置多个组合转换。

项转换从父项到子项累积，因此，如果父项和子项都旋转90度，则子项的总转换将为180度。同样，如果项目的父项缩放到其原始大小的2倍，则其子项也将扩大两倍。项的变换不会影响其自身的局部几何形状。所有几何函数（例如，contains() ，update() 和所有映射函数）仍在局部坐标下运行。为了方便起见，QGraphicsItem提供了函数SceneTransform() 和ScenePos() ，该函数返回项的总转换矩阵（包括其位置以及所有父项的位置和转换），并返回其在场景坐标中的位置。要重置项目的矩阵，请调用resetTransform() 。

某些转换操作会根据其应用顺序产生不同的结果。例如，如果缩放转换然后旋转，则可能会得到与首先旋转转换不同的结果。但是，您在QGraphicsItem上设置转换属性的顺序不会影响最终的转换。 QGraphicsItem始终以固定的定义顺序应用属性：

应用项目的基本变换（transform() ）
项目的转换列表按顺序应用（transformations() ）
相对于其变换原点（rotation() ，transformOriginPoint() ）旋转项目
相对于其变换原点（scale() ，transformOriginPoint() ）缩放该项目

绘制

QGraphicsView调用paint() 函数来绘制项目的内容。该项目没有背景，也没有默认填充内容。该项目后面的所有内容都会在此功能中未明确绘制的所有区域中发光。您可以调用update() 安排重新绘制，可以选择传递需要重新绘制的矩形。根据项目是否在视图中可见，该项目可能会被重新粉刷，也可能不会被重新粉刷。在QGraphicsItem中没有等效于QWidget :: repaint() 的对象。

项目是按视图绘制的，从父项开始，然后以升序堆叠子项。您可以通过调用setZValue() 设置项目的堆叠顺序，并通过调用zValue() 对其进行测试，z值较低的项目在z值较高的项目之前被绘制。堆叠顺序适用于同级物品；父母总是在孩子面前被吸引。

排序

所有项目均按定义的稳定顺序绘制，并且此相同的顺序决定了当您单击场景时哪些项目将首先接收鼠标输入。通常，您不必担心排序，因为项目遵循“自然顺序”，遵循场景的逻辑结构。

项的子项堆叠在父项的顶部，兄弟项按照插入顺序堆叠（即，按照它们添加到场景或添加到同一父项的顺序）。如果先添加项目A，然后再添加B，则B将位于A的顶部。如果然后添加C，则项目的堆叠顺序将是A，然后是B，然后是C。

本示例从“拖放机器人”示例中显示了机器人所有肢体的堆叠顺序。躯干是根项（所有其他项是躯干的子代或后代），因此首先绘制它。接下来，绘制头部，因为它是躯干孩子列表中的第一项。然后绘制左上臂。由于下臂是上臂的子代，因此先绘制下臂，然后是上臂的下一个兄弟姐妹，即右上臂，依此类推。

对于高级用户，有一些方法可以更改项目的排序方式：

您可以在一个项目上调用setZValue() ，以将其显式堆叠在其他同级项目之上或之下。项的默认Z值为0。具有相同Z值的项按插入顺序堆叠。
可以调用stackBefore() 重新排序子级列表。这将直接修改插入顺序。
您可以设置ItemStacksBehindParent标志以将子项堆叠在其父项之后。

两个同级项的堆叠顺序也计入每个项的子项和后代项。因此，如果一项在另一项之上，则其所有子项也将在另一项所有子项之上。

事件

QGraphicsItem通过虚拟函数sceneEvent() 从QGraphicsScene接收事件。此函数将最常见的事件分配给一组便捷事件处理程序：

contextMenuEvent() 处理上下文菜单事件
focusInEvent() 和focusOutEvent() 处理焦点入和出事件
hoverEnterEvent() ，hoverMoveEvent() 和hoverLeaveEvent() 处理悬停进入，移动和离开事件
inputMethodEvent() 处理输入事件，以支持可访问性
keyPressEvent() 和keyReleaseEvent() 处理按键按下和释放事件
mousePressEvent() ，mouseMoveEvent() ，mouseReleaseEvent() 和mouseDoubleClickEvent() 处理鼠标的按下，移动，释放，单击和双击事件

您可以通过安装事件过滤器来过滤任何其他项目的事件。此功能与Qt的常规事件过滤器（请参阅QObject :: installEventFilter() ）分开，后者仅适用于QObject的子类。在通过调用installSceneEventFilter() 将项目安装为另一个项目的事件过滤器之后，虚拟函数sceneEventFilter() 将接收过滤的事件。您可以通过调用removeSceneEventFilter() 来删除项目事件过滤器。

自定义数据

有时，用一个项注册自定义数据是很有用的，无论是自定义项还是标准项。可以对任何项调用setData()，使用键-值对(键是一个整数，值是一个QVariant)在其中存储数据。要从项中获取自定义数据，调用data()。这个功能完全不受Qt本身的影响;它是为了方便用户而提供的。

参见QGraphicsScene, QGraphicsView和图形视图框架。

公共类型

enum CacheMode

该enum描述QGraphicsItem的缓存模式。缓存通过分配和呈现到屏幕外像素缓冲区来加速呈现，当项目需要重绘时，可以重用该像素缓冲区。对于一些绘制设备，缓存直接存储在图形内存中，这使得渲染非常快。

Constant	Value	Description
NoCache	0	默认;禁用所有项缓存。每次项目需要重绘时调用QGraphicsItem::paint()。
ItemCoordinateCache	1	为项的逻辑(本地)坐标系统启用缓存。QGraphicsItem创建一个可配置大小/分辨率的屏幕外像素缓冲区，您可以传递给QGraphicsItem::setCacheMode()。渲染质量通常会降低，这取决于缓存的分辨率和项转换。第一次重绘项时，它将自己呈现到缓存中，然后缓存将在以后的每次公开中重用。在转换项时，缓存也会被重用。要调整缓存的分辨率，可以再次调用setCacheMode()。
DeviceCoordinateCache	2	缓存是在绘制设备级别的设备坐标中启用的。此模式适用于可以移动但不旋转、缩放或剪切的项目。如果条目被直接或间接转换，缓存将自动重新生成。与ItemCoordinateCacheMode不同，DeviceCoordinateCache总是以最高质量呈现。

参见QGraphicsItem: setCacheMode()。

enum GraphicsItemChange

该enum描述由QGraphicsItem::itemChange()通知的状态变化。通知在状态更改时发送，在某些情况下，还可以进行调整(有关每个更改的详细信息，请参阅文档)。

注意:在itemChange()内部调用QGraphicsItem本身上的函数时要小心，因为某些函数调用可能导致不必要的递归。例如，你不能在itemChange()中对ItemPositionChange通知调用setPos()，因为setPos()函数将再次调用itemChange(ItemPositionChange)。相反，您可以从itemChange()返回调整后的新位置。

Constant	Value	Description
ItemPositionChange	0	项目的位置改变了。如果启用了ItemSendsGeometryChanges标志，并且当项目的局部位置相对于其父位置发生变化时(即，由于调用setPos()或moveBy())，则发送此通知。value参数是新的位置(即QPointF)。您可以调用pos()来获得原始位置。在发送此通知时，不要在itemChange()中调用setPos()或movby ();相反，您可以从itemChange()返回调整后的新位置。在此通知之后，如果位置发生变化，QGraphicsItem将立即发送ItemPositionHasChanged通知。
ItemMatrixChange	1	项目的仿射变换矩阵正在变化。这个值过时了;您可以使用ItemTransformChange代替。
ItemVisibleChange	2	项的可见状态改变了。如果物品现在是可见的，它将变成不可见的，反之亦然。value参数是新的可见状态(即，true或false)。在发送此通知时，不要在itemChange()中调用setVisible();相反，您可以从itemChange()返回新的可见状态。
ItemEnabledChange	3	项目的启用状态改变。如果该项目前是启用的，它将被禁用，反之亦然。参数value是新的启用状态(即true或false)。在发送此通知时，不要在itemChange()中调用setEnabled()。相反，您可以从itemChange()返回新的状态。
ItemSelectedChange	4	项目的选中状态改变。如果项目目前已被选中，则它将被取消选中，反之亦然。value参数是新选择的状态(即，true或false)。在发送此通知时，不要在itemChange()中调用setSelected();相反，您可以从itemChange()返回新选定的状态。
ItemParentChange	5	项目的父项改变。value参数是新的父项(即一个QGraphicsItem指针)。在发送此通知时，不要在itemChange()中调用setParentItem();相反，您可以从itemChange()返回新的父对象。
ItemChildAddedChange	6	将一个子项添加到此项中。value参数是新的子项(即QGraphicsItem指针)。当发送此通知时，不要将此项目传递给任何项目的setParentItem()函数。返回值未被使用;您无法调整此通知中的任何内容。请注意，在发送此通知时，新子节点可能还没有完全构造好;在子节点上调用纯虚函数可能会导致崩溃。
ItemChildRemovedChange	7	从该项中删除子项。value参数是将要被删除的子项(即QGraphicsItem指针)。返回值未被使用;您无法调整此通知中的任何内容。
ItemTransformChange	8	项的变换矩阵改变了。如果启用了ItemSendsGeometryChanges标志，并且当项目的局部转换矩阵发生变化时(即，由于调用setTransform())，将发送此通知。value参数是新矩阵(即一个QTransform);要得到旧的矩阵，调用transform()。在发送此通知时，不要调用setTransform()或在itemChange()中设置任何转换属性;相反，您可以从itemChange()返回新的矩阵。如果更改转换属性，则不会发送此通知。
ItemPositionHasChanged	9	物品的位置已经改变。如果启用了ItemSendsGeometryChanges标志，并且在项目的本地位置(相对于其父位置)发生变化之后，就会发送此通知。value参数是新的位置(与pos()相同)，QGraphicsItem忽略该通知的返回值(即只读通知)。
ItemTransformHasChanged	10	由于调用了setTransform，或者其中一个转换属性发生了变化，项目的转换矩阵发生了变化。如果启用了ItemSendsGeometryChanges标志，并且在项目的局部转换矩阵更改之后，将发送此通知。value参数是新矩阵(与transform()相同)，QGraphicsItem忽略此通知的返回值(即只读通知)。
ItemSceneChange	11	物品被移动到一个新的场景。当项目被添加到它的初始场景时，这个通知也被发送，当它被删除时。项目的scene()是旧场景，如果项目还没有添加到场景中，则为nullptr。value参数是新场景(即QGraphicsScene指针)，如果项目从场景中删除，则为nullptr。当发送此通知时，不要通过将此项目传递给QGraphicsScene::addItem()来覆盖此更改;相反，你可以从itemChange()返回新的场景。请谨慎使用此功能;反对场景更改会很快导致不必要的递归。
ItemVisibleHasChanged	12	项的可见状态已更改。value参数是新的可见状态(即，true或false)。发送此通知时，不要在itemChange()中调用setVisible()。返回值将被忽略。
ItemEnabledHasChanged	13	项目的启用状态已更改。参数value是新的启用状态(即true或false)。在发送此通知时，不要在itemChange()中调用setEnabled()。返回值将被忽略。
ItemSelectedHasChanged	14	项目的选中状态已更改。value参数是新选择的状态(即，true或false)。在发送此通知时，不要在itemChange()中调用setSelected()。返回值将被忽略。
ItemParentHasChanged	15	项目的父项已经更改。value参数是新的父元素(即指向QGraphicsItem的指针)。发送此通知时，不要在itemChange()中调用setParentItem()。返回值将被忽略。
ItemSceneHasChanged	16	物品的场景发生了变化。道具的场景()是新场景。当项目被添加到它的初始场景时，这个通知也被发送，当它被删除时。value参数是新场景(即指向QGraphicsScene的指针)。在发送通知时，不要在itemChange()中调用setScene()。返回值将被忽略。
ItemCursorChange	17	项目的光标改变。value参数是新的游标(即QCursor)。在发送此通知时，不要在itemChange()中调用setCursor()。相反，您可以从itemChange()返回一个新的游标。
ItemCursorHasChanged	18	项目的光标已经改变。value参数是新的游标(即QCursor)。发送此通知时不要调用setCursor()。返回值将被忽略。
ItemToolTipChange	19	项目的工具提示改变。value参数是新的工具提示(即QToolTip)。在发送此通知时，不要在itemChange()中调用setToolTip()。相反，您可以从itemChange()返回一个新的工具提示。
ItemToolTipHasChanged	20	物品的工具提示改变了。value参数是新的工具提示(即QToolTip)。发送此通知时不要调用setToolTip()。返回值将被忽略。
ItemFlagsChange	21	项目的标志改变了。value参数是新的标志(即quint32)。在发送此通知时，不要在itemChange()中调用setFlags()。相反，您可以从itemChange()返回新的标志。
ItemFlagsHaveChanged	22	项目的标志已经改变。value参数是新的标志(即quint32)。在发送此通知时，不要在itemChange()中调用setFlags()。返回值将被忽略。
ItemZValueChange	23	物品的z值改变了。value参数是新的z值(即double)。发送此通知时，不要在itemChange()中调用setZValue()。相反，您可以从itemChange()返回一个新的z值。
ItemZValueHasChanged	24	物品的z值已经改变。value参数是新的z值(即double)。发送此通知时不要调用setZValue()。返回值将被忽略。
ItemOpacityChange	25	项目的不透明度改变。value参数是新的不透明度(即double)。发送此通知时，不要在itemChange()中调用setOpacity()。相反，您可以从itemChange()返回一个新的不透明度。
ItemOpacityHasChanged	26	项目的不透明度已经改变。value参数是新的不透明度(即double)。发送此通知时不要调用setOpacity()。返回值将被忽略。
ItemScenePositionHasChanged	27	物品的场景位置改变了。如果启用了ItemSendsScenePositionChanges标志，并且在项目的场景位置发生了变化(例如，项目本身的位置或转换，或者任何祖先的位置或转换发生了变化)之后，这个通知就会发送。value参数是新的场景位置(与scenePos()相同)，QGraphicsItem忽略此通知的返回值(即只读通知)。
ItemRotationChange	28	项目的旋转属性改变。如果启用了ItemSendsGeometryChanges标志，以及当项目的旋转属性发生变化(即，由于调用setRotation())时，将发送此通知。value参数是新的旋转(即double);要获得旧的旋转，调用rotation()。在发送此通知时，不要在itemChange()中调用settrotation ();相反，您可以从itemChange()返回新的旋转。
ItemRotationHasChanged	29	项目的旋转属性已经改变。如果启用了ItemSendsGeometryChanges标志，并且在项目的旋转属性改变之后，这个通知就会发送。value参数是新的旋转(即double)， QGraphicsItem忽略该通知的返回值(即只读通知)。在发送此通知时，不要在itemChange()中调用settrotation()。
ItemScaleChange	30	项目的scale属性改变。如果启用了ItemSendsGeometryChanges标志，以及当项目的scale属性发生变化时(即，由于调用setScale())，这个通知就会发送。value参数是新的刻度(即double);调用scale()来获取旧的刻度。在发送此通知时，不要在itemChange()中调用setScale();相反，您可以从itemChange()返回新的比例。
ItemScaleHasChanged	31	项目的规模属性已经改变。如果启用了ItemSendsGeometryChanges标志，并且在项目的scale属性改变之后，这个通知就会发送。value参数是新的刻度(即double)，而QGraphicsItem忽略该通知的返回值(即只读通知)。在发送此通知时，不要在itemChange()中调用setScale()。
ItemTransformOriginPointChange	32	项目的transform origin point属性改变。如果启用了ItemSendsGeometryChanges标志，并且当项目的transform origin point属性发生变化时(即，由于调用setTransformOriginPoint())，则发送此通知。value参数是新的原点(即QPointF);要获得旧的原点，请调用transformOriginPoint()。在发送此通知时，不要在itemChange()中调用setTransformOriginPoint();相反，您可以从itemChange()返回新的转换起点。
ItemTransformOriginPointHasChanged	33	项目的transform origin point属性已更改。如果启用了ItemSendsGeometryChanges标志，并且在项目的transform origin point属性更改之后，将发送此通知。value参数是新的起源

enum GraphicsItemFlag

flags GraphicsItemFlags

此枚举描述了您可以在项目上设置的不同标志，以切换项目行为中的不同特性。
默认情况下，所有标志都是禁用的。

Constant	Value	Description
ItemIsMovable	0x1	该项目支持使用鼠标进行交互式移动。通过单击项目然后拖动，项目将随着鼠标光标一起移动。如果项目有子项目，则也会移动所有子项目。如果项目是选定项目的一部分，则也将移动所有选定的项目。这个特性是通过QGraphicsItem的鼠标事件处理程序的基本实现提供的。
ItemIsSelectable	0x2	项目支持选择。启用此功能将使setSelected()能够切换项目的选择。通过单击一个项目，或者在QGraphicsView中使用橡皮筋选择，它还将让项目在调用QGraphicsScene::setSelectionArea()后自动被选中。
ItemIsFocusable	0x4	该项目支持键盘输入焦点(即，它是一个输入项目)。启用此标志将允许项目接受焦点，这再次允许向QGraphicsItem::keyPressEvent()和QGraphicsItem::keyReleaseEvent()传递键事件。
ItemClipsToShape	0x8	项目剪辑成它自己的形状。该项目不能在其形状之外绘制或接收鼠标、平板、拖放或悬停事件。默认为禁用。QGraphicsView::drawItems()或QGraphicsScene::drawItems()强制执行此行为。这个标志是Qt 4.3中引入的。
ItemClipsChildrenToShape	0x10	该项目将其所有后代的画作剪辑成自己的形状。作为该项的直接或间接子项的项不能在该项的形状之外绘制。默认情况下，此标志是禁用的;孩子们可以在任何地方画画。QGraphicsView::drawItems()或QGraphicsScene::drawItems()强制执行此行为。这个标志是Qt 4.3中引入的。

注意:这个标志类似于ItemContainsChildrenInShape，但还通过剪切子元素来强制包含。

Constant	Value	Description
ItemIgnoresTransformations	0x20	项目忽略继承的转换(即，它的位置仍然锚定到它的父类，但是父类或视图旋转、缩放或剪切转换被忽略)。这个标志对于保持文本标签项水平和未缩放很有用，所以如果视图被转换，它们仍然是可读的。设置后，项目的视图几何和场景几何将被分开维护。你必须调用deviceTransform()来映射坐标并检测视图中的冲突。缺省情况下，禁用此标志。这个标志是Qt 4.3中引入的。

注意:通过设置这个标志，你仍然可以缩放项目本身，而且这个缩放转换将影响项目的子项目。

Constant	Value	Description
ItemIgnoresParentOpacity	0x40	该项目忽略其父项目的不透明度。项目的有效不透明度与其本身相同;它不与父节点的不透明度相结合。这个标志允许你的项目保持绝对不透明度，即使父项目是半透明的。这个标志是在Qt 4.5中引入的。
ItemDoesntPropagateOpacityToChildren	0x80	项目不会将其不透明度传播给它的子项目。此标志允许您创建不影响其子元素不透明度的半透明项。这个标志是在Qt 4.5中引入的。
ItemStacksBehindParent	0x100	条目被堆放在其父条目的后面。默认情况下，子项堆叠在父项的顶部。但在这面旗帜上，孩子会被堆在它后面。这个标志对于投影效果和跟随父项的几何体而不在其上绘制的装饰对象是有用的。这个标志是在Qt 4.5中引入的。
ItemUsesExtendedStyleOption	0x200	项目在QStyleOptionGraphicsItem中使用exposedirect或matrix。默认情况下，exposedirect被初始化为项目的boundingRect()，而矩阵没有被转换。您可以启用此标志，以便用更细粒度的值设置样式选项。注意，QStyleOptionGraphicsItem::levelOfDetail不受此标志的影响，并且总是初始化为1。如果你需要一个更高的值，可以使用QStyleOptionGraphicsItem::levelOfDetailFromTransform()。这个标志是在Qt 4.6中引入的。
ItemHasNoContents	0x400	该项目不会绘制任何东西(即，在该项目上调用paint()没有效果)。您应该在不需要绘制的项上设置此标志，以确保图形视图避免不必要的绘制准备。这个标志是在Qt 4.6中引入的。
ItemSendsGeometryChanges	0x800	项目启用itemChange()通知ItemPositionChange、ItemPositionHasChanged、ItemTransformChange、ItemTransformHasChanged、ItemRotationChange、ItemRotationHasChanged、ItemScaleChange、ItemScaleHasChanged、ItemTransformOriginPointChange和ItemTransformOriginPointHasChanged。出于性能原因，这些通知在默认情况下是禁用的。必须启用此标志才能接收位置和转换更改的通知。这个标志是在Qt 4.6中引入的。
ItemAcceptsInputMethod	0x1000	该项支持通常用于亚洲语言的输入法。这个标志是在Qt 4.6中引入的。
ItemNegativeZStacksBehindParent	0x2000	如果它的z值为负，项目会自动堆叠在它的父项目后面。这个标志启用setZValue()来切换ItemStacksBehindParent。这个标志是在Qt 4.6中引入的。
ItemIsPanel	0x4000	该项目是一个面板。面板提供激活和包含的焦点处理。一次只能激活一个面板(参见QGraphicsItem::isActive())。当没有面板激活时，QGraphicsScene激活所有非面板项目。窗口项(例如，QGraphicsItem::isWindow()返回true)是面板。这个标志是在Qt 4.6中引入的。
ItemSendsScenePositionChanges	0x10000	项目启用ItemScenePositionHasChanged的itemChange()通知。出于性能原因，这些通知在默认情况下是禁用的。你必须启用这个标志来接收场景位置改变的通知。这个标志是在Qt 4.6中引入的。
ItemContainsChildrenInShape	0x80000	该标志表明，项目的所有直接或间接子项目仅在项目的形状内绘制。与ItemClipsChildrenToShape不同，这个限制不强制执行。当您手动确保绘图已绑定到项目的形状，并且希望避免与强制剪辑相关的成本时，设置itemcontainchildreninshape。设置此标志可以更有效地绘制和碰撞检测。缺省情况下，该标志是关闭的。

注意:如果同时设置了这个标志和ItemClipsChildrenToShape，则剪切将被强制执行。这等价于设置ItemClipsChildrenToShape。这个标志是在Qt 5.4中引入的。

enum PanelModality

此枚举指定模态面板的行为。模态面板是将输入阻塞到其他面板的面板。注意，模态面板的子项目不会被阻塞。

Constant	Value	Description
NonModal	0	面板不是模态的，不会阻塞其他面板的输入。这是面板的默认值。
PanelModal	1	该面板对单个项目层次结构是模态的，并阻止输入到其父面板、所有祖父面板以及其父面板和祖父面板的所有兄弟面板。
SceneModal	2	该窗口对整个场景是模态的，并阻塞所有面板的输入。

参见QGraphicsItem::setPanelModality()， QGraphicsItem::panelModality()和QGraphicsItem:: itempanel。

enum anonymous

Qt中的标准图形项类中的virtual type()函数返回的值。所有这些标准图形项类都与type的唯一值相关联，例如QGraphicsPathItem::type()函数返回的值是2。

Constant	Value	Description
Type	1	class QGraphicsPathItem : public QAbstractGraphicsShapeItem { public: enum { Type = 2 }; int type() const override { return Type; } … };
UserType	65536	由virtual type()函数为QGraphicsItem的自定义子类返回的最小值。 class CustomItem : public QGraphicsItem { public: enum { Type = UserType + 1 }; int type() const override { // Enable the use of qgraphicsitem_cast with this item. return Type; } … };

公共函数

构造析构

QGraphicsItem(QGraphicsItem *parent = nullptr)
virtual ~QGraphicsItem()

类型相关

QGraphicsItem::CacheMode cacheMode() const
void setCacheMode(QGraphicsItem::CacheMode mode, const QSize &logicalCacheSize = QSize())
QGraphicsItem::PanelModality panelModality() const
void setPanelModality(QGraphicsItem::PanelModality panelModality)
virtual int type() const

交互

bool acceptDrops() const
void setAcceptDrops(bool on)
bool acceptHoverEvents() const
void setAcceptHoverEvents(bool enabled)
bool acceptTouchEvents() const
void setAcceptTouchEvents(bool enabled)
Qt::MouseButtons acceptedMouseButtons() const
void setAcceptedMouseButtons(Qt::MouseButtons buttons)
Qt::InputMethodHints inputMethodHints() const
void setInputMethodHints(Qt::InputMethodHints hints)

特殊

virtual void advance(int phase)
QPainterPath clipPath() const
bool isClipped() const
bool isBlockedByModalPanel(QGraphicsItem **blockingPanel = nullptr) const
bool isEnabled() const
void setEnabled(bool enabled)
bool isSelected() const
void setSelected(bool selected)
bool isUnderMouse() const
bool isWidget() const
bool isWindow() const
QGraphicsScene * scene() const
QGraphicsObject * toGraphicsObject()
const QGraphicsObject * toGraphicsObject() const
QString toolTip() const
void setToolTip(const QString &toolTip)
QGraphicsWidget * window() const

边界相关

virtual QRectF boundingRect() const = 0
QRegion boundingRegion(const QTransform &itemToDeviceTransform) const
virtual bool contains(const QPointF &point) const
virtual QPainterPath shape() const
qreal boundingRegionGranularity() const
void setBoundingRegionGranularity(qreal granularity)
QRectF childrenBoundingRect() const
QRectF sceneBoundingRect() const

层次关系

QList<QGraphicsItem *> childItems() const
QGraphicsItem * parentItem() const
void setParentItem(QGraphicsItem *newParent)
QGraphicsObject * parentObject() const
QGraphicsWidget * parentWidget() const
QGraphicsItem * topLevelItem() const
QGraphicsWidget * topLevelWidget() const
QGraphicsItem * commonAncestorItem(const QGraphicsItem *other) const
bool isAncestorOf(const QGraphicsItem *child) const

焦点

void clearFocus()
bool hasFocus() const
void setFocus(Qt::FocusReason focusReason = Qt::OtherFocusReason)
QGraphicsItem * focusItem() const
QGraphicsItem * focusProxy() const
void setFocusProxy(QGraphicsItem *item)

碰撞

virtual bool collidesWithItem(const QGraphicsItem *other, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const
virtual bool collidesWithPath(const QPainterPath &path, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const
QList<QGraphicsItem *> collidingItems(Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const

光标

QCursor cursor() const
void setCursor(const QCursor &cursor)
bool hasCursor() const
void unsetCursor()

数据

QVariant data(int key) const
void setData(int key, const QVariant &value)

变换

QTransform deviceTransform(const QTransform &viewportTransform) const
QTransform itemTransform(const QGraphicsItem *other, bool *ok = nullptr) const
QTransform transform() const
void setTransform(const QTransform &matrix, bool combine = false)
void resetTransform()
qreal rotation() const
void setRotation(qreal angle)
qreal scale() const
void setScale(qreal factor)
void scroll(qreal dx, qreal dy, const QRectF &rect = QRectF())
QPointF transformOriginPoint() const
void setTransformOriginPoint(const QPointF &origin)
void setTransformOriginPoint(qreal x, qreal y)
QList<QGraphicsTransform *> transformations() const
void setTransformations(const QList<QGraphicsTransform *> &transformations)
QPointF scenePos() const
QTransform sceneTransform() const

特效

qreal effectiveOpacity() const
qreal opacity() const
void setOpacity(qreal opacity)
QGraphicsEffect * graphicsEffect() const
void setGraphicsEffect(QGraphicsEffect *effect)
virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = 0) = 0
void update(const QRectF &rect = QRectF())
void update(qreal x, qreal y, qreal width, qreal height)

视图

void ensureVisible(const QRectF &rect = QRectF(), int xmargin = 50, int ymargin = 50)
void ensureVisible(qreal x, qreal y, qreal w, qreal h, int xmargin = 50, int ymargin = 50)

事件

bool filtersChildEvents() const
void setFiltersChildEvents(bool enabled)
void installSceneEventFilter(QGraphicsItem *filterItem)
void removeSceneEventFilter(QGraphicsItem *filterItem)

标志

QGraphicsItem::GraphicsItemFlags flags() const 返回此项目的标志
这些标志描述了启用或不启用该项目的哪些可配置功能。例如，如果标志包括ItemIsFocusable，则该项可以接受输入焦点。
默认情况下，未启用任何标志。
void setFlag(QGraphicsItem::GraphicsItemFlag flag, bool enabled = true) 设置单个项目标志
void setFlags(QGraphicsItem::GraphicsItemFlags flags) 设置多个标志

键鼠

void grabKeyboard()
void ungrabKeyboard()
void grabMouse()
void ungrabMouse()

组

QGraphicsItemGroup * group() const
void setGroup(QGraphicsItemGroup *group)

可视

void hide()
void show()
bool isVisible() const
void setVisible(bool visible)
bool isVisibleTo(const QGraphicsItem *parent) const
bool isObscured(const QRectF &rect = QRectF()) const
bool isObscured(qreal x, qreal y, qreal w, qreal h) const
virtual bool isObscuredBy(const QGraphicsItem *item) const
virtual QPainterPath opaqueArea() const

激活

bool isActive() const
QGraphicsItem * panel() const
bool isPanel() const
void setActive(bool active)

坐标变换

QPointF mapFromItem(const QGraphicsItem *item, const QPointF &point) const
QPolygonF mapFromItem(const QGraphicsItem *item, const QRectF &rect) const
QPolygonF mapFromItem(const QGraphicsItem *item, const QPolygonF &polygon) const
QPainterPath mapFromItem(const QGraphicsItem *item, const QPainterPath &path) const
QPointF mapFromItem(const QGraphicsItem *item, qreal x, qreal y) const
QPolygonF mapFromItem(const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const
QPointF mapFromParent(const QPointF &point) const
QPolygonF mapFromParent(const QRectF &rect) const
QPolygonF mapFromParent(const QPolygonF &polygon) const
QPainterPath mapFromParent(const QPainterPath &path) const
QPointF mapFromParent(qreal x, qreal y) const
QPolygonF mapFromParent(qreal x, qreal y, qreal w, qreal h) const
QPointF mapFromScene(const QPointF &point) const
QPolygonF mapFromScene(const QRectF &rect) const
QPolygonF mapFromScene(const QPolygonF &polygon) const
QPainterPath mapFromScene(const QPainterPath &path) const
QPointF mapFromScene(qreal x, qreal y) const
QPolygonF mapFromScene(qreal x, qreal y, qreal w, qreal h) const
QRectF mapRectFromItem(const QGraphicsItem *item, const QRectF &rect) const
QRectF mapRectFromItem(const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const
QRectF mapRectFromParent(const QRectF &rect) const
QRectF mapRectFromParent(qreal x, qreal y, qreal w, qreal h) const
QRectF mapRectFromScene(const QRectF &rect) const
QRectF mapRectFromScene(qreal x, qreal y, qreal w, qreal h) const
QRectF mapRectToItem(const QGraphicsItem *item, const QRectF &rect) const
QRectF mapRectToItem(const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const
QRectF mapRectToParent(const QRectF &rect) const
QRectF mapRectToParent(qreal x, qreal y, qreal w, qreal h) const
QRectF mapRectToScene(const QRectF &rect) const
QRectF mapRectToScene(qreal x, qreal y, qreal w, qreal h) const
QPointF mapToItem(const QGraphicsItem *item, const QPointF &point) const
QPolygonF mapToItem(const QGraphicsItem *item, const QRectF &rect) const
QPolygonF mapToItem(const QGraphicsItem *item, const QPolygonF &polygon) const
QPainterPath mapToItem(const QGraphicsItem *item, const QPainterPath &path) const
QPointF mapToItem(const QGraphicsItem *item, qreal x, qreal y) const
QPolygonF mapToItem(const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const
QPointF mapToParent(const QPointF &point) const
QPolygonF mapToParent(const QRectF &rect) const
QPolygonF mapToParent(const QPolygonF &polygon) const
QPainterPath mapToParent(const QPainterPath &path) const
QPointF mapToParent(qreal x, qreal y) const
QPolygonF mapToParent(qreal x, qreal y, qreal w, qreal h) const
QPointF mapToScene(const QPointF &point) const
QPolygonF mapToScene(const QRectF &rect) const
QPolygonF mapToScene(const QPolygonF &polygon) const
QPainterPath mapToScene(const QPainterPath &path) const
QPointF mapToScene(qreal x, qreal y) const
QPolygonF mapToScene(qreal x, qreal y, qreal w, qreal h) const

位置

void moveBy(qreal dx, qreal dy)
QPointF pos() const
void setPos(const QPointF &pos)
void setPos(qreal x, qreal y)
qreal x() const
qreal y() const
void setX(qreal x)
void setY(qreal y)
qreal zValue() const
void setZValue(qreal z)
void stackBefore(const QGraphicsItem *sibling)

受保护的函数

virtual void contextMenuEvent(QGraphicsSceneContextMenuEvent *event)
virtual void dragEnterEvent(QGraphicsSceneDragDropEvent *event)
virtual void dragLeaveEvent(QGraphicsSceneDragDropEvent *event)
virtual void dragMoveEvent(QGraphicsSceneDragDropEvent *event)
virtual void dropEvent(QGraphicsSceneDragDropEvent *event)
virtual void focusInEvent(QFocusEvent *event)
virtual void focusOutEvent(QFocusEvent *event)
virtual void hoverEnterEvent(QGraphicsSceneHoverEvent *event)
virtual void hoverLeaveEvent(QGraphicsSceneHoverEvent *event)
virtual void hoverMoveEvent(QGraphicsSceneHoverEvent *event)
virtual void inputMethodEvent(QInputMethodEvent *event)
virtual QVariant inputMethodQuery(Qt::InputMethodQuery query) const
virtual QVariant itemChange(QGraphicsItem::GraphicsItemChange change, const QVariant &value)
virtual void keyPressEvent(QKeyEvent *event)
virtual void keyReleaseEvent(QKeyEvent *event)
virtual void mouseDoubleClickEvent(QGraphicsSceneMouseEvent *event)
virtual void mouseMoveEvent(QGraphicsSceneMouseEvent *event)
virtual void mousePressEvent(QGraphicsSceneMouseEvent *event)
virtual void mouseReleaseEvent(QGraphicsSceneMouseEvent *event)
void prepareGeometryChange()
virtual bool sceneEvent(QEvent *event)
virtual bool sceneEventFilter(QGraphicsItem *watched, QEvent *event)
void updateMicroFocus()
virtual void wheelEvent(QGraphicsSceneWheelEvent *event)