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

时间:2022-06-27 22:13:39

一、简介

图形视图框架中的事件都是首先由视图进行接收,然后传递给场景,再由场景传递给相应的图形项。而对于键盘事件,它会传递给获得焦点的图形项,可以使用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();
}

这里在场景中添加了 5个图形项,分别为它们设置了随机颜色,然后将它们排成一行。可以使用键盘上的“ + ”和“-”键来放大和缩小视图,也可以使用向右方向键来旋转视图。


三、效果

执行程序,最初的效果如下:

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


按右方向键后,旋转视图后:

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


鼠标拖动图形项后:

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