### PyQt 中 QAbstractTableModel 的实现指南 `QAbstractTableModel` 是 PyQt 提供的一个抽象基类，用于创建自定义的数据模型。通过继承该类并重写必要的函数，可以实现一个功能完整的表格数据模型。以下是其实现的关键部分以及具体示例。 #### 数据模型的核心方法 为了使 `QAbstractTableModel` 正常工作，需要至少实现以下几个核心方法： 1. **`rowCount(self, parent=None)`**: 返回行数。 2. **`columnCount(self, parent=None)`**: 返回列数。 3. **`data(self, index, role=Qt.DisplayRole)`**: 根据索引和角色返回对应的数据。 4. **`headerData(self, section, orientation, role=Qt.DisplayRole)`**: 定义表头的内容。 5. **`flags(self, index)`**: 设置单元格的行为标志（如可编辑、可选中等）[^2]。 6. **`setData(self, index, value, role=Qt.EditRole)`**: 处理用户输入或修改操作。 #### 示例代码 下面是一个简单的 Python 实现，展示如何使用 `QAbstractTableModel` 创建一个支持编辑的表格视图。 ```python from PyQt5.QtCore import Qt, QAbstractTableModel, QModelIndex from PyQt5.QtWidgets import QApplication, QTableView class CustomTableModel(QAbstractTableModel): def __init__(self, data): super(CustomTableModel, self).__init__() self._data = data # 表格中的二维列表数据 def rowCount(self, parent=None): """返回行数""" return len(self._data) def columnCount(self, parent=None): """返回列数""" if not self.rowCount(): return 0 return len(self._data[0]) def data(self, index, role=Qt.DisplayRole): """根据索引和角色返回数据""" if not index.isValid(): return None row, col = index.row(), index.column() if role == Qt.DisplayRole or role == Qt.EditRole: try: return str(self._data[row][col]) except IndexError: pass return None def headerData(self, section, orientation, role=Qt.DisplayRole): """设置表头内容""" if role != Qt.DisplayRole: return None if orientation == Qt.Horizontal: return f"Column {section + 1}" elif orientation == Qt.Vertical: return f"Row {section + 1}" def flags(self, index): """设置单元格行为标志""" default_flags = super().flags(index) if index.isValid(): return default_flags | Qt.ItemIsEditable | Qt.ItemIsSelectable | Qt.ItemIsEnabled return default_flags def setData(self, index, value, role=Qt.EditRole): """处理用户的编辑操作""" if role == Qt.EditRole and index.isValid(): row, col = index.row(), index.column() try: self._data[row][col] = value self.dataChanged.emit(index, index, [role]) # 发送信号通知更新 return True except IndexError: pass return False if __name__ == "__main__": app = QApplication([]) # 初始化测试数据 test_data = [ ["Alice", "Engineer"], ["Bob", "Designer"] ] model = CustomTableModel(test_data) view = QTableView() view.setModel(model) view.show() app.exec_() ``` #### 关键点解析 - 上述代码展示了如何初始化一个自定义的 `CustomTableModel` 并将其绑定到 `QTableView` 控件上。 - 使用 `setData()` 方法实现了对表格数据的实时编辑功能，并通过发送 `dataChanged` 信号来刷新视图[^2]。 - 表头可以通过覆盖 `headerData()` 来定制化显示名称。 #### 结合 QML 的场景 如果希望在 QML 中使用类似的表格模型，则需借助 `QQmlApplicationEngine` 和 `setContextProperty` 将模型传递给 QML 文件。例如，在 QML 中可以直接调用 `model.roleName` 或其他属性来渲染表格[^3]。 ---