PyQt5教程(四)——事件与信号

原文：http://zetcode.com/gui/pyqt5/eventssignals/

在这部分教程中咱们将探讨在程序内部发生的事件与信号。

事件

全部的GUI程序都是事件驱动的。事件主要由用户触发，但也可能有其余触发方式：例如网络链接、window manager或定时器。当咱们调用QApplication的exec_()方法时会使程序进入主循环。主循环会获取并分发事件。

在事件模型中有三个参与者：

• 事件源
• 事件(对象)
• 事件接收者

事件源是状态发生变化的对象。它会生成事件。事件(对象)封装了事件源中状态的变更。事件接收者是要通知的对象。事件源对象将事件处理的工做交给事件接收者。

PyQt5有一个独特的signal&slot(信号槽)机制来处理事件。信号槽用于对象间的通讯。signal在某一特定事件发生时被触发，slot能够是任何callable对象。当signal触发时会调用与之相连的slot。

Signals & slots

这是一个演示PyQt5信号槽的简单示例。

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

"""
ZetCode PyQt5 tutorial 

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

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

import sys
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import (QWidget, QLCDNumber, QSlider, 
    QVBoxLayout, QApplication)


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

        vbox = 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()
        

if __name__ == '__main__':
    
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

这个例子中展现了一个QtGui.QLCDNumber和QtGui.QSlider。lcd的值会随着滑块的拖动而改变。

sld.valueChanged.connect(lcd.display)

在这里咱们将滑动条的valueChanged信号链接到lcd的display插槽。

sender是发出信号的对象。receiver是接收信号的对象。slot(插槽)是对信号作出反应的方法。

从新实现事件处理器

在PyQt5中常经过从新实现事件处理器来处理事件。

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

"""
ZetCode PyQt5 tutorial 

In this example, we reimplement an 
event handler. 

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

import sys
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import QWidget, QApplication


class Example(QWidget):
    
    def __init__(self):
        super().__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() == Qt.Key_Escape:
            self.close()
        
        
if __name__ == '__main__':
    
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

在示例中咱们从新实现了keyPressEvent()事件处理器。

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

咱们按下Escape键会使程序退出。

事件发送者

有时须要知道信号是由哪一个控件发起的。对此PyQt5提供了sender()方法。

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

"""
ZetCode PyQt5 tutorial 

In this example, we determine the event sender
object.

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

import sys
from PyQt5.QtWidgets import QMainWindow, QPushButton, QApplication


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

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

        btn2 = 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')
        
        
if __name__ == '__main__':
    
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

咱们建立了两个按钮。在buttonClicked()方法中经过调用sender()方法来判断当前按下的是哪一个按钮。

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

两个按钮链接到了同一个插槽。

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

咱们经过调用sender()方法来判断信号源， 并将其名称显示在窗体的状态栏中。

发出信号

经过QObject建立的对象能够发出信号。下面的示例演示了如何发出自定义信号。

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

"""
ZetCode PyQt5 tutorial 

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

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

import sys
from PyQt5.QtCore import pyqtSignal, QObject
from PyQt5.QtWidgets import QMainWindow, QApplication


class Communicate(QObject):
    
    closeApp = pyqtSignal() 
    

class Example(QMainWindow):
    
    def __init__(self):
        super().__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()
        
        
if __name__ == '__main__':
    
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

咱们建立了一个名为closeApp的信号。这个信号会在按下鼠标时触发，它链接着QMainWindow的close()插槽。

class Communicate(QObject):
    
    closeApp = pyqtSignal()

信号closeApp是Communicate的类属性，它由pyqtSignal()建立。

self.c = Communicate()
self.c.closeApp.connect(self.close)

自定义信号closeApp链接着QMainWindow的close()插槽。

def mousePressEvent(self, event):
    
    self.c.closeApp.emit()

当在窗体上点击鼠标时会触发closeApp信号，使程序退出。

咱们在这部分教程中介绍了PyQt5的信号槽机制。