在PyQt4中的事件和訊號

事件

所有的GUI應用都是事件驅動的。事件主要是來自於應用的使用者，但是像網際網路連線，視窗管理器或者計時器也可以產生事件。當我們呼叫應用的exec_()方法時，應用就進入了主迴圈。主迴圈將抓取事件並且將其傳送到對應的物件中去。

在事件模型中，有三個參與者：

1. 事件源
2. 事件物件
3. 事件目標

事件源是改變狀態的物件。它生成事件。事件物件囊括了在事件源中狀態的改變情況。事件目標是將要通知的物件，事件源通過事件來操控事件物件。

PyQ4有獨一無二的訊號和槽機制去處理事件。訊號和槽被用於在兩個物件間進行交流的。。當特定的事件發生時，訊號被髮出。一個槽可以被任何物件呼叫。當訊號發出並連線到槽時，槽被呼叫。

新的API

PyQt4.5有一種新式的API用來處理訊號和槽。

QtCore.QObject.connect(button, QtCore.SIGNAL('clicked()'), self.onClicked)

這是舊式的API

下面是新式的API

button.clicked.connect(self.onClicked)

訊號和槽

下面是一個使用訊號和槽的簡單示範例子

#!/usr/bin/python
# -*- coding: utf-8 -*-

"""
ZetCode PyQt4 tutorial 

In this example, we connect a signal
of a QtGui.QSlider to a slot 
of a QtGui.QLCDNumber. 

author: Jan Bodnar
website: zetcode.com 
last edited: October 2011
"""

import sys
from PyQt4 import QtGui, QtCore


class Example(QtGui.QWidget):
    
    def __init__(self):
        super(Example, self).__init__()
        
        self.initUI()
        
    def initUI(self):
        
        lcd = QtGui.QLCDNumber(self)
        sld = QtGui.QSlider(QtCore.Qt.Horizontal, self)

        vbox = QtGui.QVBoxLayout()
        vbox.addWidget(lcd)
        vbox.addWidget(sld)

        self.setLayout(vbox)
        sld.valueChanged.connect(lcd.display)
        
        self.setGeometry(300, 300, 250, 150)
        self.setWindowTitle('Signal & slot')
        self.show()
        
def main():
    
    app = QtGui.QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()
 

執行後如下圖

在這個例子中，我們展示了QtGui.QLCDNumber和QtGui.QSlider，我們通過滑動小塊來改變lcd的值

sld.valueChanged.connect(lcd.display)

在這裡我們連線了一個滑塊的valueChanged訊號到lcd的display槽。

"sender"是一個傳送訊號的物件。"receiver"是接受訊號的物件。"slot"是對訊號起反應的方法。

事件過載管理者(Reimplementing event handler)

在PyQt4裡的事件常常是被事件過載管理者進行過加工的。

#!/usr/bin/python
# -*- coding: utf-8 -*-

"""
ZetCode PyQt4 tutorial 

In this example, we reimplement an 
event handler. 

author: Jan Bodnar
website: zetcode.com 
last edited: October 2011
"""

import sys
from PyQt4 import QtGui, QtCore


class Example(QtGui.QWidget):
    
    def __init__(self):
        super(Example, self).__init__()
        
        self.initUI()
        
    def initUI(self):      
        
        self.setGeometry(300, 300, 250, 150)
        self.setWindowTitle('Event handler')
        self.show()
        
    def keyPressEvent(self, e):
        
        if e.key() == QtCore.Qt.Key_Escape:
            self.close()
        
def main():
    
    app = QtGui.QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()
 

在我們的例子裡，我們對keyPressEvent()進行了過載。

def keyPressEvent(self, e):
    
    if e.key() == QtCore.Qt.Key_Escape:
        self.close()

當我們按下“ESC”時，我們的應用會被關閉。

事件傳送器

有些時候我們需要知道是哪個控制元件傳送了訊號。基於此，PyQt4有sender()方法

#!/usr/bin/python
# -*- coding: utf-8 -*-

"""
ZetCode PyQt4 tutorial 

In this example, we determine the event sender
object.

author: Jan Bodnar
website: zetcode.com 
last edited: October 2011
"""

import sys
from PyQt4 import QtGui, QtCore


class Example(QtGui.QMainWindow):
    
    def __init__(self):
        super(Example, self).__init__()
        
        self.initUI()
        
    def initUI(self):      

        btn1 = QtGui.QPushButton("Button 1", self)
        btn1.move(30, 50)

        btn2 = QtGui.QPushButton("Button 2", self)
        btn2.move(150, 50)
      
        btn1.clicked.connect(self.buttonClicked)            
        btn2.clicked.connect(self.buttonClicked)
        
        self.statusBar()
        
        self.setGeometry(300, 300, 290, 150)
        self.setWindowTitle('Event sender')
        self.show()
        
    def buttonClicked(self):
      
        sender = self.sender()
        self.statusBar().showMessage(sender.text() + ' was pressed')
        
def main():
    
    app = QtGui.QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

在我們的例子裡，我們有兩個按鈕。在buttonClicked()方法裡我們通過呼叫senter()方法來確定是哪個按鈕被按下了。

btn1.clicked.connect(self.buttonClicked)            
btn2.clicked.connect(self.buttonClicked)

兩個按鈕被連線到了相同的槽

def buttonClicked(self):
  
    sender = self.sender()
    self.statusBar().showMessage(sender.text() + ' was pressed')

我們通過呼叫senter()方法確定了訊號源。在這個應用的狀態列，我們顯示了是哪個按鈕被按下。

如圖

產生訊號

通過QtCore.QObject建立的物件可以產生訊號。在下面的例子裡我們將看到如何產生特定的訊號

#!/usr/bin/python
# -*- coding: utf-8 -*-

"""
ZetCode PyQt4 tutorial 

In this example, we show how to emit a
signal. 

author: Jan Bodnar
website: zetcode.com 
last edited: January 2015
"""

import sys
from PyQt4 import QtGui, QtCore


class Communicate(QtCore.QObject):
    
    closeApp = QtCore.pyqtSignal() 
    

class Example(QtGui.QMainWindow):
    
    def __init__(self):
        super(Example, self).__init__()
        
        self.initUI()
        
        
    def initUI(self):      

        self.c = Communicate()
        self.c.closeApp.connect(self.close)       
        
        self.setGeometry(300, 300, 290, 150)
        self.setWindowTitle('Emit signal')
        self.show()
        
        
    def mousePressEvent(self, event):
        
        self.c.closeApp.emit()
        
        
def main():
    
    app = QtGui.QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

我們建立了一個叫closeApp的訊號。當有滑鼠點選事件發生的時候訊號觸發。訊號連線到了QtGui.QMainWindow的close()槽。

class Communicate(QtCore.QObject):
    
    closeApp = QtCore.pyqtSignal()    

當我們點選視窗時，closeApp訊號被觸發，應用關閉。

在這部分，我們講了訊號和槽。