图形视图框架提供了一个基于图形项的模型视图编程方法，主要由场景、视图和图形项三部分组成，这三部分分别由QGraphicsScene、QGraphicsView和QGraphicsItem这三个类来表示。

场景QGraphicsScene

QGraphicsScene类提供绘图场景（Scene）。场景是不可见的，是一个抽象的管理图形项的容器，可以向场景添加图形项，获取场景中的某个图形项等。

场景具有以下功能：

• 提供用于管理大量图形项的高速接口函数
• 传播事件到每个图形项spa
• 管理图形项的状态，好比选择和处理焦点设计
• 提供无变换的渲染功能，主要用于打印3d

一个场景分为3层：图形项层（ItemLayer）、前景层(ForegroundLayer)、背景层(BackgroundLayer)。场景的绘制老是从背景层开始，而后是图形项层，最后是前景层。前景层和背景层均可以使用QBrush进行填充，好比使用渐变和贴图等，也可以通过重新实现drawBackground()和drawForeground()函数来实现自定义的背景和前景。

可以通过**QGraphicsScene::addItem()可以添加一个图元到场景中。图元可以通过多个函数进行检索。通过QGraphicsScene::items()**和一些重载函数可以返回和点、矩形、多边形或向量路径相交的所有图元。**QGraphicsScene::itemAt()**返回指定点的最顶层图元。

QGraphicsScene scene;
QGraphicsRectItem *rect = scene.addRect(QRectF(0, 0, 100, 100))
QTransform transform;;
QGraphicsItem *item = scene.itemAt(50, 50, transform);
// item == rect

QGraphicsScene的事件传播体系结构安排将场景事件传递到项目，并管理项目之间的传播。如果场景在某个位置接收到鼠标按下事件，则场景将事件传递到该位置的任何项目。

类方法

视图QGraphicsView

QGraphicsView提供了视图部件，它用来使场景中的内容可视化。
能够链接多个视图到同一个场景来为相同的数据集提供多个视口。视图部件是一个可滚动的区域，它提供了一个滚动条来浏览大的场景。
视图接收键盘和鼠标输入并转换为场景事件，并进行坐标转换后传送给可视场景。

QGraphicsScene scene;
myPopulateScene(&scene);
QGraphicsView view(&scene);
view.show();

类方法

图形项QGraphicsItem

QGraphicsItem就是一些基本的图形元件，是所有图形项的基类。

• QGraphicsEllipseItem 提供椭圆项
• QGraphicsLineItem 提供直线项
• QGraphicsPathItem 提供任意路径项
• QGraphicsPixmapItem 提供pixmap项
• QGraphicsPolygonItem 提供多边形项
• QGraphicsRectItem 提供矩形项
• QGraphicsSimpleTextItem 提供简单的文本标签项
• QGraphicsTextItem 提供高级文本浏览器项
  
  可以通过调用setVisible()来设置项是否应可见(即，绘制和接受事件)。隐藏项目也会隐藏其子项。同样，可以通过调用setEnabled()来启用或禁用项。如果禁用某个项目，它的所有子项也将被禁用。默认情况下，项目既可见又启用。若要切换是否选择项，请首先通过设置itemIsSelectable标志启用选择，然后调用setSelected()。通常，选择由场景切换，这是用户交互的结果。

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);
      }
  };

QGraphicsItem还支持以下功能：

• 支持鼠标事件响应，包括鼠标按下、移动、释放和双击事件，以及鼠标悬停事件、滚轮事件和上下文菜单事件；
• 键盘输入焦点和按键事件；
• 支持拖放操作；
• 分组，通过父子关系，通过QGraphicsItemGroup；
• 碰撞检测

碰撞检测有两种方式：

• 重载shape()返回项的准确形状，并依赖collapsWithItem()的默认实现来进行形状交集。如果形状复杂的话，这可能会很贵(指性能消耗)。
• 重载collistWithItem()提供自己的自定义项和形状冲突算法。

可以调用contains()函数来确定项是否包含点。此函数也可以由项重新实现。contains()的默认行为基于调用shape()。

主要函数功能说明

参考：https://blog.csdn.net/kenfan1647/article/details/116991074

坐标系统

QGraphicsView有三个有效的坐标系，图形坐标，场景坐标，视图坐标。场景坐标等价于QPainter的逻辑坐标，一般以场景的中心为原点；视图坐标与设备坐标相同，是物理坐标，缺省以左上角为原点；图形项坐标是局部逻辑坐标，一般以图件的中心为原点。

图形项坐标

图形项使用自己的局部坐标（Item Coordinates）,通常以其中心为（0,0），也是各种坐标变换的中心。图形项的鼠标事件的坐标是用局部坐标表示的，创建自定义图形项，绘制图形项时只需要考虑其局部坐标，QGaphicsScene和QGraphicsView会自动进行坐标转换。

一个图形项的位置是其中心点在父坐标系统中的坐标，对于没有父图形项的图形项，其父对象就是场景，图形项的位置就是在场景中的坐标。如果一个图形项的位置还是其他图形项的父项，父项进行坐标变化时，子项也做同样的坐标变换。

视图坐标

视图坐标（view Coordinates)就是窗口界面的物理坐标，单位是像素。视图坐标只与widget或视口有关，而与观察的场景无关。QGraphicsView视口的左上角坐标总是(0,0)。

所有的鼠标事件，拖放事件的坐标是由视图坐标定义的，然后用户需要讲这些坐标映射为场景坐标，以便和图形交互。

场景坐标

场景是所有图形项的基础坐标，场景坐标描述了每个顶层图形项的位置创建场景时可以定义场景矩形区的坐标范围，例如：
scene=new QGraphicsScene(-400,-300,800,600);这样定义的scene是左上角坐标为（-400，-300），宽度为800，高度为600的矩形区域，单位是像素。

每个图形项在场景里都有一个位置坐标，由函数QGraphicsItem::scenePos()给出；还有一个图形项边界矩形，由QGraphicsItem::sceneBoundingRect()函数给出。边界矩形可以使QGraphicsScene::changed()信号，参数是一个场景的矩形列表，表示发生变化的矩形区。

坐标映射

在场景中操作图形项时，进行场景到图形项，图形项到图形项，或视图到场景之间的坐标变换是比较有用的，即坐标映射（Coordinate Mapping).例如，在QGraphicsView的视口上单击鼠标时，通过函数QGraphicsView::mapToScene()可以将视图坐标映射为场景坐标，然后用QGraphicsScene::itemAt()函数可以获取场景中鼠标光标处的图形项。

事件处理与传播

图形视图框架中的事件都是先由视图进行接收，而后传递给场景，再由场景传递给相应的图形项。而对于键盘事件，它会传递给得到焦点的图形项，可使用QGraphicsScene类的setFocusItem（）函数或者图形项自身调用setFocus（）函数来设置焦点图形项。默认的，若是场景没有得到焦点，那么全部的键盘事件都会被丢弃。场景中的图形项得到了焦点，场景也会自动得到焦点。

对于鼠标悬停效果，QGraphicsScene会发送悬停事件。如果一个项接受悬停事件(请参见QGraphicsItem::acceptHoverEvents())，则当鼠标进入其区域时，它将收到一个QGaphicsSceneHoverCenter事件。当鼠标继续在项目区域内移动时，QGraphicsScene将向其发送GraphicsSceneHoverMove事件。当鼠标离开项目区域时，项目将收到一个GraphicsSceneHoverLeave事件。

• contextMenuEvent()处理上下文菜单事件。
• focusInEvent()和focusOutEvent()处理焦点进入和退出事件。
• hoverEnterEvent()、hoverMoveEvent()和hoverLeaveEvent()处理hoverEnter、move和leave事件。
• inputMethodEvent()处理输入事件，以获得辅助功能支持，如中文输入法获取输入内容。
• keyPressEvent()和keyReleaseEvent()处理按键和释放事件。
• mousePressEvent()、mouseMoveEvent()、mouseReleaseEvent()和 mouseDoubleClickEvent()处理鼠标按下、移动、释放、单击和双击事件。

示例：
main.cpp

#include <QApplication>
#include "myitem.h"
#include "myview.h"
#include <QTime>

int main(int argc, char* argv[ ])
{ 
   
    QApplication app(argc, argv);
    qsrand(QTime(0, 0, 0).secsTo(QTime::currentTime()));
    QGraphicsScene scene;
    scene.setSceneRect(-200, -150, 400, 300);

    for (int i = 0; i < 5; ++i) { 
   
        MyItem *item = new MyItem;
        item->setColor(QColor(qrand() % 256, qrand() % 256, qrand() % 256));
        item->setPos(i * 50 - 90, -50);
        scene.addItem(item);
    }

    MyView view;
    view.setScene(&scene);
    view.setBackgroundBrush(QPixmap("../myView/background.png"));
    view.show();
    return app.exec();
}

myitem.h

#include <QGraphicsItem>

class MyItem : public QGraphicsItem
{ 
   
public:
    MyItem();
    QRectF boundingRect() const;
    void paint(QPainter *painter, const QStyleOptionGraphicsItem *option,
               QWidget *widget);

    void setColor(const QColor &color) { 
    brushColor = color; }

private:
    QColor brushColor;

protected:
    void keyPressEvent(QKeyEvent *event);
    void mousePressEvent(QGraphicsSceneMouseEvent *event);
    void hoverEnterEvent(QGraphicsSceneHoverEvent *event);
    void contextMenuEvent(QGraphicsSceneContextMenuEvent *event);

};

myitem.cpp

#include "myitem.h"
#include <QPainter>
#include <QCursor>
#include <QKeyEvent>
#include <QGraphicsSceneHoverEvent>
#include <QGraphicsSceneContextMenuEvent>
#include <QMenu>

MyItem::MyItem()
{ 
   
    brushColor = Qt::red;

    setFlag(QGraphicsItem::ItemIsFocusable);
    setFlag(QGraphicsItem::ItemIsMovable);
    setAcceptHoverEvents(true);

}

QRectF MyItem::boundingRect() const
{ 
   
    qreal adjust = 0.5;
    return QRectF(-10 - adjust, -10 - adjust,
                  20 + adjust, 20 + adjust);
}

void MyItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *,
                   QWidget *)
{ 
   
    if (hasFocus()) { 
   
        painter->setPen(QPen(QColor(255, 255, 255, 200)));
    } else { 
   
        painter->setPen(QPen(QColor(100, 100, 100, 100)));
    }
    painter->setBrush(brushColor);
    painter->drawRect(-10, -10, 20, 20);
}

// 鼠标按下事件处理函数，设置被点击的图形项得到焦点，并改变光标外观
void MyItem::mousePressEvent(QGraphicsSceneMouseEvent *)
{ 
   
    setFocus();
    setCursor(Qt::ClosedHandCursor); //设置光标为手握下的形状
}

// 键盘按下事件处理函数，判断是不是向下方向键，若是是，则向下移动图形项
void MyItem::keyPressEvent(QKeyEvent *event)
{ 
   
    if (event->key() == Qt::Key_Down)
        moveBy(0, 10);
}
// 悬停事件处理函数，设置光标外观和提示
void MyItem::hoverEnterEvent(QGraphicsSceneHoverEvent *)
{ 
   
    setCursor(Qt::OpenHandCursor); //设置光标为手张开的形状
    setToolTip("I am item");
}
// 右键菜单事件处理函数，为图形项添加一个右键菜单
void MyItem::contextMenuEvent(QGraphicsSceneContextMenuEvent *event)
{ 
   
    QMenu menu;
    QAction *moveAction = menu.addAction("move back");
    QAction *selectedAction = menu.exec(event->screenPos());
    if (selectedAction == moveAction) { 
   
        setPos(0, 0);
    }
}

myview.h

#include <QGraphicsView>

class MyView : public QGraphicsView
{ 
   
    Q_OBJECT
public:
    explicit MyView(QWidget *parent = 0);
protected:
    void keyPressEvent(QKeyEvent *event);

};

myview.cpp

#include "myview.h"
#include <QKeyEvent>

MyView::MyView(QWidget *parent) :
    QGraphicsView(parent)
{ 
   
}

void MyView::keyPressEvent(QKeyEvent *event)
{ 
   
    switch (event->key())
    { 
   
    case Qt::Key_Plus :
        scale(1.2, 1.2);
        break;
    case Qt::Key_Minus :
        scale(1 / 1.2, 1 / 1.2);
        break;
    case Qt::Key_Right :
        rotate(30);
        break;
    }
    QGraphicsView::keyPressEvent(event);//必定要加上这个，不然在场景和图形项中就没法再接收到该事件了
}

今天的文章QGraphicsView,QGraphicsScene和QGraphicsItem分享到此就结束了，感谢您的阅读。