Qt事件系统

在Qt中，事件作为一个对象，继承自QEvent类，常见的有键盘事件QKeyEvent、鼠标事件QMouseEvent和定时器事件QTimerEvent等。以下内容主要讲解3个常见的事件，会涉及事件过滤器、自定义事件和随机数的知识。相关内容请各位亲在Qt帮助文档中查看The Event System关键字。

事件是对各种应用程序需要知道的由应用程序内部或者外部产生的事情或者动作的通称。在Qt中使用一个对象来表示一个事件，继承自QEvent类。同时，事件与信号并不相同，信号是继事件产生而已产生的，比如单击一下界面上的按钮，那么就会产生鼠标事件QMouseEvent(不是按钮产生的)，而因为按钮被按下了，所以会发出clicked()单击信号(是按钮产生的)。对于事件，只有重绘按钮或者产生其他效果的时候，才有必要去关心鼠标事件。所以，事件与信号是两个不同层面的东西，发出者不同，作用也不同。在Qt中，任何QObject子类实例都可以接收和处理事件。

1、事件的处理

一个事件由一个特定的QEvent子类来表示，但是有时一个事件又包含多个事件类型，比如鼠标事件又可以分为鼠标按下、双击和移动等多种操作。这些事件类型都由QEvent类的枚举类型QEvent::Type来表示，其中包含了一百多种事件类型，可以在QEvent类的帮助文档中查看。虽然QEvent的子类可以表示一个事件，但是却不能用来处理事件，只能通过QCoreApplication类的notify()函数的帮助文档处给出了5种处理事件的方法：

方法一：重新实现部件的paintEvent()、mousePressEvent()等事件处理函数。这是最常用的一种方法，不过它只能用来处理特定部件的特定事件。

方法二：重新实现notify()函数。这个函数功能强大，提供了完全的控件，可以再事件过滤器得到事件之前就获得它们。但是，它一次只能处理一个事件。

方法三：向QApplication对象上安装事件过滤器。因为一个程序只有一个QApplication对象，所以这样实现的功能与使用notify()函数是相同的，优点是可以同时处理多个事件。

方法四：重新实现event()函数。QObject类的event()函数可以在事件到达默认的事件处理函数之前获得该事件。

方法五：在对象上安装事件过滤器。使用事件过滤器可以在一个界面类中同时处理不同子部件的不同事件。

在实际的编程中，最常用的是方法一，其次是方法五。因为方法二需要继承自QApplication类；而方法三要使用一个全局的事件过滤器，这将减缓事件的传递。所以，虽然这两种方法功能很强大，但是却很少呗用到。

每个程序的main()函数中调用QApplication类的exec()函数，它会使Qt应用程序进入事件循环，这样就可以使应用程序在运行时接收发生的各种事件。在QWidget类的虚函数中，mouseMoveEvent ( QMouseEvent * )，mousePressEvent ( QMouseEvent * )和mouseReleaseEvent ( QMouseEvent * )等虚接口。只要在继承QWidget中的自定义类重载，实现自定义操作。

2、鼠标事件和滚轮事件

QMouseEvent类用来表示一个鼠标事件，通过这个类可以获知鼠标是哪个键按下了、鼠标指针的当前位置等信息。QWheelEvent类用来表示鼠标滚轮事件，通过这个类主要获取滚轮移动的方向和距离。重载QWidget虚函数实现鼠标移动，滚轮，双击，单击和释放事件。函数原型如下：

void mousePressEvent(QMouseEvent *event);//单击(左右)

void mouseReleaseEvent(QMouseEvent *event);//释放(左右)

void mouseDoubleClickEvent(QMouseEvent *event);//双击(左右)

void mouseMoveEvent(QMouseEvent *event);//移动

void wheelEvent(QWheelEvent *event);//滚轮

#include "widget.h"
#include "ui_widget.h"
#include <QMouseEvent>
#include <QDebug>

Widget::Widget(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::Widget)
{
    ui->setupUi(this);

    // 设置鼠标跟踪,只有设置才能在鼠标进入范围内，也可以触发mouseMoveEvent事件(开启与关闭试试效果)
    //setMouseTracking(true);

    // 创建光标对象
    //QCursor cursor;
    // 设置光标形状
    //cursor.setShape(Qt::OpenHandCursor);
    // 使用光标
    //setCursor(cursor);
}

Widget::~Widget()
{
    delete ui;
}

// 鼠标按下事件
void Widget::mousePressEvent(QMouseEvent *event)
{
    // 如果是鼠标左键按下
    if(event->button() == Qt::LeftButton){

        // 使鼠标指针暂时变为小手抓取的样子
        QCursor cursor;
        cursor.setShape(Qt::ClosedHandCursor);
        QApplication::setOverrideCursor(cursor);

        // 获取指针位置和窗口位置的差值，以便移动时使用
        offset = event->globalPos() - pos();
    }

    // 如果是鼠标右键按下
    else if(event->button() == Qt::RightButton){

        // 使用自定义的图片作为鼠标指针
        QCursor cursor(QPixmap("../yafeilinux.png"));
        QApplication::setOverrideCursor(cursor);
    }
}

// 鼠标移动事件
void Widget::mouseMoveEvent(QMouseEvent *event)
{
    qDebug() << tr("Widget的mouseMoveEvent()函数");

    // 这里必须使用buttons()
    if(event->buttons() & Qt::LeftButton){

        // 我们使用鼠标指针当前的位置减去差值，就得到了窗口应该移动的位置
        QPoint temp;
        temp = event->globalPos() - offset;
        move(temp);
    }
}

// 鼠标释放事件
void Widget::mouseReleaseEvent(QMouseEvent *event)
{
    // 恢复鼠标指针形状
    QApplication::restoreOverrideCursor();
}

// 鼠标双击事件
void Widget::mouseDoubleClickEvent(QMouseEvent *event)
{
    // 如果是鼠标左键按下
    if(event->button() == Qt::LeftButton){

        // 如果现在不是全屏，将窗口设置为全屏
        if(windowState() != Qt::WindowFullScreen)
            setWindowState(Qt::WindowFullScreen);

        // 如果现在已经是全屏状态，那么恢复以前的大小
        else setWindowState(Qt::WindowNoState);

    }
}

// 滚轮事件
void Widget::wheelEvent(QWheelEvent *event)
{
    // 当滚轮远离使用者时进行放大，当滚轮向使用者方向旋转时进行缩小
    if(event->delta() > 0){
        ui->textEdit->zoomIn();
    }else{
        ui->textEdit->zoomOut();
    }
}

3、键盘事件
QKeyEvent类用来表示一个键盘事件(键盘按下或者释放)。通过QKeyEvent的key()函数可以获取具体的按键，但获取键盘上的修饰键(如Ctrl和Shift等)要通过QKeyEvent的modifiers()函数来获取。

#include "widget.h"
#include "ui_widget.h"
#include <QKeyEvent>
#include <QDebug>

Widget::Widget(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::Widget)
{
    ui->setupUi(this);

    // 使主界面获得焦点
    setFocus();

    // 初始化变量
    keyUp = false;
    keyLeft = false;
    move = false;
}

Widget::~Widget()
{
    delete ui;
}

// 键盘按下事件
void Widget::keyPressEvent(QKeyEvent *event)
{
    if(event->key() == Qt::Key_Up){

        // 按键重复时不做处理
        if(event->isAutoRepeat()) return;

        // 标记向上方向键已经按下
        keyUp = true;

    }else if(event->key() == Qt::Key_Left){
        if(event->isAutoRepeat()) return;
        keyLeft = true;
    }
}

// 按键释放事件
void Widget::keyReleaseEvent(QKeyEvent *event)
{
    if(event->key() == Qt::Key_Up){
        if(event->isAutoRepeat()) return;

        // 释放按键后将标志设置为false
        keyUp = false;

        // 如果已经完成了移动
        if(move){

            // 设置标志为false
            move = false;
            // 直接返回
            return;
        }

        // 如果向左方向键已经按下且没有释放
        if(keyLeft){

            // 斜移
            ui->pushButton->move(30,80);
            // 标记已经移动
            move = true;

        }else{

            // 否则直接上移
            ui->pushButton->move(120,80);
        }
    }
    else if(event->key() == Qt::Key_Left){
        if(event->isAutoRepeat()) return;
        keyLeft = false;
        if(move){
            move = false;
            return;
        }
        if(keyUp) {
            ui->pushButton->move(30,80);
            move = true;
        }else{
            ui->pushButton->move(30,120);
        }
   }
   // 使用向下方向键来还原按钮的位置
   else if(event->key() == Qt::Key_Down){
            ui->pushButton->move(120,120);
   }
}

4、定时器事件与随机数

QTimerEvent类用来描述一个定时器事件。对于QObject的子类，只需要使用int QObject::startTimer( int interval );函数来开启一个定时器，其返回的整形编号是用来代表这个定时器；而停止定时器可以通过void QObject::killTimer( int id );函数。当定时器溢出时就可以在timerEvent()函数中获取该定时器的编号来进行相关操作。

其实编程中更多的是使用QTimer类来实现一个定时器，它提供了更高层次的编程接口，比如可以使用信号和槽，还可以设置只运行一次的定时器。

关于随机数，在Qt中是使用qrand()和qsrand()两个函数实现的。

#include "widget.h"
#include "ui_widget.h"
#include <QDebug>
#include <QTimer>
#include <QTime>
Widget::Widget(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::Widget)
{
    ui->setupUi(this);

    // 开启一个1秒定时器，返回其ID
    id1 = startTimer(1000);
    id2 = startTimer(2000);
    id3 = startTimer(3000);

    // 创建一个新的定时器
    QTimer *timer = new QTimer(this);
    // 关联定时器的溢出信号到我们的槽函数上
    connect(timer,SIGNAL(timeout()),this,SLOT(timerUpdate()));
    // 设置溢出时间为1秒，并启动定时器
    timer->start(1000);

    // 为随机数设置初值，如果不是设置初值，每次运行qrand()函数都会产生相同的一组随机数
    qsrand(QTime(0,0,0).secsTo(QTime::currentTime()));

    // 开启只运行一次的定时器
    QTimer::singleShot(10000,this,SLOT(close()));
}

Widget::~Widget()
{
    delete ui;
}

void Widget::timerEvent(QTimerEvent *event)
{
    // 判断是哪个定时器
    if(event->timerId() == id1){
        qDebug() << "timer1";
    }
    else if(event->timerId() == id2){
        qDebug() << "timer2";
    }
    else{
        qDebug() << "timer3";
    }
}

// 定时器溢出处理
void Widget::timerUpdate()
{
    // 获取当前时间
    QTime time = QTime::currentTime();
    // 转换为字符串
    QString text = time.toString("hh:mm:ss");

    // 注意单引号间要输入一个空格
    // 每隔一秒就将“：”显示为空格
    if((time.second()%2) == 0) text[2]=' ';
    ui->lcdNumber->display(text);

    // 产生300以内的正整数
    int rand = qrand()%300;
    ui->lcdNumber->move(rand,rand);
}

5、事件过滤器与事件的发送

Qt提供了事件过滤器来在一个部件中监控其他多个部件的事件。事件过滤器与其他部件不同，它不是一个类，只是由installEventFilter()和eventFilter()两个函数组成的一种操作，用来完成一个部件对其他部件的事件的监视。

#include "widget.h"
#include "ui_widget.h"
#include <QKeyEvent>
#include <QWheelEvent>
Widget::Widget(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::Widget)
{
    ui->setupUi(this);

    // 为编辑器部件在本窗口上安装事件过滤器
    ui->textEdit->installEventFilter(this);
    ui->spinBox->installEventFilter(this);

    QKeyEvent myEvent(QEvent::KeyPress,Qt::Key_Up,Qt::NoModifier);

    // 发送键盘事件到spinBox部件
    //qApp->sendEvent(ui->spinBox,&myEvent);

    //sendEvent中的QEvent对象参数在事件发送完成后无法自动删除，所以需要在栈中创建QEvent对象；
    //而postEvent中的QEvent对象参数必须在堆中进行创建(new)，当事件被发送后事件队列会自动删除它
    QApplication::sendEvent(ui->spinBox,&myEvent);
}

Widget::~Widget()
{
    delete ui;
}

// 事件过滤器
bool Widget::eventFilter(QObject *obj, QEvent *event)
{
    // 判断部件
    if(obj == ui->textEdit){

        // 判断事件
        if(event->type() == QEvent::Wheel){

            // 将event强制转换为发生的事件的类型
            QWheelEvent *wheelEvent = static_cast<QWheelEvent*>(event);
            if(wheelEvent->delta() > 0) ui->textEdit->zoomIn();
            else ui->textEdit->zoomOut();

            // 该事件已经被处理
            return true;

        }else{

            // 如果是其他事件，可以进行进一步的处理
            // 让其他部件去处理
            return false;
        }
    }
    else if(obj == ui->spinBox){
        if(event->type() == QEvent::KeyPress){
            QKeyEvent *keyEvent = static_cast<QKeyEvent*>(event);
            if(keyEvent->key() == Qt::Key_Space){
                ui->spinBox->setValue(0);
                return true;
            }else{
                return false;
            }
        }else{
            return false;
        }
    }
    else return QWidget::eventFilter(obj,event);
}