python GUI庫圖形界面開發之PyQt5信號與槽事件處理機制詳細介紹與實例解析

發布時間：2020-09-15 17:18:15 來源：腳本之家閱讀：191 作者：jia666666 欄目：開發技術

PyQt5中信號與槽可以說是對事件處理機制的高級封裝，如果說事件是用來創建窗口控件的，那么信號與槽就是用來對這個控件進行使用的，比如一個按鈕，當我們使用按鈕時，只關心clicked信號，至于這個按鈕如何接受并處里鼠標點擊事件，然后在發射這個信號，則不關心，但是如果要重載一個按鈕，這時候就要關心了，比如可以改變它的行為：在鼠標按下時觸發clicked信號，而不是釋放時

PyQt5常見事件類型

pyqt是對Qt的封裝，qt程序是事件驅動的，它的每個動作都有幕后某個事件所觸發，Qt事件類型有很多，常見的如下

鍵盤事件：按鍵的按下與松開
鼠標事件：鼠標指針的移動，鼠標按鍵的按下與松開
拖放事件：用鼠標進行拖放
滾輪事件：鼠標滾輪滾動
繪屏事件：重繪制屏幕的某些部分
定時事件：定時器到時
焦點事件：鍵盤焦點移動
進入和離開事件：鼠標指針移入Widget內，或者移出
移動事件：Widget的位置改變
大小改變事件：widget的大小改變
顯示和隱藏事件：widget顯示與隱藏
窗口事件：窗口是否為當前窗口

還有一些常見的qt事件，比如Socket事件，剪切板事件，字體改變事件，布局改變事件

使用事件處理的方法

pyqt提供如下5中事件處理和過濾的方法（有弱到強），其中只有前兩種方法使用最頻繁

1 、重新實現事件函數

比如mousePressEvent（），keyPressEvent（），paintEvent（），這是最常規的事件處理方法

2 、重新實現QObject.event（）

一般用在pyqt沒有提供該事件的處理函數的情況下，即增加新事件時

3 、安裝事件過濾器

如果對QObject調用installEventFilter，則相當于為這個QObject安裝了一個事件過濾器，對于QObject的全部事件來說，它們都會先傳遞到事件過濾函數eventFilter中，在這個函數中，我們可以拋棄或者修改這些事件，比如對自己感興趣的事件使用自定義的處理機制，對其他事件采用默認的事件處理機制，由于這中方法會調用installEventFilter的所有QObject的事件進行過濾，因此如果要過濾的事件比較多，則會降低程序的性能

4 、在QApplication中安裝事件過濾器

這種方法比上一種更強大，QApplication的事件過濾器將捕獲所有的QObject事件，而且第一個獲得該事件，也就是說，在將事件發送給其他任何一個事件過濾器之前，都會發送給QApplication的事件過濾器

5 、重新實現QApplication的notify（）方法

pyqt使用notify來分發事件，要想在任何事件處理器之前捕獲事件，唯一的方法就是重新實現QApplication的notify（），在實踐中，在調試才會用這中方法

PyQt5信號與槽事件處理經典案例

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)
    #初始化數據
    #鼠標雙擊False
    self.justDoubleClicked = False
    #按鍵，輸出文本，提示消息為空
    self.key = ""
    self.text = ""
    self.message = ""
    #設置窗口初始大小與位置
    self.resize(400, 300)
    self.move(100, 100)
    #設置標題
    self.setWindowTitle("Events")
    #定時器1秒后執行槽函數
    QTimer.singleShot(1000, self.giveHelp)
    # 避免窗口大小重繪事件的影響，可以把參數0改變成3000（3秒），然后在運行，就可以明白這行代碼的意思。
  def giveHelp(self):
    self.text = "請點擊這里觸發追蹤鼠標功能"
    # 重繪事件，也就是觸發paintEvent函數。
    self.update()
  '''重新實現關閉事件'''
  def closeEvent(self, event):
    print("Closed")
  '''重新實現上下文菜單事件'''
  def contextMenuEvent(self, event):
    #實例化菜單，添加子菜單one two并附加快捷鍵功能，關聯槽函數
    menu = QMenu(self)
    oneAction = menu.addAction("&One")
    twoAction = menu.addAction("&Two")
    oneAction.triggered.connect(self.one)
    twoAction.triggered.connect(self.two)
    #如果message為空,執行
    if not self.message:
      #在菜單中添加一條分割線
      menu.addSeparator()
      #添加自菜單three，關聯槽函數
      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)
    # 若消息文本存在則在底部居中繪制消息，5秒鐘后清空消息文本并重繪。
    if self.message:
      #顯示給定坐標處的文本，坐標，對齊方式。文本內容
      painter.drawText(self.rect(), Qt.AlignBottom | Qt.AlignHCenter,
               self.message)
      #5秒鐘后觸發清空信息的函數，并重新繪制事件
      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()
    #如果key有字符，不為空，則繪制字符
    if self.key:
      self.key = self.key
      self.update()
    #否則就繼續監視這個事件
    else:
      QWidget.keyPressEvent(self, event)
  '''重新實現其他事件，適用于PyQt沒有提供該事件的處理函數的情況，Tab鍵由于涉及焦點切換，不會傳遞給keyPressEvent，因此，需要在這里重新定義。'''
  def event(self, event):
    #如果有按鍵按下，并且按鍵是tab鍵
    if (event.type() == QEvent.KeyPress and
          event.key() == Qt.Key_Tab):
      self.key = "在event()中捕獲Tab鍵"
      self.update()
      return True
    return QWidget.event(self, event)
if __name__ == "__main__":
  app = QApplication(sys.argv)
  form = Widget()
  form.show()
  app.exec_()

代碼解析

首先是類的建立，建立text和message兩個變量，使用painEvent函數把他們輸出到窗口中

update函數的作用是更新窗口，由于窗口更新過程中會觸發一次paineEvent函數（paintEvent是窗口基類QWidget的內部函數），因此在本例中，update函數的作用等同于paintEvent函數

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)
    #初始化數據
    #鼠標雙擊False
    self.justDoubleClicked = False
    #按鍵，輸出文本，提示消息為空
    self.key = ""
    self.text = ""
    self.message = ""
    #設置窗口初始大小與位置
    self.resize(400, 300)
    self.move(100, 100)
    #設置標題
    self.setWindowTitle("Events")
    #定時器1秒后執行槽函數
    QTimer.singleShot(1000, self.giveHelp)
    # 避免窗口大小重繪事件的影響，可以把參數0改變成3000（3秒），然后在運行，就可以明白這行代碼的意思。
  def giveHelp(self):
    self.text = "請點擊這里觸發追蹤鼠標功能"
    # 重繪事件，也就是觸發paintEvent函數。
    self.update()

初始化運行結果如下