QT学习笔记4：QT中GraphicsView编程

一、QGraphicsScene

1、QGraphicsScene

QGraphicsScene继承自QObject，是一个管理图元的容器，与QGraphicsView合用可以在2D屏幕上显示如线、三角形、文本、自定义图元等图元。

QGraphicsScene是不可见的，只用于管理图元。为了查看场景，需要创建一个视图组件。

一个场景分为三个层：图元层、前景层和背景层。场景的绘制总是从背景层开始，然后是图形项层，最后是前景层。

2、事件处理与传播

    QGraphicsScene的责任之一是传播来自视图的事件。要发送一个事件到场景，需要构造一个继承自QEvent的事件，使用QApplication::sendEvent()函数发送事件。event()函数负责派发事件到各个图元。常用的事件会被便利事件处理函数处理，如鼠标按下事件会被mousePressEvent()函数处理。

    按键事件会被派发到焦点图元。为了设置焦点图元，可以调用setFocusItem()函数，或是图元自身调用QGraphicsItem::setFocus()函数。调用focusItem()函数可以获取当前的焦点图元。为了兼容图形组件，场景维护着自己的焦点信息。默认场景并没有焦点，并且所有的按键事件会别丢弃。如果setFocus()函数被调用，或是场景中一个图元获得了焦点，场景会自动获得焦点。如果场景有焦点，hasFocus()函数会返回true，按键事件会被发送到焦点图元。如果场景失去了焦点，而图元有焦点(如调用clearFocus()函数)，场景会维护图元的焦点信息，一旦场景重新获得焦点，会确保最后一个有焦点的图元获得焦点。

    对于悬停效果，QGraphicsScene会派发悬停事件，如果某个图元接受了悬停事件（调用QGraphicsItem::acceptHoverEvents()），当鼠标进入图元的区域时，图元会接收到一个GraphicsSceneHoverEnter事件。当鼠标继续在图元内部移动时，QGraphicsScene会发送GraphicsSceneHoverMove事件。当鼠标离开图元的区域时，图元会收到一个GraphicsSceneHoverLeave事件。

    所有鼠标事件会被传播到当前鼠标获取的图元。如果一个图元接收了鼠标事件，并收到鼠标按下，图元就是场景的鼠标获取图元。这个图元会一直被鼠标获取，直到图元收到一个鼠标释放事件。调用mouseGrabberItem()函数可以知道当前鼠标获取的图元。

场景可以传递来自视图的事件，将事件传递给该点最顶层的图元。如果一个图元要接收键盘事件，那么它必须获得焦点。而且，如果在场景中重写了事件处理函数，那么在该函数的最后必须调用场景默认的事件处理函数，只有这样，图元才能接收到该事件。

A、拖拽事件

[virtual protected] void dragEnterEvent(QGraphicsSceneDragDropEvent *event)//拖入事件处理函数

[virtual protected] void dragLeaveEvent(QGraphicsSceneDragDropEvent *event)//拖离事件梳理函数

[virtual protected] void dragMoveEvent(QGraphicsSceneDragDropEvent *event)//拖动事件处理函数

[virtual protected] void dropEvent(QGraphicsSceneDragDropEvent *event)//Drop事件处理函数

//在以上拖拽事件处理函数中的末尾需要调用QGraphicsScene类相应的事件处理函数。

QGraphicsScene::dragEnterEvent(event);

QGraphicsScene::dragLeaveEvent(event);

QGraphicsScene::dragMoveEvent(event);

QGraphicsScene::dropEvent(event);

 

B、鼠标事件

[virtual protected] void mouseMoveEvent(QGraphicsSceneMouseEvent *mouseEvent)//鼠标移动处理函数

[virtual protected] void mousePressEvent(QGraphicsSceneMouseEvent *mouseEvent)//鼠标按下处理函数

[virtual protected] void mouseReleaseEvent(QGraphicsSceneMouseEvent *mouseEvent)//鼠标释放处理函数

//在以上鼠标事件处理函数中的末尾需要调用QGraphicsScene类相应的事件处理函数。

QGraphicsScene::mouseMoveEvent(event);

QGraphicsScene::mousePressEvent(event);

QGraphicsScene::mouseReleaseEvent(event);

 

3、索引算法

    索引算法，是指在场景中进行图元查找的算法。QGraphicsScene中提供了两种选择，在一个枚举变量QGraphicsScene::ItemIndexMethod中定义，分别是：

    QGraphicsSecne::BspTreeIndex ：应用Binary Space Partition tree，适合于大量的静态图元，是默认值。

    QGraphicsScene::NoIndex ：不用索引，搜索场景中所有的图元，适合于经常进行图元的添加、移动和删除等操作的情况。

    使用setItemIndexMethod()函数进行索引算法的更改。

4、边界矩形

    图元可以放到场景的任何位置，场景的大小默认是没有限制的。而场景的边界矩形仅用于场景内部进行索引的维护。因为如果没有边界矩形，场景就要搜索所有的图元，然后确定出其边界，这是十分费时的。所以如果要操作一个较大的场景，应该给出它的边界矩形。

    设置边界矩形，可以使用setSceneRect()函数。

5、图元的查找

    场景最大的优势之一就是可以快速的锁定图元的位置，即使有上百万个图元，items()函数也能在数毫秒的时间内锁定一个图元的位置。items()函数有几个重载函数来方便的进行图元的查找。如果在场景的一个点可能重叠着几个图元，可以使用itemAt()函数返回最上面的一个图元。

二、QGraphicsItem

1、自定义QGraphicsItem

    QGraphicsItem是图元的基类。

    自定义图元，首先应该继承QGraphicsItem,然后重写他的两个纯虚公共函数boundingRect()和paint()，boundingRect()函数返回绘制图元大概的区域，paint()函数用来绘制图元内容。

    boundingRect()函数有很多用处，场景在boundingRect()来建立它的图元的index，视图使用boundingRect来剪切可见的图元，在重新绘制图元时候，来决定相互重叠的部分，此外，图元的碰撞检测机制也使用的boundingRect()来提供一个高效的定点，在collidesWithItem()更好的碰撞算法建立在调用函数shape(),shape()函数以QpainterPath类型返回图元的精准的轮廓。

    场景不希望图元的boundingRect()和shape()变化，除非该图元被通告，如果想通过一些方法改变图元的形状，首先应该调用QgraphicsScene()来允许场景QgraphicsScene来刷新它的图元记录。

    图元没有获得焦点时，事件只能从视图传递到场景，不能传递到图元。清除图元的焦点函数为clearFocus（）。

2、绘制

    paint()函数被QgrapicsView类调用来绘制图元的内容，图元默认是没有背景或者填充颜色的。在函数中没有被绘制的所有区域都将会发亮，可以调用update（）来重绘图元，可以选择传递需要重绘的矩形区域（不是必须的）。取决于图元在视图中是否可见，图元可能会也可能不会重绘，QgraphicsItem里面没有和 Qwidget::repaint()函数等价的图元通过视图来绘制，从父类图元开始，然后是图元自身，以上升的栈的顺序，可以通过调用setZValue()设置图元的栈顺序，通过zValue()来测试，具有低z-values的图元比具有高z-value 的图元先绘制，栈顺序应用于兄弟图元，父类图元总是比子类图元更早绘制。

3、排序

    所有的图元都按照一个已经声明的稳定的顺序来绘制，声明的顺序决定了当在场景中点击鼠标时候，哪个图元最先接受鼠标的输入。通常情况下，不需要担心图元排序的问题，因为所有的图元都按照一个在场景中声明的自然的顺序。
    在一个栈中，子类图元在父类图元的上面，兄弟图元按照插入场景的顺序来入栈，如果你先添加图元A ，然后是图元B，然后是图元C ，栈中的顺序从下往上就是A、B、C。可以调用setZvalue()来设置一个图元的相对于另一个图元向上、向下或者兄弟栈顺序。默认的Z值是0，具有同样的Z值的图元会按照插入的顺序来入栈。可以调用stackBefore()来备份子类图元的列表，直接更正图元的顺序。
    如果想让子类图元在父类图元的后面，也就是先绘制子类图元，然后再绘制父类图元。可以利用函数setFlag()设置ItemStacksBehindParent属性给图元。

4、事件处理

    QgraphicsItem从场景中通过sceneEvent()函数来接受事件，sceneEvent()函数通过一些方便的操作分散大部分事件。

    ContextMenuEvent()函数接受上下文菜单事件， FocusInEvent()和focusOutEvent()函数接受焦点进出事件， hoverEnterEvent()、hoverMoveEvent()、hoverLeaveEvent() 接受鼠标悬浮移动和离开事件。 

    inputMethodEvent()函数处理输入法事件，keyPressEvent()和keyReleaseEvent()事件处理键盘按下和释放事件。

    mousePressEvent()、mouseMoveEvent()、mouseReleaseEvent()、   mouseDoubleClickEvent()处理鼠标按下、移动、释放、双击事件。

    通过安装过滤器，可以为图元过滤一些事件，与QT一般的事件过滤器不一样，一般的过滤器只工作在Qobject及其子类。通过调用 installSceneEventFilter()为图元安装事件过滤器后，被过滤的事件将会被虚函数sceneEventFilter()捕捉 到，可以通过调用函数removeSceneEventFilter()来去除掉事件过滤器。<