PyQt5默认事件处理

一、引言
基于窗体（Widget）的应用程序都是由事件（event）驱动的，鼠标单击、按下某个按键、重绘某个组件、最小化窗口都会产生相应的事件，应用程序对这些事件作出相应的响应处理以实现程序的功能。

二、应用程序的事件循环
事件主要由操作系统的窗口系统产生的，产生的事件进入一个事件队列，由应用程序的事件循环进行处理。以下是PyQt5应用程序的主程序结构：

app = QApplication(sys.argv)
mainform = QmyWidget()
mainform.show()
sys.exit(app.exec_())

app是创建的应用程序对象，最后执行的app.exec_()开启了应用程序的事件处理循环。应用程序会对事件队列中排队的事件进行处理，还可以对相同事件进行合并处理。例如一个界面组件的重绘事件paintEvent，如果在事件队列中重复出现同一事件，应用程序就会合并处理，所以，事件处理是一种异步处理机制。

三、事件类型及默认的事件处理函数
在PyQt5中，事件是一种对象，由抽象类QEvent表示。QEvent还有很多子类表示具体的事件，如QKeyEvent表示按键事件，QMouseEvent表示鼠标事件，QPaintEvent表示窗体绘制事件。

当一个事件发生时，PyQt5会根据事件的具体类型用QEvent相应的子类创建一个事件实例对象，然后传递给产生事件的对象的event()函数进行处理。

QObject类及其子类都可以进行事件的处理，但主要还是窗体类（QWidget及其子类）中用到事件处理。以下是QObject类的event()函数的原型：

event(self, <em>e</em>)

参数e是QEvent类型，QEvent类主要有以下3个接口函数：
（1）accept()：表示事件接收者接受此事件，对此事件进行处理，接受的事件不会再传播给上层容器组件。
（2）ignore()：表示事件接收者忽略次事件，忽略的事件将传播给上层容器组件。
（3）type()：返回事件的类型，是枚举类型QEvent.Type，这个枚举类型由100多个值，表示100多个类型的事件。

枚举类型QEvent.Type的每个值都对应于一个事件类，例如QEvent.KeyPress类型表示的是按键事件，对应的事件类是QKeyEvent。

一个类接收到事件后，首先会触发其event()函数，如果event()函数不做任何处理，就会自动触发默认的事件处理函数。

QWidget类是所有界面组件类的父类，它定义了各种事件的默认处理函数，例如鼠标双击事件的枚举类型是QEvent.MouseButtonDblClick，默认的事件处理函数是mouseDoubleClickEvent()，其函数原型是：

mouseDoubleClickEvent(self, event)

参数event是QMouseEvent类型，这是鼠标类型对应的类。
QWidget定义了很多的默认事件处理函数，都会传递一个event参数，但是event的类型由具体事件类型决定。常用的默认事件处理函数如表所示（表中只列出了函数名称，未列出函数输入参数）

默认函数名称	触发时机	参数event类型
mousePressEvent()	鼠标按键按下时触发	QMouseEvent
mouseReleaseEvent()	鼠标按键释放时触发	QMouseEvent
mouseMoveEvent()	鼠标移动时触发	QMouseEvent
mouseDoubleClickEvent()	鼠标双击时触发	QMouseEvent
keyPressEvent()	键盘按键按下时触发	QKeyEvent
keyReleaseEvent()	键盘按键释放时触发	QKeyEvent
paintEvent()	在界面需要重新绘制时触发	QPaintEvent
closeEvent()	一个窗体关闭时触发	QCloseEvent
showEvent()	一个窗体显示时触发	QShowEvent
hideEvent()	一个窗体隐藏时触发	QHideEvent
resizeEvent()	组件改变大小时触发，如一个窗口改变大小时	QResizeEvent
focusInEvent()	当一个组件获得键盘焦点时触发，如一个QLineEdit组件获得输入焦点	QFocusEvent
focusOutEvent()	当一个组件失去键盘焦点时触发，如一个QLineEdit组件失去输入焦点	QFocusEvent
enterEvent()	当鼠标进入组件的屏幕空间时触发，如鼠标移动到一个QPushButton组件上	QEvent
leaveEvent()	当鼠标离开组件的屏幕空间时触发，如鼠标离开一个QPushButton组件	QEvent
dragEnterEvent()	拖动操作正在进行，鼠标移动到组件上方时触发	QDragEnterEvent
dragLeaveEvent()	拖动操作正在进行，鼠标移出组件上方时触发	QDragLeaveEvent
dragMoveEvent()	拖动操作正在进行，鼠标移动时触发	QDragMoveEvent
dropEvent()	当拖动操作在某个组件上放下时触发	QDropEvent

用户在继承于QWidget或其子类的自定义类中可以重新实现这些默认的事件处理函数，从而实现一些需要的功能。例如，QWidget没有clicked()信号，那么就不能通过信号与槽的方式实现对鼠标单击的处理，但是可以重新实现mouseReleaseEvent()函数对鼠标单击事件进行处理。

下列例子对基于项目模板widgetApp的默认事件处理作说明：

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QMessageBox
from PyQt5.QtCore import pyqtSlot, Qt, QEvent
from PyQt5.QtGui import QPainter, QPixmap

from ui_Widget import Ui_Widget
class QmyWidgrt(QWidget):
	def __init__(self, parent = None):
		super().__init__(parent)	#调用父类构造函数，创建窗体
		self.ui = Ui_Widget()		#创建UI对象
		self.ui.SetupUi(self)		#构造UI

然后在QmyWidget类中重新实现了以下一些典型事件的默认处理函数。
（1）paintEvent()
在界面需要重新绘制时触发，在此事件函数里可以实现一些自定义的绘制功能。绘制窗体背景图片：

def paintEvent(self, event):
	painter = QPainter(self)
	pic = QPixmap("sea1.jpg")
	painter.drawPixmap(0, 0, self.width(), self.height(), pic)
	super().paintEvent(event)

函数的功能是将一个图片文件sea1.jpg绘制到窗体的整个区域，绘图时使用了窗体的画笔对象painter。图片文件sea1.jpg必须与使用其的脚本文件在同一个目录里。最后一行语句表示再执行父类的paintEvent()事件处理函数，以便父类执行其内建的一些操作。

（2）resizeEvent()
在窗体改变大小时触发，在此事件函数里，根据窗体大小，使一个按钮btnTest总是居于窗体的中央。

def resizeEvent(self, event):
	W = self.width()
	H = self.height()
	Wbtn = self.ui.btnTest.width()
	Hbtn = self.ui.btnTest.height()
	self.ui.btnTest.setGeometry((W-Wbtn)/2, (H-Hbtn)/2, Wbtn, Hbtn)

（3）closeEvent()
在窗体关闭时触发，在此事件函数里可以使用一个对话框询问是否关闭窗体，代码如下：

def closeEvent(self, event):
	dlgTitle = "Question消息框"
	strInfo = "closeEvent事件触发，确定要退出吗？"
	defaultBtn = QMessageBox.NoButton
	result = QMessageBox.question(self, dlgTitle, strInfo, QMessageBox.Yes | QMessageBox.No, defaultBtn)
	if(result == QMessageBox.Yes):
		event.accept()			#窗体可关闭
	else:
		event.ignore()			#窗体不可关闭

使用了对话框QMessageBox询问是否关闭窗体。

closeEvent(event)函数的参数event是QCloseEvent类型，根据对话框的返回结果调用QCloseEvent的accept()函数可以关闭窗体，ignore()函数则不关闭窗体。

（4）mousePressEvent()
在鼠标按键按下时触发，在此事件函数里判断鼠标左键是否按下，如果是左键按下就显示鼠标光标处的屏幕坐标，即：

def mousePressEvent(self, event):
	pt = event.pos()		#鼠标位置，QPoint
	if(event.button() == Qt.LeftButton):	#鼠标左键按下
		self.ui.LabMove.setText("(x, y) = (%d, %d)" %(pt.x(), pt.y()))
		rect = self.ui.LabMove.geometry()
		self.ui.LabMove.setGeometry(pt.x(), pt.y(), rect.width(), rect.height())
	super().mousePressEvent(event)

参数event是QMouseEvent类型，QMouseEvent有以下几个接口函数，表示按下的按键的信息和鼠标坐标信息。

• button()函数：返回值是枚举类型Qt.MouseButton，表示被按下的是鼠标的哪个按键，有Qt.NoButton、Qt.LeftButton、Qt.RightButton和Qt.MidButton等多种取值。
• buttons()函数：返回值是枚举类型Qt.MouseButton的取值组合，可用于判断多个按键被按下的情况，例如判断鼠标左键和右键同时按下时的语句是：

if(event.buttons() & Qt.LeftButton) and (event.buttons() & Qt.RightButton):

• x()函数和y()函数：返回值是int类型；pos()函数，返回值是QPoint类型。这两组函数的返回值都表示鼠标光标在接收此事件的组件（widget）上的相对坐标。
• localPos()函数：返回值是QPointF类型，表示鼠标光标在接收此事件的组件（widget）或项（item）上的相对坐标。
• windowPos()函数：返回值是QPointF类型，表示鼠标光标在接收此事件的窗口（window）上的相对坐标。
• globalX()函数和globalY()函数：返回值是int类型；globalPos()函数，返回值是QPoint类型。这两组函数的返回值都表示鼠标光标的全局坐标，也就是屏幕上的坐标。
• screenPos()函数：返回值是QPointF类型，表示鼠标光标在接收此事件的屏幕（screen）上的全局坐标。

（5）keyPressEvent()或keyReleaseEvent()
keyPressEvent()在键盘上的按键按下时触发，keyReleaseEvent()在按键释放时触发，为keyPressEvent()编写的代码如下：

def keyPressEvent(self, event):
	rect = self.ui.btnMove.geometry()
	if event.key() in set([Qt.Key_A, Qt.Key_Left]):
		self.ui.btnMove.setGeometry(rect.left() - 20, rect.top(), rect.width(), rect.height())
	elif event.key() in set([Qt.Key_D, Qt.Key_Right]):
		self.ui.btnMove.setGeometry(rect.left() + 20, rect.top(), rect.width(), rect.height())
	elif event.key() in set([Qt.Key_W, Qt.Key_Up]):
		self.ui.btnMove.setGeometry(rect.left, rect.top() - 20, rect.width(), rect.height())
	elif event.key() in set([Qt.Key_S, Qt.Key_Down]):
		self.ui.btnMove.setGeometry(rect.left, rect.top() + 20, rect.width(), rect.height())

keyPressEvent(event)函数的参数event是QKeyEvent类型，它有以下两个主要的接口函数，表示按下的按键的信息。

• key()函数：返回值类型是int，表示被按下的按键，与枚举类型Qt.Key的取值对应。枚举类型Qt.Key包括键盘上所有按键的枚举值，如Qt.Key_Escape、Qt.Key_Tab、Qt.Key_Delete、Qt.Key_Alt、Qt.Key_F1、Qt.Key_A等（详见Qt帮助文档）。
• modifiers()函数：返回值是枚举类型Qt.KeyboardModifier的取值组合，表示一些用于组合的按键，如Ctrl、Alt、Shift等按键。例如，判断Ctrl+Q是否被按下的语句如下：

if(event.key() == Qt.Key_Q) and (event.modifiers() & Qt.ControlModifier):

这段程序是期望在按下W、A、S、D或上、下、左、右方向键时，窗体上的按钮btnMove能上下左右移动位置。但是却会发现在使用keyPressEvent()事件函数时，只有W、A、S、D有效，而如果使用的是keyReleaseEvent()函数，则W、A、S、D和上、下、左、右方向键都有效。这说明上、下、左、右方向键按下时不会产生QEvent.KeyPress类型的事件。