封装 QTableWidget

### QTableWidget 封装及最佳实践 #### 1. 封装背景 `QTableWidget` 是 Qt 提供的一个方便使用的表格控件，默认集成了 `QTableView` 和内置的模型 (`QStandardItemModel`)。尽管它简单易用，但在大型项目中可能会因为重复代码过多而导致维护困难。因此，对其进行封装是一种常见的做法[^1]。 --- #### 2. 基本概念 与 `QTableView` 不同的是，`QTableWidget` 更适合静态数据展示或少量动态更新的情况。它的每个单元格都可以单独设置内容、图标甚至小部件，这使得它可以更灵活地适应各种需求[^1]。 --- #### 3. 自定义封装示例 ##### (1) 创建自定义 Table Widget 类 可以通过继承 `QTableWidget` 来实现功能增强型表单组件。 ```python from PyQt5.QtWidgets import QTableWidget, QTableWidgetItem, QPushButton, QVBoxLayout, QWidget class CustomTableWidget(QTableWidget): def __init__(self, rows=0, columns=0, parent=None): super().__init__(rows, columns, parent) self.setHorizontalHeaderLabels(["Name", "Age", "City", "Actions"]) # 设置列标题 self.setColumnWidth(3, 100) # 调整动作列宽度 def populate_table(self, data_list): """填充表格数据""" self.setRowCount(len(data_list)) for row_idx, record in enumerate(data_list): name_item = QTableWidgetItem(record["name"]) age_item = QTableWidgetItem(str(record["age"])) city_item = QTableWidgetItem(record["city"]) delete_button = QPushButton("Delete") delete_button.clicked.connect(lambda _, r=row_idx: self.remove_row(r)) self.setItem(row_idx, 0, name_item) self.setItem(row_idx, 1, age_item) self.setItem(row_idx, 2, city_item) self.setCellWidget(row_idx, 3, delete_button) def remove_row(self, row_index): """移除指定行""" self.removeRow(row_index) ``` **说明**: - `populate_table`: 接收一个字典列表作为输入参数，并将其映射到表格中的相应位置。 - `remove_row`: 删除某一行记录，这里通过按钮点击触发回调函数完成操作。 --- ##### (2) 主窗口集成 下面是一个简单的主窗口类，用于演示如何初始化和使用上面定义好的 `CustomTableWidget`。 ```python import sys from PyQt5.QtWidgets import QApplication, QMainWindow class MainWindow(QMainWindow): def __init__(self): super().__init__() central_widget = QWidget() layout = QVBoxLayout() table = CustomTableWidget(rows=0, columns=4) sample_data = [ {"name": "Alice", "age": 25, "city": "Beijing"}, {"name": "Bob", "age": 30, "city": "Shanghai"} ] table.populate_table(sample_data) layout.addWidget(table) central_widget.setLayout(layout) self.setCentralWidget(central_widget) if __name__ == "__main__": app = QApplication(sys.argv) window = MainWindow() window.show() sys.exit(app.exec_()) ``` 此脚本创建了一个包含两个用户的表格视图，并允许用户通过按下对应的“删除”按钮来清除选定的一行[^1]。 --- #### 4. 扩展功能建议 为了进一步提升用户体验和程序功能性，可以考虑以下几个方向： - **右键菜单支持** 添加上下文菜单以提供更多便捷选项，如复制单元格值、导出整个表格至 CSV 文件等功能。 - **分页显示大数量级数据** 如果预计会有大量数据需要加载，则应引入虚拟滚动或者分页机制减少内存占用。 - **多选模式下的批量修改** 支持同时选取多个条目并对它们执行统一的操作（例如更改状态标记）。 - **实时搜索过滤** 结合 QLineEdit 控件实现在顶部快速查找符合条件的结果子集。 --- #### 5. 总结 通过对 `QTableWidget` 的合理封装，不仅能有效降低冗余代码量，而且有助于构建一致性的 UI 设计风格。更重要的是，这样的抽象层便于后续升级优化而不影响原有逻辑结构[^1]。 ---