当前位置：首页 > news >正文

【Python】QT（PySide2、PyQt5）：列表视图、模型、自定义委托

news 2025/8/26 7:35:13

MVC模式

MVC模式（Model-View-Controller，即模型-视图-控制器模式），是一种软件设计模式，将逻辑、用户界面、数据分离的模式。

PySide2中列表、表格等可以使用该模式。大体为：视图（View）、数据模型（Model）和委托（Delegate）。

Models：

基类为QAbstractItemModel。
两个标准模型为：QStandardItemModel、QFileSystemModel。
其他模型还有QStringListModel，QSqlQueryModel、QSqlTableModel、QSqlRelationalTableModel等。

Views：

基类为QAbstractItemView。
主要视图有列表（QListView）、表格（QTableView）、树结构（QTreeView）。

Delegates：

基类为QAbstractItemDelegate。
默认的delegate实现为QStyledItemDelegate。
其他还有QItemDelegate，区别是QStyledItemDelegate使用当前样式绘制item。

参考：Model/View Programming — Qt for Python

列表

简单的列表可以使用QListWidget实现。复杂一些的列表需要使用MVC模式。

这里举例为列表视图（QListView）、模型（QStandardItemModel）、以及从QStyledItemDelegate继承的Delegate。注：QStandardItemModel在PySide2.QtGui 模块中。

具体操作、各控件的属性和方法查看官方文档。PySide2和PySide6差不太多，都可以参考。PySide2.QtWidgets — Qt for Python，PySide6.QtWidgets - Qt for Python

创建列表视图和数据模型：

自定义mywindow类作为主窗口，继承于QMainWindow。

from PySide2.QtWidgets import QApplication, QMainWindow, QListView
from PySide2.QtGui import QStandardItemModelclass myWindow(QMainWindow):def __init__(self):super().__init__()# 创建列表视图和数据模型self.listview = QListView(self)              # 列表视图self.model = QStandardItemModel()            # 数据模型self.listview.setModel(self.model)           # 设置视图和模型的关联# 将列表视图设为主窗口的中央部件，并设置主窗口标题self.setCentralWidget(self.listview)self.setWindowTitle('QListView-QStandardItemModel Example')if __name__ == '__main__':app = QApplication()window = myWindow()window.show()app.exec_()

设置列表视图：

class myWindow(QMainWindow):def __init__(self):...# 设置列表视图# listview.setSelectionMode(QListView.ExtendedSelection)    # 允许多选self.listview.setSelectionMode(QListView.SingleSelection)   # 允许单选self.listview.setAlternatingRowColors(True)                 # 交替行颜色# self.listview.setEditTriggers(QListView.NoEditTriggers)   # 禁止编辑self.listview.setSpacing(10)                                # 设置行间距self.listview.setAutoScroll(True)                           # 自动滚动条

往数据模型中添加数据：

from PySide2.QtGui import QStandardItemclass myWindow(QMainWindow):def __init__(self):...listdata = ['Python', 'QT', 'PySide2', 'MVC', 'Item 5']# 往数据模型中添加数据for x in self.listdata:item = QStandardItem(x)item.setCheckable(True)             # 设置为可选中,前有勾选框self.model.appendRow(item)