PyQt5通过信号实现MVC的示例

时间：2022-11-02 16:37:05

众所周知MVC是个好东西。前阵子网上搜了下，但关于用PyQt5实现MVC的中文文档缺少之又少，优质的文档只搜到了一篇。既然这样，来，开个坑，学习新知识，吸引流量。话说，关于PyQt5，布局那里需要好好看看，容器类控件需要好好看看，还有多线程和自动化测试那块。但要写出完美GUI需要大量的代码经验和文档查询的能力。然后，嗯，这部分坑就填完了。

扯回正题：假设此时面临的场景是，一个软件涉及好几个页面，每个页面是单独的代码。且每个页面需要有自己的controller，最终所有的controller汇总到一起，统一管理。

本文中，文字只是辅助理解，务必读懂代码。

信号

众所周知，GUI中当一个控件的状态改变时需要通知另一个控件，也就是实现了对象间的通信。当事件发生或状态改变时，就会发出信号，信号会触发与这个事件相关联的函数，我们这个函数为槽。信号与槽可以是多对多的关系。信号在类创建时定义，即需要在初始化的前面定义。

自定义信号与槽

别问，静静感受以下代码。以下的代码中，已经包含了信号的定义、指定参数的类型、发射、绑定槽函数等一系列过程。

  1. from PyQt5.QtCore import QObject, pyqtSignal
  2.  
  3. # 信号对象
  4. class QSignal(QObject):
  5. # 定义信号
  6. # 在类创建时定义，不能在类创建后作为类的属性而添加
  7. # 指定信号传递参数的数量，类型等
  8. send_msg = pyqtSignal(str, str)
  9.  
  10. def __init__(self):
  11. super(QSignal, self).__init__()
  12.  
  13. def run(self):
  14. # 信号发射
  15. self.send_msg.emit('First arg', 'Second arg')
  16.  
  17. # 槽对象
  18. class QSlot(QObject):
  19. def __init__(self):
  20. super(QSlot, self).__init__()
  21.  
  22. def get(self, *args):
  23. # 信号接收
  24. print("Get message =>" + args[0], args[1], sep=', ')
  25.  
  26. if __name__ == '__main__':
  27. send = QSignal()
  28. slot = QSlot()
  29.  
  30. # 将信号与槽函数绑定
  31. send.send_msg.connect(slot.get)
  32. # 外部调用 发射信号
  33. send.run()
  34. # 信号与槽解除关联
  35. send.send_msg.disconnect(slot.get)
  36. send.run()

内置信号绑定自定义槽

这样，再来看一个和窗口结合的实例。窗口中有一个按钮，点击按钮就退出窗口。虽然这个例子很简单，不用信号和槽也能实现。但这里给个例子静心感受下：信号连接、发射、接收的全逻辑。

  1. import sys
  2. from functools import partial
  3. from PyQt5.QtCore import pyqtSignal
  4. from PyQt5.QtWidgets import (QMainWindow, QApplication, QPushButton, QWidget,
  5. QHBoxLayout)
  6.  
  7. class MainWindow(QMainWindow):
  8. btn_signal = pyqtSignal()
  9. def __init__(self):
  10. super(MainWindow, self).__init__()
  11.  
  12. a = QPushButton("退出")
  13. # 给绑定的槽函数增加额外信息
  14. a.clicked.connect(partial(self.btn_clicked, 1))
  15. self.btn_signal.connect(self.close)
  16.  
  17. self.setWindowTitle("演示")
  18.  
  19. main_widget = QWidget()
  20. layout = QHBoxLayout()
  21. layout.addWidget(a)
  22. main_widget.setLayout(layout)
  23. # QMainWindow 不能设置布局
  24. self.setCentralWidget(main_widget)
  25.  
  26. def btn_clicked(self, n):
  27. print(n)
  28. self.btn_signal.emit()
  29.  
  30. def close(self):
  31. app = QApplication.instance()
  32. app.quit()
  33.  
  34. if __name__ == "__main__":
  35. # 在shell中执行
  36. app = QApplication(sys.argv)
  37. mywin = MainWindow()
  38. mywin.show()
  39. # 开始主循环，直到退出
  40. sys.exit(app.exec())

这里，想给绑定的槽函数btn_clicked传递额外参数，但信号绑定时不能添加额外参数。对应到上述例子中，close()可以通过指定信号的参数和类型来增加参数，但btn_clicked()不能。一种解决方案是掏出万能的partial函数，将函数和参数绑定在一起。

至此，应该了解了信号的工作方式和原理。而关于信号更多的内容，如重载、装饰器等，这里不做更多介绍，详情参考官方文档。话说，也佩服当年的学习方式：『把所有代码敲一遍』。时至今日也忘记了大多控件的含义和各种样式的代码，变成了：到时候去查API。

MVC

MVC的大名应该都听说过，model, view 和 control，即数据库、页面和处理逻辑相分离，这样写出来的代码更加专一化。这里给份代码感受下，三个内容用三个类所实现，个人不建议这样写，建议将文件放到三个文件夹下，而不是扔进一份代码里：

  1. import sys
  2. from PyQt5 import QtCore
  3. from PyQt5.QtWidgets import (QWidget, QHBoxLayout, QPushButton, QMessageBox,
  4. QLineEdit, QApplication)
  5.  
  6. # View
  7. class MainWindow(QWidget):
  8. verifySignal = QtCore.pyqtSignal()
  9.  
  10. def __init__(self, *args, **kwargs):
  11. super(MainWindow, self).__init__(*args, **kwargs)
  12. self.id_line = QLineEdit()
  13. self.id_line.setPlaceholderText("请输入账号")
  14. self.psd_line = QLineEdit()
  15. self.psd_line.setPlaceholderText("请输入密码")
  16.  
  17. self.init()
  18.  
  19. def init(self):
  20.  
  21. layout = QHBoxLayout()
  22. self.setLayout(layout)
  23.  
  24. self.button = QPushButton("登录")
  25. layout.addWidget(self.button)
  26.  
  27. layout.addWidget(self.id_line)
  28. layout.addWidget(self.psd_line)
  29.  
  30. # 连接定义的信号
  31. self.button.clicked.connect(self.verify_emit)
  32.  
  33. def verify_emit(self):
  34. self.verifySignal.emit()
  35.  
  36. def verify_ok(self):
  37. QMessageBox.about(self, "密码正确", "已经登录")
  38.  
  39. def verify_no(self):
  40. QMessageBox.about(self, "你犯了一个粗误", "请重新检查输入")
  41.  
  42. # model
  43. class Student(object):
  44.  
  45. def __init__(self):
  46. self.name = "aaa"
  47. self.password = "aaa"
  48.  
  49. # control
  50. class LoginControll(object):
  51.  
  52. def __init__(self):
  53. # 不需要从命令行输入参数
  54. self._app = QApplication([])
  55. self._model = Student()
  56. self._view = MainWindow()
  57. self.init()
  58.  
  59. def init(self):
  60. self._view.verifySignal.connect(self.verify_user)
  61.  
  62. def verify_user(self):
  63. id_ = self._view.id_line.text()
  64. psd_ = self._view.psd_line.text()
  65.  
  66. if id_ == self._model.name and psd_ == self._model.password:
  67. self._view.verify_ok()
  68. else:
  69. self._view.verify_no()
  70.  
  71. def run(self):
  72. self._view.show()
  73. # 事件循环，直到应用退出
  74. return self._app.exec_()
  75.  
  76. # main.py
  77. if __name__ == "__main__":
  78. login_control_ = LoginControll()
  79. # 退出主程序
  80. sys.exit(login_control_.run())

在这个例子里需要注意的是，将model，view和controller分成了三个类。在view中定义信号以及信号何时发射，在controller中定义信号发射后连接的槽函数，即触发何种的响应。这样，通过信号的发射与连接，就将view和controller绑定在了一起。view负责页面展示与信号定义，controller负责信号的连接与功能的实现，完美。

MVC实现

单页面

如果读懂以上内容，那么应该可以实战了。首先给出一个demo，就是将上面最简单的MVC的例子拆分为三个文件。这里不便代码展示，请移步到我的github进行观看，这是文件结构，这是主文件。

多页面

在实现个复杂点的逻辑，多个页面，多个controller，文件结构如下所示，一个主文件，配三个文件夹，完美。这里命名时尽量规范，文件名、类名、函数名，不然容易把自己搞晕了。python main.py执行。

  1. MVC-demo
  2. ├─ main.py
  3. ├─ UI
  4. │ ├─ leftbtn_ui.py
  5. │ ├─ login_ui.py
  6. │ ├─ main_window_ui.py
  7. │ └─ verify_ui.py
  8. ├─ control
  9. │ ├─ controller.py
  10. │ ├─ leftbtn_control.py
  11. │ ├─ login_control.py
  12. │ └─ verify_control.py
  13. └─ model
  14. └─ model.py

调用关系如下：

PyQt5通过信号实现MVC的示例

这里需要注意的是变量的生存周期，main调用controller，controller调用其它的子controller，很容易在声明一个类后局部变量消失，导致信号无法连接。如在controller.py中，典型错误的写法：

  1. class Controll(object):
  2.  
  3. def __init__(self):
  4.  
  5. self._app = QApplication([])
  6.  
  7. self._stu = Student()
  8.  
  9. self._view = MainWindow()
  10. self.init()
  11.  
  12. def init(self):
  13. # 子 controller 作为局部变量，调用完后立刻消失，所以无法连接信号和槽
  14. # 这个问题困扰了我三天，可真是滑稽
  15. login_controller = login_control.Controller(self._view, self._stu.name, self._stu.password)

因为代码文件实在太多且混乱，就不在这里展示了，不然读者会更容易感到乱。这里只展示一个效果，完整代码见我的github。其实看一个例子，就啥都懂了。

PyQt5通过信号实现MVC的示例

以上就是PyQt5通过信号实现MVC的示例的详细内容，更多关于PyQt5通过信号实现MVC的资料请关注服务器之家其它相关文章！

原文链接：https://muyuuuu.github.io/2021/02/03/PyQt5-MVC/

标签：

相关文章