简述

QGraphicsItem 支持很多特性，例如：鼠标、键盘事件、拖放、分组、碰撞检测等。

通常在演示工具中使用分组，当用户想要将多个较小的 items 组合成一个大的 item 时，以简化 items 的移动和复制。

简述分组方式QGraphicsItemGroup 示例 效果源码

分组方式

分组方式有两种：

通过父子关系 - 如果想要将 items 存储在其他 item 内，可以直接将任何 QGraphicsItem 通过为 setParentItem() 传递一个合适的 parent。

QGraphicsItemGroup - 提供了一个容器，将一组 items 视为单个 item。

注意： 对于方式一，QGraphicsItem 可以有自己的子 item 对象。但是，QGraphicsItem 没有 API（例如：setItems()、addChild()）添加孩子，它只能允许孩子附加到 parent （setParentItem()），想想也挺神奇的。

QGraphicsItemGroup

QGraphicsItemGroup 是一种特殊类型的复合 item，将自身及其所有子项视为一个 item（即，其所有子项的所有事件和几何图形都被合并在一起）。

QGraphicsItemGroup 的 boundingRect() 函数返回位于其中所有 items 的边界矩形。QGraphicsItemGroup 忽略其子项上的 ItemIgnoresTransformations 标记（即，相对于 QGraphicsItemGroup 的 geometry，子项被视为可变换的）。

要构造一个 QGraphicsItemGroup，有两种方式：

将一个 items 列表（例如：所有选择的 items）传递给 QGraphicsScene::createItemGroup()，它返回一个新的 QGraphicsItemGroup（最简单、最常见的方式）。

手动构造一个 QGraphicsItemGroup，使用 QGraphicsScene::addItem() 将其添加到场景中，然后通过调用 addToGroup() 为 group 手动添加 item，一次只能添加一个。

要拆卸（取消组合）一个 QGraphicsItemGroup，可以调用 QGraphicsScene::destroyItemGroup()，也可以通过调用 removeFromGroup() 从 group 中手动删除所有 items。

// 将所有选定的 items 组合在一起 QGraphicsItemGroup *group = scene->createItemGroup(scene->selecteditems()); // 销毁 group，并删除 group item scene->destroyItemGroup(group);

示例

常用的软件，例如：XMind、Visio 都有分组功能。下面，我们实现一个简单的分组，利用一个直线（链接线）将椭圆和矩形连接起来。

效果

源码

// 构造 group、椭圆、直线、矩形 QGraphicsItemGroup *pGroup = new QGraphicsItemGroup(); QGraphicsEllipseItem *pFrom = new QGraphicsEllipseItem(); QGraphicsLineItem *pLink = new QGraphicsLineItem(); QGraphicsRectItem *pTo = new QGraphicsRectItem(); // 设置 group 可选中、可移动 pGroup->setFlags( QGraphicsItem::ItemIsSelectable | QGraphicsItem::ItemIsMovable); // 设置样式（画笔 - 边框色 画刷 - 背景色） QPen pen = pFrom->pen(); pen.setWidth(2); pen.setColor(QColor(0, 160, 230)); pFrom->setPen(pen); pLink->setPen(pen); pTo->setPen(pen); pFrom->setBrush(QColor(247, 160, 57)); pTo->setBrush(QColor(247, 160, 57)); // 将 item 添加至 group pGroup->addToGroup(pFrom); pGroup->addToGroup(pTo); pGroup->addToGroup(pLink); // 设置椭圆、矩形区域 const double length = 50; pFrom->setRect(QRectF(-length/2.0, -length/2.0, length, length)); pTo->setRect(QRectF(-length/2.0, -length/2.0, length, length)); // 设置椭圆、矩形、连接线坐标 pFrom->setPos(80, 80); pTo->setPos(200, 150); pLink->setLine(QLineF(pFrom->pos(), pTo->pos())); // 将 group 添加至场景中 QGraphicsScene *pScene = new QGraphicsScene(); pScene->setSceneRect(0, 0, 300, 200); pScene->addItem(pGroup); // 为视图设置场景 QGraphicsView *pView = new QGraphicsView(); pView->setRenderHint(QPainter::Antialiasing); pView->setScene(pScene); pView->show();

注意： QGraphicsItem 分组比较简单，但在分组之后 group 中的 QGraphicsItem 无法捕获自己的相关事件（例如：鼠标事件、键盘事件），实际接受消息对象为 QGraphicsItemGroup。处理方式请参见：让QGraphicsItemGroup中的item处理自己的事件。

相关资源：QGraphicsItem鼠标大小缩放