之前在Python Qt GUI設計：QTimer計時器類、QThread多線程類和事件處理類（基礎篇—8）中，我們已經簡單講到，PyQt為事件處理提供了兩種機制：高級的信號與槽機制以及低級的事件處理程序，本篇博文將系統講解Qt的事件處理機類和制。
事件處理機制本身很復雜，是PyQt底層的知識點，當采用信號與槽機制處理不了時，才會考慮使用事件處理機制。
信號與槽可以說是對事件處理機制的高級封裝，如果說事件是用來創建窗口控件的，那么信號與槽就是用來對這個窗口控件進行使用的。比如一個按鈕，當我們使用這個按鈕時，只關心clicked信號，至于這個按鈕如何接收并處理鼠標點擊事件，然后再發射這信號，則不用關心。但是如果要重載一個按鈕，這時就要關心這個問題了。比如可以改變它的行為：在鼠標按鍵按下時觸發clicked信號，而不是在釋放時。
1、常見事件類型
Qt事件的類型有很多，常見的Qt事件如下所示：
鍵盤事件：按鍵按下和松開。
鼠標事件：鼠標指針移動、鼠標按鍵按下和松開。
拖放事件：用鼠標進行拖放。
滾輪事件：鼠標滾輪滾動。
繪屏事件：重繪屏幕的某些部分。
定時事件：定時器到時。
焦點事件：鍵盤焦點移動。
進入和離開事件：鼠標指針移入Widget內，或者移出。
移動事件:：Widget的位置改變。
大小改變事件：Widget的大小改變。
顯示和隱藏事件：Widget顯示和隱藏。
窗口事件：窗口是否為當前窗口。
還有一些常見的Qt事件，比如Socket事件、剪貼板事件、字體改變事件、布局改變事件等。
具體事件類型和說明可參見說明文檔：
2、事件處理方法
PyQt提供了如下5種事件處理和過濾方法（由弱到強），其中只有前兩種方法使用最頻繁。
2.1、重新實現事件函數
比如mousePressEvent()、keyPressEvent()、paintEvent()。這是最常規的事件處理方法。
通過示例了解重新實現事件函數的使用方法，效果如下所示：
這個示例中包含了多種事件類型，所以比較復雜。
首先是類的建立，建立text和message兩個變量，使用paintEvent函數把它們輸出到窗口中。
update函數的作用是更新窗口，由于在窗口更新過程中會觸發一次 paintEvent函數（paintEvent是窗口基類QWidget的內部函數），因此在本例中update函數的作用等同于paintEvent函數。
然后是重新實現窗口關閉事件與上下文菜單事件，對于上下文菜單事件，主要影響message變量的結果，paintEvent負責把這個變量在窗口底部輸出。
繪制事件是代碼的核心事件，它的主要作用是時刻跟蹤text與message這兩個變量的信息，并把 text的內容繪制到窗口的中部，把message的內容繪制到窗口的底部（保持5秒后就會被清空）。
以及最后一些鼠標、鍵盤的點擊操作等。
實現代碼如下所示：
import sys
from PyQt5.QtCore import (QEvent, QTimer, Qt)
from PyQt5.QtWidgets import (QApplication, QMenu, QWidget)
from PyQt5.QtGui import QPainter
class Widget(QWidget):
? ? def __init__(self, parent=None):
? ? ? ? super(Widget, self).__init__(parent)
? ? ? ? self.justDoubleClicked = False
? ? ? ? self.key = ""
? ? ? ? self.text = ""
? ? ? ? self.message = ""
? ? ? ? self.resize(400, 300)
? ? ? ? self.move(100, 100)
? ? ? ? self.setWindowTitle("Events")
? ? ? ? QTimer.singleShot(0, self.giveHelp)? # 避免窗口大小重繪事件的影響，可以把參數0改變成3000（3秒），然后在運行，就可以明白這行代碼的意思。
? ? def giveHelp(self):
? ? ? ? self.text = "請點擊這里觸發追蹤鼠標功能"
? ? ? ? self.update() # 重繪事件，也就是觸發paintEvent函數。
? ? '''重新實現關閉事件'''
? ? def closeEvent(self, event):
? ? ? ? print("Closed")
? ? '''重新實現上下文菜單事件'''
? ? def contextMenuEvent(self, event):
? ? ? ? menu = QMenu(self)
? ? ? ? oneAction = menu.addAction("&One")
? ? ? ? twoAction = menu.addAction("&Two")
? ? ? ? oneAction.triggered.connect(self.one)
? ? ? ? twoAction.triggered.connect(self.two)
? ? ? ? if not self.message:
? ? ? ? ? ? menu.addSeparator()
? ? ? ? ? ? threeAction = menu.addAction("Thre&e")
? ? ? ? ? ? threeAction.triggered.connect(self.three)
? ? ? ? menu.exec_(event.globalPos())
? ? '''上下文菜單槽函數'''
? ? def one(self):
? ? ? ? self.message = "Menu option One"
? ? ? ? self.update()
? ? def two(self):
? ? ? ? self.message = "Menu option Two"
? ? ? ? self.update()
? ? def three(self):
? ? ? ? self.message = "Menu option Three"
? ? ? ? self.update()
? ? '''重新實現繪制事件'''
? ? def paintEvent(self, event):
? ? ? ? text = self.text
? ? ? ? i = text.find("\n\n")
? ? ? ? if i >= 0:
? ? ? ? ? ? text = text[0:i]
? ? ? ? if self.key: # 若觸發了鍵盤按鈕，則在文本信息中記錄這個按鈕信息。
? ? ? ? ? ? text += "\n\n你按下了: {0}".format(self.key)
? ? ? ? painter = QPainter(self)
? ? ? ? painter.setRenderHint(QPainter.TextAntialiasing)
? ? ? ? painter.drawText(self.rect(), Qt.AlignCenter, text) # 繪制信息文本的內容
? ? ? ? if self.message: # 若消息文本存在則在底部居中繪制消息，5秒鐘后清空消息文本并重繪。
? ? ? ? ? ? painter.drawText(self.rect(), Qt.AlignBottom | Qt.AlignHCenter,
? ? ? ? ? ? ? ? ? ? ? ? ? ? self.message)
? ? ? ? ? ? QTimer.singleShot(5000, self.clearMessage)
? ? ? ? ? ? QTimer.singleShot(5000, self.update)
? ? '''清空消息文本的槽函數'''
? ? def clearMessage(self):
? ? ? ? self.message = ""
? ? '''重新實現調整窗口大小事件'''
? ? def resizeEvent(self, event):
? ? ? ? self.text = "調整窗口大小為： QSize({0}, {1})".format(
? ? ? ? ? ? event.size().width(), event.size().height())
? ? ? ? self.update()
? ? '''重新實現鼠標釋放事件'''
? ? def mouseReleaseEvent(self, event):
? ? ? ? # 若鼠標釋放為雙擊釋放，則不跟蹤鼠標移動
? ? ? ? # 若鼠標釋放為單擊釋放，則需要改變跟蹤功能的狀態，如果開啟跟蹤功能的話就跟蹤，不開啟跟蹤功能就不跟蹤
? ? ? ? if self.justDoubleClicked:
? ? ? ? ? ? self.justDoubleClicked = False
? ? ? ? else:
? ? ? ? ? ? self.setMouseTracking(not self.hasMouseTracking()) # 單擊鼠標
? ? ? ? ? ? if self.hasMouseTracking():
? ? ? ? ? ? ? ? self.text = "開啟鼠標跟蹤功能.\n" + \
? ? ? ? ? ? ? ? ? ? ? ? ? ? "請移動一下鼠標！\n" + \
? ? ? ? ? ? ? ? ? ? ? ? ? ? "單擊鼠標可以關閉這個功能"
? ? ? ? ? ? else:
? ? ? ? ? ? ? ? self.text = "關閉鼠標跟蹤功能.\n" + \
? ? ? ? ? ? ? ? ? ? ? ? ? ? "單擊鼠標可以開啟這個功能"
? ? ? ? ? ? self.update()
? ? '''重新實現鼠標移動事件'''
? ? def mouseMoveEvent(self, event):
? ? ? ? if not self.justDoubleClicked:
? ? ? ? ? ? globalPos = self.mapToGlobal(event.pos()) # 窗口坐標轉換為屏幕坐標
? ? ? ? ? ? self.text = """鼠標位置：
? ? ? ? ? ? 窗口坐標為：QPoint({0}, {1})
? ? ? ? ? ? 屏幕坐標為：QPoint({2}, {3}) """.format(event.pos().x(), event.pos().y(), globalPos.x(), globalPos.y())
? ? ? ? ? ? self.update()
? ? '''重新實現鼠標雙擊事件'''
? ? def mouseDoubleClickEvent(self, event):
? ? ? ? self.justDoubleClicked = True
? ? ? ? self.text = "你雙擊了鼠標"
? ? ? ? self.update()
? ? '''重新實現鍵盤按下事件'''
? ? def keyPressEvent(self, event):
? ? ? ? self.key = ""
? ? ? ? if event.key() == Qt.Key_Home:
? ? ? ? ? ? self.key = "Home"
? ? ? ? elif event.key() == Qt.Key_End:
? ? ? ? ? ? self.key = "End"
? ? ? ? elif event.key() == Qt.Key_PageUp:
? ? ? ? ? ? if event.modifiers() & Qt.ControlModifier:
? ? ? ? ? ? ? ? self.key = "Ctrl+PageUp"
? ? ? ? ? ? else:
? ? ? ? ? ? ? ? self.key = "PageUp"
? ? ? ? elif event.key() == Qt.Key_PageDown:
? ? ? ? ? ? if event.modifiers() & Qt.ControlModifier:
? ? ? ? ? ? ? ? self.key = "Ctrl+PageDown"
? ? ? ? ? ? else:
? ? ? ? ? ? ? ? self.key = "PageDown"
? ? ? ? elif Qt.Key_A <= event.key() <= Qt.Key_Z:
? ? ? ? ? ? if event.modifiers() & Qt.ShiftModifier:
? ? ? ? ? ? ? ? self.key = "Shift+"
? ? ? ? ? ? self.key += event.text()
? ? ? ? if self.key:
? ? ? ? ? ? self.key = self.key
? ? ? ? ? ? self.update()
? ? ? ? else:
? ? ? ? ? ? QWidget.keyPressEvent(self, event)
if __name__ == "__main__":
? ? app = QApplication(sys.argv)
? ? form = Widget()
? ? form.show()
? ? app.exec_()
2.2、重新實現QObject.event()
一般用在PyQt沒有提供該事件的處理函數的情況下，即增加新事件時。
對于窗口所有的事件都會傳遞給event函數，event函數會根據事件的類型，把事件分配給不同的函數進行處理。例如，對于繪圖事件，event會交給paintEvent函數處理；對于鼠標移動事件，event會交給mouseMoveEvent函數處理；對于鍵盤按下事件，event會交給keyPressEvent函數處理。
有一種特殊情況是對Tab鍵的觸發行為，event函數對Tab鍵的處理機制是把焦點從當前窗口控件的位置切換到Tab鍵次序中下一個窗口控件的位置，并返回True，而不是交給keyPressEvent函數處理。
因此這里需要在event函數中對按下Tab鍵的處理邏輯重新改寫，使它與鍵盤上普通的鍵沒什么不同。
在2.1、重新實現事件函數例子中補充以下代碼，實現重新定義：
'''重新實現其他事件，適用于PyQt沒有提供該事件的處理函數的情況，Tab鍵由于涉及焦點切換，不會傳遞給keyPressEvent，因此，需要在這里重新定義。'''
? ? def event(self, event):
? ? ? ? if (event.type() == QEvent.KeyPress and
? ? ? ? ? ? ? ? ? ? event.key() == Qt.Key_Tab):
? ? ? ? ? ? self.key = "在event()中捕獲Tab鍵"
? ? ? ? ? ? self.update()
? ? ? ? ? ? return True
效果如下所示：
2.3、安裝事件過濾器
如果對QObject調用installEventFilter，則相當于為這個QObject安裝了一個事件過濾器，對于QObject的全部事件來說，它們都會先傳遞到事件過濾函數eventFilter中，在這個函數中我們可以拋棄或者修改這些事件，比如可以對自己感興趣的事件使用自定義的事件處理機制，對其他事件使用默認的事件處理機制。
由于這種方法會對調用installEventFilter的所有QObject的事件進行過濾，因此如果要過濾的事件比較多，則會降低程序的性能。
通過示例，了解事件過濾器的使用方法，效果如下所示：
對于使用事件過濾器，關鍵是要做好兩步。
對要過濾的控件設置installEventFilter，這些控件的所有事件都會被eventFilter函數接收并處理。
示例中，這個過濾器只對label1的事件進行處理，并且只處理它的鼠標按下事件（MouseButtonPress）和鼠標釋放事件（MouseButtonRelease） 。
如果按下鼠標鍵，就會對label1裝載的圖片進行縮放（長和寬各縮放一半）。
實現代碼如下所示：
# -*- coding: utf-8 -*-
from PyQt5.QtGui import *
from PyQt5.QtCore import *
from PyQt5.QtWidgets import *
import sys
class EventFilter(QDialog):
? ? def __init__(self, parent=None):
? ? ? ? super(EventFilter, self).__init__(parent)
? ? ? ? self.setWindowTitle("事件過濾器")
? ? ? ? self.label1 = QLabel("請點擊")
? ? ? ? self.label2 = QLabel("請點擊")
? ? ? ? self.label3 = QLabel("請點擊")
? ? ? ? self.LabelState = QLabel("test")
? ? ? ? self.image1 = QImage("images/cartoon1.ico")
? ? ? ? self.image2 = QImage("images/cartoon1.ico")
? ? ? ? self.image3 = QImage("images/cartoon1.ico")
? ? ? ? self.width = 600
? ? ? ? self.height = 300
? ? ? ? self.resize(self.width, self.height)
? ? ? ? self.label1.installEventFilter(self)
? ? ? ? self.label2.installEventFilter(self)
? ? ? ? self.label3.installEventFilter(self)
? ? ? ? mainLayout = QGridLayout(self)
? ? ? ? mainLayout.addWidget(self.label1, 500, 0)
? ? ? ? mainLayout.addWidget(self.label2, 500, 1)
? ? ? ? mainLayout.addWidget(self.label3, 500, 2)
? ? ? ? mainLayout.addWidget(self.LabelState, 600, 1)
? ? ? ? self.setLayout(mainLayout)
? ? def eventFilter(self, watched, event):
? ? ? ? if watched == self.label1: # 只對label1的點擊事件進行過濾，重寫其行為，其他的事件會被忽略
? ? ? ? ? ? if event.type() == QEvent.MouseButtonPress: # 這里對鼠標按下事件進行過濾，重寫其行為
? ? ? ? ? ? ? ? mouseEvent = QMouseEvent(event)
? ? ? ? ? ? ? ? if mouseEvent.buttons() == Qt.LeftButton:
? ? ? ? ? ? ? ? ? ? self.LabelState.setText("按下鼠標左鍵")
? ? ? ? ? ? ? ? elif mouseEvent.buttons() == Qt.MidButton:
? ? ? ? ? ? ? ? ? ? self.LabelState.setText("按下鼠標中間鍵")
? ? ? ? ? ? ? ? elif mouseEvent.buttons() == Qt.RightButton:
? ? ? ? ? ? ? ? ? ? self.LabelState.setText("按下鼠標右鍵")
? ? ? ? ? ? ? ? '''轉換圖片大小'''
? ? ? ? ? ? ? ? transform = QTransform()
? ? ? ? ? ? ? ? transform.scale(0.5, 0.5)
? ? ? ? ? ? ? ? tmp = self.image1.transformed(transform)
? ? ? ? ? ? ? ? self.label1.setPixmap(QPixmap.fromImage(tmp))
? ? ? ? ? ? if event.type() == QEvent.MouseButtonRelease: # 這里對鼠標釋放事件進行過濾，重寫其行為
? ? ? ? ? ? ? ? self.LabelState.setText("釋放鼠標按鈕")
? ? ? ? ? ? ? ? self.label1.setPixmap(QPixmap.fromImage(self.image1))
? ? ? ? return QDialog.eventFilter(self, watched, event) # 其他情況會返回系統默認的事件處理方法。
if __name__ == '__main__':
? ? app = QApplication(sys.argv)
? ? dialog = EventFilter()
? ? dialog.show()
? ? sys.exit(app.exec_())
2.4、在QApplication中安裝事件過濾器
這種方法比2.3、安裝事件過濾器更強大，QApplication的事件過濾器將捕獲所有QObject的所有事件，而且第一個獲得該事件。也就是說，在將事件發送給其他任何一個事件過濾器之前（就是在第三種方法之前)，都會先發送給QApplication的事件過濾器。
在2.3、安裝事件過濾器示例基礎上修改，屏蔽三個label標簽控件的installEventFilter代碼，這種事件處理方法確實過濾了所有事件，而不像第三種方法那樣只過濾三個標簽控件的事件。效果如下所示：
實現代碼如下所示：
# -*- coding: utf-8 -*-
from PyQt5.QtGui import *
from PyQt5.QtCore import *
from PyQt5.QtWidgets import *
import sys
class EventFilter(QDialog):
? ? def __init__(self, parent=None):
? ? ? ? super(EventFilter, self).__init__(parent)
? ? ? ? self.setWindowTitle("事件過濾器")
? ? ? ? self.label1 = QLabel("請點擊")
? ? ? ? self.label2 = QLabel("請點擊")
? ? ? ? self.label3 = QLabel("請點擊")
? ? ? ? self.LabelState = QLabel("test")
? ? ? ? self.image1 = QImage("images/cartoon1.ico")
? ? ? ? self.image2 = QImage("images/cartoon1.ico")
? ? ? ? self.image3 = QImage("images/cartoon1.ico")
? ? ? ? self.width = 600
? ? ? ? self.height = 300
? ? ? ? self.resize(self.width, self.height)
? ? ? ? # self.label1.installEventFilter(self)
? ? ? ? # self.label2.installEventFilter(self)
? ? ? ? # self.label3.installEventFilter(self)
? ? ? ? mainLayout = QGridLayout(self)
? ? ? ? mainLayout.addWidget(self.label1, 500, 0)
? ? ? ? mainLayout.addWidget(self.label2, 500, 1)
? ? ? ? mainLayout.addWidget(self.label3, 500, 2)
? ? ? ? mainLayout.addWidget(self.LabelState, 600, 1)
? ? ? ? self.setLayout(mainLayout)
? ? def eventFilter(self, watched, event):
? ? ? ? print(type(watched))
? ? ? ? if watched == self.label1: # 只對label1的點擊事件進行過濾，重寫其行為，其他的事件會被忽略
? ? ? ? ? ? if event.type() == QEvent.MouseButtonPress: # 這里對鼠標按下事件進行過濾，重寫其行為
? ? ? ? ? ? ? ? mouseEvent = QMouseEvent(event)
? ? ? ? ? ? ? ? if mouseEvent.buttons() == Qt.LeftButton:
? ? ? ? ? ? ? ? ? ? self.LabelState.setText("按下鼠標左鍵")
? ? ? ? ? ? ? ? elif mouseEvent.buttons() == Qt.MidButton:
? ? ? ? ? ? ? ? ? ? self.LabelState.setText("按下鼠標中間鍵")
? ? ? ? ? ? ? ? elif mouseEvent.buttons() == Qt.RightButton:
? ? ? ? ? ? ? ? ? ? self.LabelState.setText("按下鼠標右鍵")
? ? ? ? ? ? ? ? '''轉換圖片大小'''
? ? ? ? ? ? ? ? transform = QTransform()
? ? ? ? ? ? ? ? transform.scale(0.5, 0.5)
? ? ? ? ? ? ? ? tmp = self.image1.transformed(transform)
? ? ? ? ? ? ? ? self.label1.setPixmap(QPixmap.fromImage(tmp))
? ? ? ? ? ? if event.type() == QEvent.MouseButtonRelease: # 這里對鼠標釋放事件進行過濾，重寫其行為
? ? ? ? ? ? ? ? self.LabelState.setText("釋放鼠標按鈕")
? ? ? ? ? ? ? ? self.label1.setPixmap(QPixmap.fromImage(self.image1))
? ? ? ? return QDialog.eventFilter(self, watched, event) # 其他情況會返回系統默認的事件處理方法。
if __name__ == '__main__':
? ? app = QApplication(sys.argv)
? ? dialog = EventFilter()
? ? app.installEventFilter(dialog)
? ? dialog.show()
? ? sys.exit(app.exec_())
2.5、重新實現QApplication的notify()方法
PyQt使用notify()來分發事件，要想在任何事件處理器之前捕獲事件，唯一的方法就是重新實現QApplication的notify()，在實踐中，在調試時才會使用這種方法，實際中基本用不多，這里不再贅述了。
