一、简述

在图形视图框架中，QGraphicsScene 提供一个快速的接口，用于管理大量 item，QGraphicsItem 是场景中 item 的基类。

图形视图提供了一些典型形状的标准 item，当然，我们也可以自定义 item。除此之外，QGraphicsItem 还支持以下特性：

  • 鼠标按下、移动、释放和双击事件，以及鼠标悬浮事件、滚轮事件和上下文菜单事件
  • 键盘输入焦点和键盘事件
  • 拖放
  • 分组：通过父子关系，或 QGraphicsItemGroup
  • 碰撞检测

下面，一起来看看 QGraphicsScene 对 QGraphicsItem 的管理，主要包括：单击、选择、移动、缩放、删除等。

为了实现以上功能，我们主要实现了 QGraphicsScene 和 QGraphicsItem 对应的事件，通过鼠标和键盘来操作。


操作细节主要包括：

  • 选择：点击左键、按 Shift 键可以单选，按下 Ctrl 可进行多选。
  • 添加：点击左键
  • 删除：点击右键，删除鼠标下的 item；当按下 Ctrl 选择多个 items 时，按下 Backspace 键，将选中的全部删除。
  • 移动：点击左键，选择 item，然后移动鼠标；当按下 Ctrl 选择多个 items 时，可以移动选中的 items。
  • 缩放：按 Alt 键，然后鼠标拖拽 item 的边界。

在对应操作的事件中，我们输出了一些调试信息，以便跟踪。

二、示例

image.png
main.cpp

  1. #include "widget.h"
  2. #include <QApplication>
  3. #include <QGraphicsView>
  5. int main(int argc, char* argv[])
  6. {
  7.     QApplication a(argc, argv);
  9.     // 创建 item
  10.     CustomItem* pItem = new CustomItem();
  11.     pItem->setRect(20, 20, 60, 60);
  13.     // 将 item 添加至场景中
  14.     CustomScene scene;
  15.     scene.setSceneRect(0, 0, 400, 300);
  16.     scene.addItem(pItem);
  18.     // 为视图设置场景
  19.     QGraphicsView view;
  20.     view.setScene(&scene);
  21.     view.show();
  23.     return a.exec();
  24. }

widget.h

  1. #ifndef CUSTOM_ITEM_H
  2. #define CUSTOM_ITEM_H
  4. #include <QGraphicsRectItem>
  5. #include <QGraphicsScene>
  7. //QGraphicsScene管理QGraphicsItem（单击/选择/移动/缩放/删除）
  8. // 自定义 Item
  9. class CustomItem : public QGraphicsRectItem {
  10. public:
  11.     explicit CustomItem(QGraphicsItem* parent = 0);
  13. protected:
  14.     // Shift+左键：进行选择  Alt：准备缩放
  15.     void mousePressEvent(QGraphicsSceneMouseEvent* event);
  16.     // Alt+拖拽：进行缩放  移动
  17.     void mouseMoveEvent(QGraphicsSceneMouseEvent* event);
  18.     void mouseReleaseEvent(QGraphicsSceneMouseEvent* event);
  19.     // 使item可使用qgraphicsitem_cast
  20.     int type() const;
  22. private:
  23.     QPointF m_centerPointF;
  24.     bool m_bResizing;
  25. };
  27. // 自定义 Scene
  28. class CustomScene : public QGraphicsScene {
  29. protected:
  30.     // 左键：添加item  右键：移除item
  31.     void mousePressEvent(QGraphicsSceneMouseEvent* event);
  32.     void mouseMoveEvent(QGraphicsSceneMouseEvent* event);
  33.     // Backspace键移除item
  34.     void keyPressEvent(QKeyEvent* event);
  35. };
  37. #endif // CUSTOM_ITEM_H

widget.cpp

  1. #include "widget.h"
  2. #include <QDebug>
  3. #include <QGraphicsSceneMouseEvent>
  4. #include <QKeyEvent>
  5. #include <QtMath>
  7. // 自定义 Item
  8. CustomItem::CustomItem(QGraphicsItem* parent)
  9.     : QGraphicsRectItem(parent)
  10. {
  11.     // 画笔 - 边框色
  12.     QPen p = pen();
  13.     p.setWidth(2);
  14.     p.setColor(QColor(0, 160, 230));
  16.     setPen(p);
  17.     // 画刷 - 背景色
  18.     setBrush(QColor(247, 160, 57));
  20.     // 可选择、可移动
  21.     setFlags(QGraphicsItem::ItemIsSelectable | QGraphicsItem::ItemIsMovable);
  22. }
  24. void CustomItem::mousePressEvent(QGraphicsSceneMouseEvent* event)
  25. {
  26.     if (event->button() == Qt::LeftButton) {
  27.         if (event->modifiers() == Qt::ShiftModifier) {
  28.             qDebug() << "Custom item left clicked with shift key.";
  29.             // 选中 item
  30.             setSelected(true);
  31.         } else if (event->modifiers() == Qt::AltModifier) {
  32.             qDebug() << "Custom item left clicked with alt key.";
  33.             // 重置 item 大小
  34.             double radius = boundingRect().width() / 2.0;
  35.             QPointF topLeft = boundingRect().topLeft();
  36.             m_centerPointF = QPointF(topLeft.x() + pos().x() + radius, topLeft.y() + pos().y() + radius);
  37.             QPointF pos = event->scenePos();
  38.             qDebug() << boundingRect() << radius << this->pos() << pos << event->pos();
  39.             double dist = sqrt(pow(m_centerPointF.x() - pos.x(), 2) + pow(m_centerPointF.y() - pos.y(), 2));
  40.             if (dist / radius > 0.8) {
  41.                 qDebug() << dist << radius << dist / radius;
  42.                 m_bResizing = true;
  43.             } else {
  44.                 m_bResizing = false;
  45.             }
  46.         } else {
  47.             qDebug() << "Custom item left clicked.";
  48.             QGraphicsItem::mousePressEvent(event);
  49.             event->accept();
  50.         }
  51.     } else if (event->button() == Qt::RightButton) {
  52.         qDebug() << "Custom item right clicked.";
  53.         event->ignore();
  54.     }
  55. }
  57. void CustomItem::mouseMoveEvent(QGraphicsSceneMouseEvent* event)
  58. {
  59.     if ((event->modifiers() == Qt::AltModifier) && m_bResizing) {
  60.         QPointF pos = event->scenePos();
  61.         double dist = sqrt(pow(m_centerPointF.x() - pos.x(), 2) + pow(m_centerPointF.y() - pos.y(), 2));
  62.         setRect(m_centerPointF.x() - this->pos().x() - dist, m_centerPointF.y() - this->pos().y() - dist, dist * 2, dist * 2);
  63.     } else if (event->modifiers() != Qt::AltModifier) {
  64.         qDebug() << "Custom item moved.";
  65.         QGraphicsItem::mouseMoveEvent(event);
  66.         qDebug() << "moved" << pos();
  67.     }
  68. }
  70. void CustomItem::mouseReleaseEvent(QGraphicsSceneMouseEvent* event)
  71. {
  72.     if ((event->modifiers() == Qt::AltModifier) && m_bResizing) {
  73.         m_bResizing = false;
  74.     } else {
  75.         QGraphicsItem::mouseReleaseEvent(event);
  76.     }
  77. }
  79. int CustomItem::type() const
  80. {
  81.     return UserType + 1;
  82. }
  84. // 自定义 Scene
  85. void CustomScene::mousePressEvent(QGraphicsSceneMouseEvent* event)
  86. {
  87.     qDebug() << "Custom scene clicked.";
  88.     QGraphicsScene::mousePressEvent(event);
  89.     if (!event->isAccepted()) {
  90.         if (event->button() == Qt::LeftButton) {
  91.             // 在 Scene 上添加一个自定义 item
  92.             QPointF point = event->scenePos();
  93.             CustomItem* item = new CustomItem();
  94.             item->setRect(point.x() - 25, point.y() - 25, 60, 60);
  95.             addItem(item);
  96.         } else if (event->button() == Qt::RightButton) {
  97.             // 检测光标下是否有 item
  98.             QGraphicsItem* itemToRemove = NULL;
  99.             foreach (QGraphicsItem* item, items(event->scenePos())) {
  100.                 if (item->type() == QGraphicsItem::UserType + 1) {
  101.                     itemToRemove = item;
  102.                     break;
  103.                 }
  104.             }
  105.             // 从 Scene 上移除 item
  106.             if (itemToRemove != NULL)
  107.                 removeItem(itemToRemove);
  108.         }
  109.     }
  110. }
  112. void CustomScene::mouseMoveEvent(QGraphicsSceneMouseEvent* event)
  113. {
  114.     qDebug() << "Custom scene moved.";
  115.     QGraphicsScene::mouseMoveEvent(event);
  116. }
  118. void CustomScene::keyPressEvent(QKeyEvent* event)
  119. {
  120.     if (event->key() == Qt::Key_Backspace) {
  121.         // 移除所有选中的 items
  122.         qDebug() << "selected items " << selectedItems().size();
  123.         while (!selectedItems().isEmpty()) {
  124.             removeItem(selectedItems().front());
  125.         }
  126.     } else {
  127.         QGraphicsScene::keyPressEvent(event);
  128.     }
  129. }

Study_QGraphicsSimpleTextItem.zip