Qt 2D绘图之六：图形视图框架的事件处理与传播

一、简介

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

对于鼠标悬停效果，QGraphicsScene会调度悬停事件。如果一个图形项可以接收悬停事件，那么当鼠标进入它的区域之中时，它就会收到一个GraphicsSceneHoverEnter事件。如果鼠标继续在图形项的区域之中进行移动，那么QGraphicsScene就会向该图形项发送GraphicsSceneHoverMove事件。当鼠标离开图形项的区域时，它将会收到一个GraphicsSceneHoverLeave事件。图形项默认是无法接收悬停事件的，可以使用QGraphicsItem类的setAcceptHoverEvents()函数使图形项可以接收悬停事件。

所有的鼠标事件都会传递到当前鼠标抓取的图形项，一个图形项如果可以接收鼠标事件（默认可以）而且鼠标在它的上面被按下，那么它就会成为场景的鼠标抓取的图形项。

二、实例

下面来看一个例子。新建空的Qt项目，名称为myView。完成后先向本项目中添加一个Myltem自定义图形项，然后在myitem.h文件中声明boundingRect()和paint()两个纯虚函数，再声明并定义一个公共的用于设置图形项填充色的函数和变量，最后添加一些事件处理函数的声明，完成后myitem.h文件内容如下：

#ifndef MYITEM_H

#define 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; }

protected:

    //鼠标按下事件处理函数，设置被点击的图形项获得焦点，并改变光标外观

    void mousePressEvent(QGraphicsSceneMouseEvent *event);

    //键盘按下事件处理函数，判断是否是向下方向键，如果是，则向下移动图形项

    void keyPressEvent(QKeyEvent *event);

    //悬停事件处理函数，设置光标外观和提示

    void hoverEnterEvent(QGraphicsSceneHoverEvent *event);

    //右键菜单事件处理函数，为图形项添加一个右键菜单

    void contextMenuEvent(QGraphicsSceneContextMenuEvent *event);

private:

    QColor brushColor; //画刷颜色

};

#endif // MYITEM_H

使用了变量作为画刷的颜色，就可以动态指定图形项的填充色了，默认情况下图形项的填充色设置为红色。

然后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 *option,

                   QWidget *widget)

{

    Q_UNUSED(option); //标明该参数没有使用

    Q_UNUSED(widget);

    //根据图形项是否获得焦点来使用不同颜色绘制图形项的轮廓

    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 *event)

{

    Q_UNUSED(event);

    setFocus();

    setCursor(Qt::ClosedHandCursor);

}

//键盘按下事件处理函数，判断是否是向下方向键，如果是，则向下移动图形项

void MyItem::keyPressEvent(QKeyEvent *event)

{

    //实现视图的下移

    if(event->key() == Qt::Key_Down)

        moveBy(0, 10);

}

//悬停事件处理函数，设置光标外观和提示

void MyItem::hoverEnterEvent(QGraphicsSceneHoverEvent *event)

{

    Q_UNUSED(event);

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

    }

}

在鼠标按下事件处理函数中，为鼠标单击的图形项设置了焦点，这样当按下键盘时该图形项就会接收到按键事件。
然后是键盘按下事件处理函数，如果按下了键盘的向下方向键，那么获得焦点的图形项就会向下移动，这里使用了 moVeBy(qreal dx, qreal dy)函数，它用来进行相对移动，就是相对于当前位置在水平方向移动dx，在垂直方向移动dy。在进行项目移动时，经常使用到该函数。
然后是悬停事件处理函数，如果将鼠标光标移动到一个图形项上，可以看到光标外观改变了，而且出现了工具提示。
然后是右键菜单事件，在一个图形项上右击，就会弹出一个菜单，如果选中该菜单，那么图形项会移动到场景原点。

然后myview.h文件修改如下：

#ifndef MYVIEW_H

#define MYVIEW_H

#include <QGraphicsView>

class MyView : public QGraphicsView

{

    Q_OBJECT

public:

    explicit MyView(QWidget *parent = 0);

protected:

	//键盘按下事件处理函数

    void keyPressEvent(QKeyEvent *event);

signals:

public slots:

};

#endif // MYVIEW_H

然后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类的keyPressEvent()函数，不然在场景或者图形项中就无法再接收到该事件了。

最后修改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();

}