PyQT5開發之自定義信號與槽函數詳解

OpenCV學堂 2023-02-20 21:58

2026 Siemens EDA Forum 七大核心環節全景解析 4周搞定BLE/Wi?Fi/NFC，從選型到首例工程

點擊上方藍字關注我們

微信公眾號：OpenCV開發者聯盟
關注獲取更多計算機視覺與深度學習知識

引言

前面講各種事件響應的時候說過一些關于信號與槽的綁定，實現相關的事件響應，但是并沒有深入跟詳細的介紹，之前的事件信號基本上都是QT的build-in信號，響應的槽函數基本上都是用戶自定義的函數，本文將會詳細介紹Qt的信號與槽交流機制。

元對象系統

PyQT5中QGUI中當用戶改動一個QWidget的狀態時，可以通過支持的信號觸發相關的槽函數完成動作交互。其它的GUI庫多數都是通過Callback(回調)實現消息傳遞與觸發，QT的這種方法在更廣泛的層面是它底層的元數據對象系統（Meta-Object System ）。元數據對象系統提供了信號與槽機制在不同的對象內容交互數據與信息，元數據對象支持信號與槽機制主要依賴：

- 所有的QWidget對象都是QObject類都是元數據- C++使用Q_OBJECT宏定義在私有變量中的類才是元數據- 元數據對象編譯器會提供QObject類子類完成必要的代碼實現元對象特性

信號與槽

信號與槽機制中在GUI層面的信號主要是指靠用戶觸發特定事件產生，所以QWidget對象不同GUI組件預定義了大量的內置信號，開發者在使用這些QWidget組件時只要把這些信號綁定到自定義的槽函數即可實現特定事件的響應觸發特定方法。任意一個綁定信號的響應函數都可以被稱為槽函數，槽函數跟信號是松散耦合的關系，只有當槽函數被鏈接到特定信號的時候它才會響應特定事件。一個槽函數可以被鏈接到多個信號實現響應，同樣一個信號可以被不同的槽函數鏈接。信號與槽是QT編程架構中最重要的組件之一。

信號

PyQT5中的信號分為兩種一種是build-in的信號，主要是跟不同QWidget組件產生特定關聯，比如valueChanged、toggled、clicked等這些信號；另外一類信號是開發者自定義信號，這些信號可以幫助開發者實現數據交互、特定界面刷新、在不同線程之間傳遞消息等等。builid-in的信號不需要開發者激發，開發者只要綁定到特定的槽函數即可實現在動作響應時自定激發；自定義信號必須通過顯式調用的方式激發：

custom_signal.emit(parameters)

槽函數

任何一個正常的函數都可以成為槽函數，類的實例方法通過信號鏈接成為槽函數之后被直接調用而不需要開發者再初始類實例代碼。相比直接通過接口回調的方式，信號與槽架構方式帶來了很大的靈活性，但是同時也會帶來更多的執行調用時間，QT官方文檔指出這樣方法相比回調響應過程會慢一點。

代碼演示部分

代碼演示部分只演示自定義信號跟自定義槽函數是如何工作的，build-in信號跟自定義槽函數在之前的文章中實際已經演示了很多次，這里不在重復代碼演示。數據類含有自定義信號

 1class?MyTextData(QtCore.QObject):
 2????fire_draw_text_signal?=?QtCore.pyqtSignal(str)
 3
 4????def?__init__(self):
 5????????super(MyTextData,?self).__init__()
 6????????print("create?my?text...")
 7????????self.text_content?=?"OpenCV開發者聯盟"
 8
 9????def?text_changed(self,?text):
10????????self.text_content?=?text
11????????self.fire_draw_text_signal.emit(self.text_content)

初始化，綁定自定義信號與自定義槽函數

1#?初始化自定義數據類
2self.my_data?=?MyTextData()
3self.my_data.fire_draw_text_signal.connect(self.show_text)
4self.my_data.text_changed("自定義信號演示")

自定義槽函數

 1def?show_text(self,?text):
 2????painter?=?QtGui.QPainter(self.label.pixmap())
 3????pen?=?QtGui.QPen(QtCore.Qt.green)
 4????painter.setPen(pen)
 5????font?=?QtGui.QFont()
 6????font.setBold(True)
 7????font.setPointSizeF(24)
 8????painter.setFont(font)
 9????painter.drawText(QtCore.QPoint(20,?50),?"OpenCV演示-"?+?text)
10????painter.end()

觸發與調用

 1def?on_update_gray(self):
 2????image?=?cv.imread("images/test5.png")
 3????gray?=?cv.cvtColor(image,?cv.COLOR_BGR2GRAY)
 4????dst?=?cv.cvtColor(gray,?cv.COLOR_GRAY2RGB)
 5????height,?width,?channel?=?dst.shape
 6????bytesPerLine?=?3?*?width
 7????img?=?QtGui.QImage(dst.data,?width,?height,?bytesPerLine,?QtGui.QImage.Format_RGB888)
 8????pixmap?=?QtGui.QPixmap(img)
 9????pix?=?pixmap.scaled(QtCore.QSize(620,?500),?QtCore.Qt.KeepAspectRatio)
10????self.label.setPixmap(pix)
11????self.my_data.text_changed("圖像灰度化")