一、QMouseEvent的详细描述

首先请注意,Qt中的QMouseEvent一般只涉及鼠标左键或右键的单击、释放等操作,而对 鼠标滚轮的响应则通过QWheeEvent来处理。

QMouseEvent类包含了用于描述鼠标事件的参数。

当在一个窗口里按住鼠标按键、或移动、或释放就会产生鼠标事件QMouseEvent。

鼠标移动事件只会在按下鼠标按键的情况下才会发生,除非通过显式调用QWidget::setMouseTracking()函数来开启鼠标轨迹,这种情况下只要鼠标指针在移动,就会产生一系列的 QT 鼠标事件;

在一个窗口中,当鼠标按键被按下时,QT会自动捕捉鼠标轨迹,鼠标指针所在的父窗口会继续接受鼠标事件,直到最后一个鼠标按键被释放。

二、QMouseEvent的传递

一个鼠标事件包含一些指定的接受标志flag用于指出该事件是否会被接收和处理 ,如果鼠标指针所在的父窗口不接收该事件则可以调用函数ignore()予以忽略;

多个重叠的窗口在实现里好比一个递归的倒立树,鼠标事件会沿着鼠标指针所在的父窗口的链表向上传递,直到某个窗口调用accept()函数进行事件处理,否则该事件将被过滤销毁掉;

如果一个鼠标事件传递给鼠标指针所在的窗口,而该窗口的QT::WA_NoMousePropagation位置为TRUE,则该事件不会通过父窗口继续向上传递。

可以通过函数pos()、x()、y()得知鼠标事件发生时鼠标指针相对于窗口的位置。

如果把移动窗口作为一次鼠标事件,可以通过函数globalPos()返回的全局坐标值避免窗口的抖动。

可以使用QWidget::setEndabled()来开启/关闭对应的窗口是否接受键盘和鼠标事件。


需要对鼠标事件进行处理时,通常要重新实现以下几个鼠标事件处理函数:

QWidget::mousePressEvent()
QWidget::mouseReleaseEvent()
QWidget::mouseDoubleClickEvent()
QWidget::mouseMoveEvent()

三、鼠标事件

鼠标事件使用的时候,加头文件

#include <QMouseEvent>

1.鼠标按下事件

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

2.鼠标移动事件 默认情况下,触发事件需要点击一下,才能触发。可设置为自动触发:setMouseTracking(true); 

void Widget::mouseMoveEvent(QMouseEvent *event)
    // 这里必须使用buttons()
    if(event->buttons() & Qt::LeftButton) //进行的按位与

3.鼠标释放事件

void Widget::mouseReleaseEvent(QMouseEvent *event)

4.鼠标双击事件

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

5.滚轮事件

void Widget::wheelEvent(QWheelEvent *event)
    if(event->delta() > 0)// 当滚轮远离使用者时
    else//当滚轮向使用者方向旋转时

四、键盘事件

键盘事件使用时,加头文件

#include <QKeyEvent>

1.键盘按下事件

void Widget::keyPressEvent(QKeyEvent *event)
    // 是否按下Ctrl键      特殊按键
    if(event->modifiers() == Qt::ControlModifier)
        // 是否按下M键    普通按键  类似
        if(event->key() == Qt::Key_M)
       QWidget::keyPressEvent(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;

2.按键释放事件

void Widget::keyReleaseEvent(QKeyEvent *event)
    //如果是处理两个普通按键,得避免自动重复
    if(event->key() == Qt::Key_Up)
        if(event->isAutoRepeat()) return;
    else if(event->key() == Qt::Key_Left)
        if(event->isAutoRepeat()) return;

 五、常用公有成员函数

1.globalPos()、globalX()、globalY()这三个函数返回的是鼠标指针的全局坐标。

const QPoint & QMouseEvent::globalPos () const
返回鼠标指针的全局坐标值,对于异步窗口系统例如X11这是一个很重要的特性,无论何时移动窗口作为对鼠标事件的响应时,globalPos()返回的当前鼠标指针坐标值和QCursor::pos()的返回值是有区别的,可以通过调用QWidget::mapToGlobal(pos())在窗口坐标和全局坐标系之间进行转换。

int QMouseEvent::globalX () const
返回鼠标事件发生时鼠标指针全局坐标的X值,相当于globalPos.x();

int QMouseEvent::globalY () const
返回鼠标事件发生时鼠标指针全局坐标的Y值,相当于globalPos.y()。

2.pos()、posF()、x()、y()这四个函数返回的是鼠标指针在当前接收鼠标事件的窗口中的位置。


const QPoint & QMouseEvent::pos () const
返回鼠标指针和接受该鼠标事件窗口的相对位置,其中的坐标值为整型;


QPointF QMouseEvent::posF () const
返回鼠标指针在接受该鼠标事件窗口的相对位置,该坐标值用float类型表示可以增加精确度;


int QMouseEvent::x () const
返回鼠标事件发生时,鼠标指针在当前接收鼠标事件的窗口中位置的x坐标值,相当与pos().x();

int QMouseEvent::y () const
返回鼠标事件发生时,鼠标指针在当前接收鼠标事件的窗口中位置的y坐标值,相当于pos().y()。