事件和信号

事件

signals and slots 被其他人翻译成信号和槽机制，(⊙o⊙)…我这里还是不翻译好了。

所有的应用都是事件驱动的。事件大部分都是由用户的行为产生的，当然也有其他的事件产生方式，比如网络的连接，窗口管理器或者定时器等。调用应用的exec_()方法时，应用会进入主循环，主循环会监听和分发事件。

在事件模型中，有三个角色：

  • 事件源
  • 事件
  • 事件目标

事件源就是发生了状态改变的对象。事件是这个对象状态改变的内容。事件目标是事件想作用的目标。事件源绑定事件处理函数，然后作用于事件目标身上。

PyQt5处理事件方面有个signal and slot机制。Signals and slots用于对象间的通讯。事件触发的时候，发生一个signal，slot是用来被Python调用的（相当于一个句柄？这个词也好恶心，就是相当于事件的绑定函数）slot只有在事件触发的时候才能调用。

Signals & slots

下面是signal & slot的演示

  1. #!/usr/bin/python3
  2. # -*- coding: utf-8 -*-
  4. """
  5. ZetCode PyQt5 tutorial 
  7. In this example, we connect a signal
  8. of a QSlider to a slot of a QLCDNumber. 
  10. Author: Jan Bodnar
  11. Website: zetcode.com 
  12. Last edited: January 2017
  13. """
  15. import sys
  16. from PyQt5.QtCore import Qt
  17. from PyQt5.QtWidgets import (QWidget, QLCDNumber, QSlider, 
  18.     QVBoxLayout, QApplication)
  21. class Example(QWidget):
  23.     def __init__(self):
  24.         super().__init__()
  26.         self.initUI()
  29.     def initUI(self):
  31.         lcd = QLCDNumber(self)
  32.         sld = QSlider(Qt.Horizontal, self)
  34.         vbox = QVBoxLayout()
  35.         vbox.addWidget(lcd)
  36.         vbox.addWidget(sld)
  38.         self.setLayout(vbox)
  39.         sld.valueChanged.connect(lcd.display)
  41.         self.setGeometry(300, 300, 250, 150)
  42.         self.setWindowTitle('Signal and slot')
  43.         self.show()
  46. if __name__ == '__main__':
  48.     app = QApplication(sys.argv)
  49.     ex = Example()
  50.     sys.exit(app.exec_())

上面的例子中，显示了QtGui.QLCDNumber和QtGui.QSlider模块，我们能拖动滑块让数字跟着发生改变。

  1. sld.valueChanged.connect(lcd.display)

这里是把滑块的变化和数字的变化绑定在一起。

sender是信号的发送者，receiver是信号的接收者，slot是对这个信号应该做出的反应。

程序展示：

signal & slot

重构事件处理器

在PyQt5中，事件处理器经常被重写（也就是用自己的覆盖库自带的）。

  1. #!/usr/bin/python3
  2. # -*- coding: utf-8 -*-
  4. """
  5. ZetCode PyQt5 tutorial 
  7. In this example, we reimplement an 
  8. event handler. 
  10. Author: Jan Bodnar
  11. Website: zetcode.com 
  12. Last edited: August 2017
  13. """
  15. import sys
  16. from PyQt5.QtCore import Qt
  17. from PyQt5.QtWidgets import QWidget, QApplication
  19. class Example(QWidget):
  21.     def __init__(self):
  22.         super().__init__()
  24.         self.initUI()
  27.     def initUI(self):      
  29.         self.setGeometry(300, 300, 250, 150)
  30.         self.setWindowTitle('Event handler')
  31.         self.show()
  34.     def keyPressEvent(self, e):
  36.         if e.key() == Qt.Key_Escape:
  37.             self.close()
  40. if __name__ == '__main__':
  42.     app = QApplication(sys.argv)
  43.     ex = Example()
  44.     sys.exit(app.exec_())

这个例子中，我们替换了事件处理器函数keyPressEvent()。

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

此时如果按下ESC键程序就会退出。

程序展示：

这个就一个框，啥也没，就不展示了。

事件对象

事件对象是用python来描述一系列的事件自身属性的对象。

  1. #!/usr/bin/python3
  2. # -*- coding: utf-8 -*-
  4. """
  5. ZetCode PyQt5 tutorial 
  7. In this example, we display the x and y 
  8. coordinates of a mouse pointer in a label widget.
  10. Author: Jan Bodnar
  11. Website: zetcode.com 
  12. Last edited: August 2017
  13. """
  15. import sys
  16. from PyQt5.QtCore import Qt
  17. from PyQt5.QtWidgets import QWidget, QApplication, QGridLayout, QLabel
  19. class Example(QWidget):
  21.     def __init__(self):
  22.         super().__init__()
  24.         self.initUI()
  27.     def initUI(self):      
  29.         grid = QGridLayout()
  30.         grid.setSpacing(10)
  32.         x = 0
  33.         y = 0
  35.         self.text = "x: {0},  y: {1}".format(x, y)
  37.         self.label = QLabel(self.text, self)
  38.         grid.addWidget(self.label, 0, 0, Qt.AlignTop)
  40.         self.setMouseTracking(True)
  42.         self.setLayout(grid)
  44.         self.setGeometry(300, 300, 350, 200)
  45.         self.setWindowTitle('Event object')
  46.         self.show()
  49.     def mouseMoveEvent(self, e):
  51.         x = e.x()
  52.         y = e.y()
  54.         text = "x: {0},  y: {1}".format(x, y)
  55.         self.label.setText(text)
  58. if __name__ == '__main__':
  60.     app = QApplication(sys.argv)
  61.     ex = Example()
  62.     sys.exit(app.exec_())

这个示例中，我们在一个组件里显示鼠标的X和Y坐标。

  1. self.text = "x: {0},  y: {1}".format(x, y)
  3. self.label = QLabel(self.text, self)

X Y坐标显示在QLabel组件里

  1. self.setMouseTracking(True)

事件追踪默认没有开启，当开启后才会追踪鼠标的点击事件。

  1. def mouseMoveEvent(self, e):
  3.     x = e.x()
  4.     y = e.y()
  6.     text = "x: {0},  y: {1}".format(x, y)
  7.     self.label.setText(text)

e代表了事件对象。里面有我们触发事件（鼠标移动）的事件对象。x()和y()方法得到鼠标的x和y坐标点，然后拼成字符串输出到QLabel组件里。

程序展示：

event object

事件发送

有时候我们会想知道是哪个组件发出了一个信号，PyQt5里的sender()方法能搞定这件事。

  1. #!/usr/bin/python3
  2. # -*- coding: utf-8 -*-
  4. """
  5. ZetCode PyQt5 tutorial 
  7. In this example, we determine the event sender
  8. object.
  10. Author: Jan Bodnar
  11. Website: zetcode.com 
  12. Last edited: August 2017
  13. """
  15. import sys
  16. from PyQt5.QtWidgets import QMainWindow, QPushButton, QApplication
  19. class Example(QMainWindow):
  21.     def __init__(self):
  22.         super().__init__()
  24.         self.initUI()
  27.     def initUI(self):      
  29.         btn1 = QPushButton("Button 1", self)
  30.         btn1.move(30, 50)
  32.         btn2 = QPushButton("Button 2", self)
  33.         btn2.move(150, 50)
  35.         btn1.clicked.connect(self.buttonClicked)            
  36.         btn2.clicked.connect(self.buttonClicked)
  38.         self.statusBar()
  40.         self.setGeometry(300, 300, 290, 150)
  41.         self.setWindowTitle('Event sender')
  42.         self.show()
  45.     def buttonClicked(self):
  47.         sender = self.sender()
  48.         self.statusBar().showMessage(sender.text() + ' was pressed')
  51. if __name__ == '__main__':
  53.     app = QApplication(sys.argv)
  54.     ex = Example()
  55.     sys.exit(app.exec_())

这个例子里有俩按钮，buttonClicked()方法决定了是哪个按钮能调用sender()方法。

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

两个按钮都和同一个slot绑定。

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

我们用调用sender()方法的方式决定了事件源。状态栏显示了被点击的按钮。

程序展示：

event sender

信号发送

QObject实例能发送事件信号。下面的例子是发送自定义的信号。

  1. #!/usr/bin/python3
  2. # -*- coding: utf-8 -*-
  4. """
  5. ZetCode PyQt5 tutorial 
  7. In this example, we show how to 
  8. emit a custom signal. 
  10. Author: Jan Bodnar
  11. Website: zetcode.com 
  12. Last edited: August 2017
  13. """
  15. import sys
  16. from PyQt5.QtCore import pyqtSignal, QObject
  17. from PyQt5.QtWidgets import QMainWindow, QApplication
  20. class Communicate(QObject):
  22.     closeApp = pyqtSignal() 
  25. class Example(QMainWindow):
  27.     def __init__(self):
  28.         super().__init__()
  30.         self.initUI()
  33.     def initUI(self):      
  35.         self.c = Communicate()
  36.         self.c.closeApp.connect(self.close)       
  38.         self.setGeometry(300, 300, 290, 150)
  39.         self.setWindowTitle('Emit signal')
  40.         self.show()
  43.     def mousePressEvent(self, event):
  45.         self.c.closeApp.emit()
  48. if __name__ == '__main__':
  50.     app = QApplication(sys.argv)
  51.     ex = Example()
  52.     sys.exit(app.exec_())

我们创建了一个叫closeApp的信号，这个信号会在鼠标按下的时候触发，事件与QMainWindow绑定。

  1. class Communicate(QObject):
  3.     closeApp = pyqtSignal()

Communicate类创建了一个pyqtSignal()属性的信号。

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

closeApp信号QMainWindow的close()方法绑定。

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

点击窗口的时候，发送closeApp信号，程序终止。

程序展示：

这个也是啥也没。