Qt深入浅出（十一）事件处理机制与画笔

以你之姓@ 2023-07-16 15:59 2阅读 0赞

# 事件处理机制 #

什么是事件，比如当我们打开一个窗口, 如果我们不动鼠标或者键盘, 那这个窗口就永远静静的躺着, 只有我们使用鼠标点击,或者键盘按下键的时候, 窗口才会有对应的反应。那么这个过程中就是用户向窗口发送了事件。

在 Qt 的界面应用程序都是事件驱动的，程序的每个动作也都是由某个事件所触发。在Qt 中事件抽象成QEvent类。 Qt中的事件有其对应的事件处理函数，事件先由QApplication::exec()消息循环接收，然后传递给对应窗口。

## 1 窗口事件处理函数event ##

Qt中所有的事件都是继承至QEvent, QEvent继承至QObject。每个窗口会收到各种事件，每个窗口也都有一个总的事件处理函数，用来处理事件或者进一步分派事件。

窗口的这个事件处理函数为QWidget::event()。

[ virtual protected] bool QWidget::event( QEvent * event);

需要注意它是一个保护权限的虚函数，那么我们一般通过派生QWidget对象，重写这个虚函数，来自定义事件处理。

Widget.h

#ifndef WIDGET_H 
        #define WIDGET_H 
        #include <QWidget> 
        #include <QDialog> 
        class Widget : public QWidget 
        { 
            Q_OBJECT 
         
        public: 
            Widget( QWidget * parent = 0); 
            bool event ( QEvent * event ); 
            ~Widget(); 
         
        }; 
        #endif // WIDGET_H

Widget.cpp

#include "widget.h" 
        #include <QEvent> 
        #include <QDebug> 
        Widget::Widget( QWidget * parent) 
          : QWidget( parent) 
        { 
        } 
         
        bool Widget::event( QEvent * ev) 
        { 
        /*只对鼠标点击事件进行处理，其它的调用基类的event函数*/ 
            if( ev -> type() == QEvent::MouseButtonPress || 
                    ev -> type() == QEvent::MouseButtonDblClick) 
          { 
                qDebug() << __FUNCTION__ << endl; 
            //event->ignore(); //代表我无视这个消息 
            event -> accept(); //代表我接收了这个消息 
            //return false; //这个消息我没有处理. 
                return true; //这个消息在我已经处理过了 
                
          } 
            return QWidget::event( ev); 
        } 
         
        Widget::~Widget() 
        { 
         
        }

需要注意的是：只有`event->accept()`以及`return true`时，才不往父窗口传递，否则都会传递。

## 2 鼠标事件 ##

### 2.1 鼠标点击事件 ###

Qt中的鼠标事件为QMouseEvent,  鼠标按下事件对应的事件处理函数为：

[ virtual protected] void QWidget::mousePressEvent( QMouseEvent * event);

这个是QWidget里面实现的鼠标按下事件处理函数, 它也是保护类型的虚函数,那么,我们一般是去覆写这个虚函数来实现我们想要的处理函数.

*  示例代码:
    
    Widget.h 
    
        #ifndef WIDGET_H 
              #define WIDGET_H 
               
              #include <QWidget> 
              #include <QDialog> 
              class Widget : public QWidget 
              { 
                  Q_OBJECT 
               
              public: 
                  Widget( QWidget * parent = 0); 
                  void mousePressEvent ( QMouseEvent * ); //重写虚函数 
                  ~Widget(); 
               
              }; 
               
              #endif // WIDGET_H
    
    Widget.cpp
    
        #include "widget.h" 
              #include <QMouseEvent> 
              #include <QDebug> 
              Widget::Widget( QWidget * parent) 
                : QWidget( parent) 
              { 
              } 
               
              void Widget::mousePressEvent( QMouseEvent * ev) 
              { 
                  qDebug() << __FUNCTION__ << endl; 
                  if( ev -> button() == Qt::LeftButton) 
                    { 
                      qDebug() << "left button press" << endl; 
                } 
                  else if( ev -> button() == Qt::RightButton) 
                    { 
                      qDebug() << "right button press" << endl; 
                } 
                  else if( ev -> button() == Qt::MidButton) 
                    { 
                      qDebug() << "mid button press" << endl; 
                } 
                  qDebug() << ev -> pos() << endl; 
              }
    
    普通鼠标有左右中三个键，可通过QMouseEvent::button来判断是哪个键：
    
        Qt::MouseButton QMouseEvent::button() const; 
              /* 
              *返回值为枚举类型：Qt::LeftButton 左键、Qt::RightButton 右键、Qt::MidButton 中键、Qt::NoButton没有键按下。 
              */
    
    鼠标的点击位置可以通过QMouseEvent::pos来获取：
    
        QPoint QMouseEvent::pos() const

### 2.2 鼠标释放事件 ###

Qt中的鼠标释放事件也是一个QMouseEvent对象,  鼠标按下事件对应的事件处理函数为：

[ virtual protected] void QWidget::mouseReleaseEvent( QMouseEvent * event);

使用方式，与鼠标点击事件类似，不再复述。

### 2.3 鼠标移动事件 ###

Qt中的鼠标移动事件为也是一个QMouseEvent对象,  鼠标移动事件对应的事件处理函数为：

[ virtual protected] void QWidget::mouseMoveEvent( QMouseEvent * event);

*  默认情况下, 鼠标移动事件触发条件必须是鼠标至少一个按键按下状态, 再去移动鼠标，但是鼠标QMouseEvent::Button()还是Qt::NoButton。

void Widget::mouseMoveEvent( QMouseEvent *   ev) 
        { 
        qDebug() << ev -> pos() << endl; 
            qDebug() << ev -> button() << endl; //不能用这个判断到底是哪个键按下 
        }

*  如果想要不按下鼠标按键，就触发鼠标移动事件可以调用QWidget::setMouseTracking

void QWidget::setMouseTracking( bool enable);

你可以参数在Widget中构造函数中调用该函数，enable参数为true代表开启鼠标跟踪，那么鼠标不需要按下任何键都能触发鼠标移动事件。

### 2.4 鼠标滚轮事件 ###

鼠标滚轮事件为QWheelEvent, 继承自QObject，对应的事件处理函数为:

[ virtual protected] void QWidget::wheelEvent( QWheelEvent * event);

例如:

void Widget::wheelEvent( QWheelEvent * ev) 
        { 
            qDebug() << ev -> angleDelta() << endl; 
        }

### 2.5 其它鼠标事件 ###

*  鼠标双击事件对应的事件处理函数

[ virtual protected] void QWidget::mouseDoubleClickEvent( QMouseEvent * event)

*  鼠标进入窗口对应的事件处理函数

[ virtual protected] void QWidget::enterEvent( QEvent * event)

*  鼠标离开窗口对应的事件处理函数

[ virtual protected] void QWidget::leaveEvent( QEvent * event)

## 3 键盘事件 ##

在Qt中键盘事件是QKeyEvent，继承自QObject。

### 3.1 键盘按下事件 ###

按下的事件对应的处理函数为:

[ virtual protected] void QWidget::keyPressEvent( QKeyEvent * event)

例如:

widget.h

#ifndef WIDGET_H 
        #define WIDGET_H 
        #include <QWidget> 
        class Widget : public QWidget 
        { 
            Q_OBJECT 
         
        public: 
            Widget( QWidget * parent = 0); 
            ~Widget(); 
            void keyPressEvent ( QKeyEvent * ev ); 
        }; 
         
        #endif // WIDGET_H

widget.cpp

#include "widget.h" 
        #include <QKeyEvent> 
        #include <QDebug> 
        Widget::Widget( QWidget * parent) 
          : QWidget( parent) 
        { 
              
        } 
        void Widget::keyPressEvent( QKeyEvent * ev) 
        { 
            switch( ev -> key()) 
          { 
                case Qt::Key_A: 
                    qDebug() << "key a pressed" << endl; 
                    break; 
                case Qt::Key_B: 
                    qDebug() << "key b pressed" << endl; 
                    break; 
                default: 
                    break; 
          } 
        }

通过QKeyEvent::key()函数获取到具体按下的某个键值：

int QKeyEvent::key() const; 
        /* 
        * 返回值的具体键值可以查看Qt帮助文档 
        */

### 3.2 键盘释放事件 ###

鼠标按下事件对应的事件处理函数为：

[ virtual protected] void QWidget::keyReleaseEvent( QKeyEvent * event);

使用方法与键盘按下事件类似，不再复述。

### 3.3 设置焦点窗口 ###

我们知道键盘事件是发送给当前激活状态的窗口，当只有一个窗口的时候，键盘事件定然是传递给这个窗口的。但是如果这个窗口上面有多个子窗口的时候，我们需要指定一个焦点窗口用来接收键盘事件。

焦点窗口可以通过tab键、鼠标按键点击等方式切换，也可以通过代码的方式来切换：

void QWidget::setFocus( Qt::FocusReason reason); 
        /* 
        *Qt::FocusReason reason 告诉Qt焦点切换的原因，一般填个Qt::OtherFocusReason即可 
        */

#### 3.4 判断按键大小写 ####

通过QKeyEvent的text()函数：

QString QKeyEvent::text() const 
        /* 
        *返回一个QString类型，这个是键盘产生的字符串 
        */

那么我们可以这样判断大小写：

void Widget::keyPressEvent( QKeyEvent * e) 
        { 
              if( e -> text() >= "A" && e -> text() <= "Z" ) 
            { 
                  qDebug() << "uppercase" << endl; 
            } 
              else if( e -> text() >= "a" && e -> text() <= "z" ) 
            { 
                  qDebug() << "lowcase" << endl; 
            } 
        }

## 4 事件过滤器 ##

上面我们看到，事件都只能在自己类中处理，如果其它对象想知道某个窗口的事件，可以通过给窗口安装事件过滤器，对应的函数为：

void QObject::installEventFilter( QObject * filterObj); 
        /* 
        *这个函数谁调用，谁被监控 
        *QObject *filterObj 监控者 
        */

事件过滤器的处理函数为:

[ virtual] bool QObject::eventFilter( QObject * watched, QEvent * event); 
        /* 
        * QObject *watched，被监控对象 
        * QEvent *event 具体哪些事件 
        * 返回值 true 代表过滤事件, false 代表不过滤 
        */

例如：

Widget.h

Widget. h 
        #ifndef WIDGET_H 
        #define WIDGET_H 
         
        #include <QWidget> 
         
        class Widget : public QWidget 
        { 
            Q_OBJECT 
         
        public: 
            Widget( QWidget * parent = 0); 
            ~Widget(); 
            bool eventFilter ( QObject * watched , QEvent * event ); 
         
        }; 
         
        #endif // WIDGET_H

Widget.c

#include "widget.h" 
        #include <QDebug> 
        #include <QHBoxLayout> 
        #include <QPushButton> 
        #include <QEvent> 
        #include <mybutton.h> 
         
        Widget::Widget( QWidget * parent) : QWidget( parent) 
        { 
            this -> resize( 400, 300); 
            QHBoxLayout * hBox = new QHBoxLayout; 
            MyButton * pb = new MyButton( "pb"); 
            hBox -> addWidget( pb); 
            this -> setLayout( hBox); 
            pb -> installEventFilter( this); //给pb对象安装事件过滤器 
        } 
         
        bool Widget::eventFilter( QObject * watched, QEvent * event) 
        { 
            if( event -> type() == QEvent::MouseButtonPress 
                    || event -> type() ==   QEvent::MouseButtonDblClick) 
          { 
                qDebug() << "eventFilter" << endl; 
                return true; //过滤掉点击事件 
          } 
            return QWidget::eventFilter( watched, event); 
        } 
         
        Widget::~Widget() 
        { 
          
        }

mybutton.h

#ifndef MYBUTTON_H 
        #define MYBUTTON_H 
        #include <QPushButton> 
        #include <QKeyEvent> 
        class MyButton : public QPushButton 
        { 
        public: 
            MyButton( const QString & text, QWidget * parent = 0); 
            void mousePressEvent ( QMouseEvent * ev ); 
        }; 
         
        #endif // MYBUTTON_H

mybutton.cpp

#include "mybutton.h" 
        #include <QDebug> 
         
        MyButton::MyButton( const QString & text, QWidget * parent) 
          : QPushButton( text, parent) 
        { 
         
        } 
        void MyButton::mousePressEvent( QMouseEvent * ev) 
        { 
            static int i = 0; 
            qDebug() << __FUNCTION__ << i ++ << endl; 
        }

## 5 事件传递过程 ##

QApplication的exec从桌面系统中获取事件，然后分发给对应的窗口事件处理函数bool event(QEvent)，然后该函数再分发给具体的某个事件处理函数，如鼠标事件、键盘事件等。

## 6 事件处理函数是如何被调用的 ##

我们重定义事件处理函数后,并没有显示的调用,那为什么,事件能够进入到我们的事件处理函数中呢?

这是其实是因为,我们的事件处理函数都是虚函数，我们override了基类的事件处理函数, 而Qt在底层实现了使用基类的指针指向我们的派生类对象, 并且在事件触发时，使用基类指针来调用我们override的事件处理函数。

简单来说，就是应用了c++多态。

## 7 绘图事件 ##

在桌面系统中所有的窗口都是绘制出来的, 那么在窗口形态发生变化时, 就会产生一个绘画事件, 在Qt中叫作QPaintEvent, 其对应的事件处理函数是：

[ virtual protected] void QWidget::paintEvent( QPaintEvent * event);

### 7.1 QPainter画家 ###

我们知道画图一般需要一个画家来画，画家想要画图首先要给它一张画纸，然后画家需要一把画笔来画轮廓, 一把笔刷来填充颜色。

那么在Qt中我们的画家叫做QPainter, 画纸可以是任何QPaintDevice的派生类对象,

QWidget本身也继承至QPaintDevice，所以也能用来当作画纸。继承至QPaintDevice的类还有QPixmap、QPicture、QImage。

QPainter有QPen画笔, QBrush笔刷。

注意:当画纸为QWidget的派生类对象时, QPainter只能在QWidget的painteEvent事件处理函数中使用.

### 7.2 在窗口上绘图 ###

设置画笔笔刷, 并且绘制出线,文本,矩形等等：

widet.h

#ifndef WIDGET_H 
        #define WIDGET_H 
         
        #include <QWidget> 
         
        class Widget : public QWidget 
        { 
            Q_OBJECT 
         
        public: 
            Widget( QWidget * parent = 0); 
            ~Widget(); 
            void paintEvent ( QPaintEvent * event ); 
         
        }; 
         
        #endif // WIDGET_H

widget.cpp

#include "widget.h" 
        #include <QDebug> 
        #include <QPaintEvent> 
        #include <QPainter> 
         
        Widget::Widget( QWidget * parent) : QWidget( parent) 
        { 
            this -> resize( 400, 300); 
         
            QFont font = this -> font(); //这个可以用来设置字体的样式 
            font. setPixelSize( 10); 
            this -> setFont( font); 
        } 
         
        void Widget::paintEvent( QPaintEvent * event) 
        { 
            qDebug() << "paintEvent" << endl; 
            QPainter painter; 
            painter. begin( this); 
            painter. setPen( Qt::red); 
        // painter.setPen(QPen(QBrush(Qt::red), 20, Qt::DashLine)); //画笔的高级设置 
            painter. setBrush( Qt::blue); //设置 
        // painter.setBrush(QBrush(Qt::blue, Qt::Dense3Pattern); //笔刷的高级设置 
            painter. drawText( 100, 100, "huangwl"); //画字 
            painter. drawLine( 0, 0, 100, 100); //画线 
        painter. drawRect( 100, 100, 200, 200); //画矩形 
        painter. drawEllipse( 100, 0, 100, 200); //画椭圆 
            painter. end(); 
        } 
         
        Widget::~Widget() 
        { 
         
        }

### 7.3 转变窗口坐标系 ###

*  更改绘图坐标系的坐标原点

void QPainter::translate( constQPointF & offset)

*  更改绘图坐标系的角度

void QPainter::rotate( qreal angle)

*  缩放坐标系单位

void QPainter::scale( qreal sx, qreal sy)

Widget.h

Widget.cpp

#include "widget.h" 
        #include <QDebug> 
        #include <QPaintEvent> 
        #include <QPainter> 
         
        Widget::Widget( QWidget * parent) : QWidget( parent) 
        { 
            this -> resize( 600, 480); 
        } 
         
        void Widget::paintEvent( QPaintEvent * event) 
        { 
            qDebug() << "paintEvent" << endl; 
            QPainter painter; 
            painter. begin( this); 
            painter. setPen( Qt::red); 
            painter. setBrush( Qt::blue); 
            painter. translate( 100, 0); //坐标原点转换到(100,0)位置 
            painter. rotate( 45);   //顺时针旋转45度 
            painter. scale( 0.5, 0.5); //坐标系的单位变为原来的0.5 
            painter. drawRect( 0, 0, 100, 100); //画矩形 
            painter. end(); 
        } 
         
        Widget::~Widget() 
        { 
         
        }

### 7.4 保存与还原QPainter设置 ###

*  保存之前QPainter所有的设置

void QPainter::save()

*  还原之前QPainter的设置.

void QPainter::restore()

### 7.5 绘制事件触发的时机 ###

1.  窗口失去焦点, 窗口缩放.
2.  窗口被覆盖, 或者窗口被显示出来
3.  在代码中可以用函数repaint()和update()

*  repaint() 立即重绘，并且可以指定重绘区域
    
        [ slot] void QWidget::repaint()
    
    
 *  update()  不是马上重绘，加入到消息队列中，由消息循环来调度，有时多个update()会合并成一个重绘事件。
    
        [ slot] void QWidget::update()

例如：

widget.h

Widget.cpp

#include "widget.h" 
        #include <QDebug> 
        #include <QPaintEvent> 
        #include <QPainter> 
        #include <QDialog> 
        #include <QPushButton> 
        #include <QHBoxLayout> 
         
        Widget::Widget( QWidget * parent) : QWidget( parent), _color( Qt::red) 
        { 
            QDialog * dialog = new QDialog( this); 
            QPushButton * pb0 = new QPushButton( "update", this); 
            QPushButton * pb1 = new QPushButton( "repaint", this); 
            QHBoxLayout * hBox = new QHBoxLayout( this); 
            hBox -> addWidget( pb0); 
            hBox -> addWidget( pb1); 
            dialog -> setLayout( hBox); 
         
            this -> resize( 600, 480); 
            dialog -> resize( 400, 300); 
            dialog -> show(); 
         
            connect( pb0, SIGNAL( clicked()), this, SLOT( doUpdate())); 
            connect( pb1, SIGNAL( clicked()), this, SLOT( doRepaint())); 
        } 
        void Widget::doUpdate() 
        { 
            _color. setRgb( 0, 0, 255); 
            this -> update(); 
        } 
         
        void Widget::doRepaint()