pyqt5自訂訊號執行個體解析，pyqt5自訂執行個體

pyqt5自訂訊號執行個體解析，pyqt5自訂執行個體

本文研究的主要是pyqt5自訂訊號執行個體解析的相關內容，具體介紹如下。

PyQt5已經自動定義了很多QT內建的訊號。但是在實際的使用中為了靈活使用訊號與槽機制，我們可以根據需要自訂signal。可以使用pyqtSignal()方法定義新的訊號，新的訊號作為類的屬性。

自訂signal說明：

pyqtSignal()方法原型（PyQt官網的定義）：

PyQt5.QtCore.pyqtSignal(types[, name[, revision=0[, arguments=[]]]])
Create one or more overloaded unbound signals as a class attribute.

Parameters:
types – the types that define the C++ signature of the signal. Each type may be a Python type object or a string that is the name of a C++ type. Alternatively each may be a sequence of type arguments. In this case each sequence defines the signature of a different signal overload. The first overload will be the default.

name – the name of the signal. If it is omitted then the name of the class attribute is used. This may only be given as a keyword argument.

revision – the revision of the signal that is exported to QML. This may only be given as a keyword argument.

arguments – the sequence of the names of the signal's arguments that is exported to QML. This may only be given as a keyword argument.
Return type: an unbound signal

新的訊號應該定義在QObject的子類中。新的訊號必須作為定義類的一部分，不允許將訊號作為類的屬性在類定義之後通過動態方式進行添加。通過這種方式新的訊號才能自動的添加到QMetaObject類中。這就意味這新定義的訊號將會出現在Qt Designer，並且可以通過QMetaObject API實現內省。

通過下面的例子，瞭解一下關於signal的定義：

from PyQt5.QtCore import QObject, pyqtSignalclass NewSignal(QObject):  # 定義了一個“closed”訊號，該訊號沒有參資料  closed= pyqtSignal()  # 定義了一個"range_changed"訊號，該訊號有兩個int類型的參數  range_changed = pyqtSignal(int, int, name='rangeChanged')

自訂訊號的發射，通過emit()方法類實現，具體參見該函數的原型：

emit(*args)
Parameters: args – the optional sequence of arguments to pass to any connected slots.

通過下面的例子，瞭解一下關於emit()的使用：

from PyQt5.QtCore import QObject, pyqtSignalclass NewSignal(QObject):  # 一個valueChanged的訊號，該訊號沒有參數.  valueChanged = pyqtSignal()  def connect_and_emit_valueChanged(self):    # 綁定訊號和槽函數    self.valueChanged.connect(self.handle_valueChanged)    # 發射訊號.    self.trigger.emit()  def handle_valueChanged(self):    print("trigger signal received")

樣本說明：

自訂訊號的一般流程如下：

1、定義訊號
2、定義槽函數
3、綁定訊號和槽
4、發射訊號

通過程式碼範例來瞭解一下訊號的自訂過程：

#-*- coding:utf-8 -*-'''defined Signal'''__author__ = 'Tony Zhu'import sysfrom PyQt5.QtCore import pyqtSignal, QObject, Qt, pyqtSlotfrom PyQt5.QtWidgets import QWidget, QApplication, QGroupBox, QPushButton, QLabel, QCheckBox, QSpinBox, QHBoxLayout, QComboBox, QGridLayoutclass SignalEmit(QWidget):  helpSignal = pyqtSignal(str)  printSignal = pyqtSignal(list)  #聲明一個多重載版本的訊號，包括了一個帶int和str型別參數的訊號，以及帶str參數的訊號  previewSignal = pyqtSignal([int,str],[str])  def __init__(self):    super().__init__()        self.initUI()  def initUI(self):          self.creatContorls("列印控制：")    self.creatResult("操作結果：")    layout = QHBoxLayout()    layout.addWidget(self.controlsGroup)    layout.addWidget(self.resultGroup)    self.setLayout(layout)    self.helpSignal.connect(self.showHelpMessage)    self.printSignal.connect(self.printPaper)    self.previewSignal[str].connect(self.previewPaper)    self.previewSignal[int,str].connect(self.previewPaperWithArgs)     self.printButton.clicked.connect(self.emitPrintSignal)    self.previewButton.clicked.connect(self.emitPreviewSignal)    self.setGeometry(300, 300, 290, 150)    self.setWindowTitle('defined signal')    self.show()  def creatContorls(self,title):    self.controlsGroup = QGroupBox(title)    self.printButton = QPushButton("列印")    self.previewButton = QPushButton("預覽")    numberLabel = QLabel("列印份數：")    pageLabel = QLabel("紙張類型：")    self.previewStatus = QCheckBox("全屏預覽")    self.numberSpinBox = QSpinBox()    self.numberSpinBox.setRange(1, 100)    self.styleCombo = QComboBox(self)    self.styleCombo.addItem("A4")    self.styleCombo.addItem("A5")    controlsLayout = QGridLayout()    controlsLayout.addWidget(numberLabel, 0, 0)    controlsLayout.addWidget(self.numberSpinBox, 0, 1)    controlsLayout.addWidget(pageLabel, 0, 2)    controlsLayout.addWidget(self.styleCombo, 0, 3)    controlsLayout.addWidget(self.printButton, 0, 4)    controlsLayout.addWidget(self.previewStatus, 3, 0)    controlsLayout.addWidget(self.previewButton, 3, 1)    self.controlsGroup.setLayout(controlsLayout)  def creatResult(self,title):    self.resultGroup = QGroupBox(title)    self.resultLabel = QLabel("")    layout = QHBoxLayout()    layout.addWidget(self.resultLabel)    self.resultGroup.setLayout(layout)  def emitPreviewSignal(self):    if self.previewStatus.isChecked() == True:      self.previewSignal[int,str].emit(1080," Full Screen")    elif self.previewStatus.isChecked() == False:      self.previewSignal[str].emit("Preview")  def emitPrintSignal(self):    pList = []    pList.append(self.numberSpinBox.value ())    pList.append(self.styleCombo.currentText())    self.printSignal.emit(pList)  def printPaper(self,list):    self.resultLabel.setText("Print: "+"份數："+ str(list[0]) +" 紙張："+str(list[1]))  def previewPaperWithArgs(self,style,text):    self.resultLabel.setText(str(style)+text)  def previewPaper(self,text):    self.resultLabel.setText(text)       def keyPressEvent(self, event):    if event.key() == Qt.Key_F1:      self.helpSignal.emit("help message")  def showHelpMessage(self,message):    self.resultLabel.setText(message)    #self.statusBar().showMessage(message)if __name__ == '__main__':  app = QApplication(sys.argv)  dispatch = SignalEmit()  sys.exit(app.exec_())

運行該函數之後的效果如下：

樣本說明：

通過一個類比列印的介面來詳細說明一下關於訊號的自訂，在列印的時候可以設定列印的分數，紙張類型，觸發“列印”按鈕之後，將執行結果顯示到右側；通過全屏預覽QCheckBox來選擇是否通過全螢幕模式進行預覽，將執行結果顯示到右側。
通過點擊F1快速鍵，可以顯示helpMessage資訊。

程式碼分析：

L12~15：

  helpSignal = pyqtSignal(str)  printSignal = pyqtSignal(list)  #聲明一個多重載版本的訊號，包括了一個帶int和str型別參數的訊號，以及帶str參數的訊號  previewSignal = pyqtSignal([int,str],[str])

通過pyqtSignal()定義了三個訊號，helpSignal ，printSignal ，previewSignal 。其中：

helpSignal 為str參數類型的訊號；

printSignal 為list參數類型的訊號；

previewSignal為一個多重載版本的訊號，包括了一個帶int和str型別參數的訊號，以及str類行的參數。

self.helpSignal.connect(self.showHelpMessage)self.printSignal.connect(self.printPaper)self.previewSignal[str].connect(self.previewPaper)    self.previewSignal[int,str].connect(self.previewPaperWithArgs)     self.printButton.clicked.connect(self.emitPrintSignal)    self.previewButton.clicked.connect(self.emitPreviewSignal)

綁定訊號和槽；著重說明一下多重載版本的訊號的綁定，previewSignal有兩個版本previewSignal(str)，previewSignal(int,str)。由於存在兩個版本，從因此在綁定的時候需要顯式的指定訊號和槽的綁定關係。

具體如下：

self.previewSignal[str].connect(self.previewPaper) self.previewSignal[int,str].connect(self.previewPaperWithArgs)

其中[str]參數的previewSignal訊號綁定previewPaper();[int,str]的previewSignal訊號綁定previewPaperWithArgs()

L72~76:

  def emitPreviewSignal(self):    if self.previewStatus.isChecked() == True:      self.previewSignal[int,str].emit(1080," Full Screen")    elif self.previewStatus.isChecked() == False:      self.previewSignal[str].emit("Preview")

多重載版本的訊號的發射也需要制定對應發射的版本，類似同訊號的版定。

L78~82：

  def emitPrintSignal(self):    pList = []    pList.append(self.numberSpinBox.value ())    pList.append(self.styleCombo.currentText())    self.printSignal.emit(pList)

如代碼中所示，在訊號發射的時候可以傳遞python資料類型的參數，在本例中傳遞list類型的參數pList.

L93~96：

  def keyPressEvent(self, event):    if event.key() == Qt.Key_F1:      self.helpSignal.emit("help message")

通過複寫keyPressEvent()方法，將F1快速鍵進行功能的拓展。在windows的大部分應用，我們都會使用一些快速鍵來快速的完成某些特定的功能。比如F1鍵，會快速調出協助介面。那我們就可以複寫keyPressEvent()方法來類比發送所需的訊號，來完成我們的對應任務.

注意事項：

1、自訂的訊號在init()函數之前定義；
2、自訂型號可以傳遞，str、int、list、object、float、tuple、dict等很多類型的參數；
3、注意signal和slot的調用邏輯，避免signal和slot之間出現死迴圈。如在slot方法中繼續發射該訊號；

總結

以上就是本文關於pyqt5自訂訊號執行個體解析的全部內容，希望對大家有所協助。感興趣的朋友可以繼續參閱本站其他相關專題，如有不足之處，歡迎留言指出。感謝朋友們對本站的支援！