如何在PyQt5的tableWidget控件里添加行列

### PyQt5 中 QTableWidget 组件的用法 QTableWidget 是 PyQt5 提供的一个表格控件，允许开发者创建具有行列结构的数据展示界面。它继承自 QTableView 并提供了内置模型来管理数据[^1]。 #### 创建 QTableWidget 的基本方法 可以通过 `setRowCount` 和 `columnCount` 方法设置表格的行数和列数。通过 `setItem(row, column, item)` 可以为指定单元格赋值。以下是实现一个简单 QTableWidget 表格的例子： ```python from PyQt5.QtWidgets import QApplication, QWidget, QTableWidget, QTableWidgetItem, QVBoxLayout class TableExample(QWidget): def __init__(self): super().__init__() self.initUI() def initUI(self): table_widget = QTableWidget() table_widget.setRowCount(4) # 设置行数 table_widget.setColumnCount(3) # 设置列数 # 填充表格内容 for row in range(4): for col in range(3): item = QTableWidgetItem(f"Item {row},{col}") table_widget.setItem(row, col, item) layout = QVBoxLayout() layout.addWidget(table_widget) self.setLayout(layout) self.setWindowTitle('QTableWidget Example') if __name__ == '__main__': app = QApplication([]) window = TableExample() window.show() app.exec_() ``` 上述代码展示了如何初始化一个带有四行三列的 QTableWidget，并填充一些示例数据到其中。 #### 自定义表头名称 可以使用 `setHorizontalHeaderLabels` 或者 `setVerticalHeaderLabels` 来分别设定水平方向或者垂直方向上的表头标签名: ```python header_labels = ['Column 1', 'Column 2', 'Column 3'] table_widget.setHorizontalHeaderLabels(header_labels) ``` 这会将默认的数字序号替换为更具体的描述性文字作为列标题。 #### 获取选中的单元格信息 当用户点击某个单元格时，程序可能需要获取该单元格的内容或其他属性。下面是一个简单的例子说明如何捕获当前被选择项的信息： ```python def on_cell_clicked(row, column): print(f'Cell clicked at Row:{row}, Column:{column}') table_widget.cellClicked.connect(on_cell_clicked) ``` 这里我们连接了一个信号处理器函数至 cellClicked 事件上，每当有新的单元格被点击的时候就会触发这个回调函数并打印相应的坐标位置。

### PyQt5中`QTableWidget`组件的使用方法 #### 创建并初始化`QTableWidget` 为了创建一个基本的 `QTableWidget` 组件，首先需要导入必要的模块，并设置好窗口布局。下面是一个简单的例子展示如何创建带有两列三行的表格[^1]。 ```python import sys from PyQt5.QtWidgets import QApplication, QWidget, QTableWidget, QTableWidgetItem, QVBoxLayout class Example(QWidget): def __init__(self): super().__init__() self.initUI() def initUI(self): # 设置表格大小为2列3行 table_widget = QTableWidget(3, 2) # 添加表头标签 table_widget.setHorizontalHeaderLabels(['姓名', '年龄']) # 插入一些测试数据 items = [ ['张三', '20'], ['李四', '22'], ['王五', '24'] ] for row_index, item in enumerate(items): name_item = QTableWidgetItem(item[0]) age_item = QTableWidgetItem(item[1]) table_widget.setItem(row_index, 0, name_item) table_widget.setItem(row_index, 1, age_item) layout = QVBoxLayout() layout.addWidget(table_widget) self.setLayout(layout) if __name__ == '__main__': app = QApplication(sys.argv) ex = Example() ex.show() sys.exit(app.exec_()) ``` 此代码片段展示了如何定义一个具有固定行列数目的 `QTableWidget` 实例，并向其中填充具体的内容项。每一项都是通过 `QTableWidgetItem` 类实例化而来，代表了表格里的每一个单元格。 #### 处理点击事件与上下文菜单 当用户单击某个特定位置时触发自定义行为是非常常见的需求之一。可以通过重写鼠标释放事件来实现这一点，在该函数内部判断鼠标的坐标是否位于某一行内；如果是，则弹出右键菜单供进一步操作。 ```python def mouseReleaseEvent(self, event): if event.button() == Qt.RightButton: menu = QMenu(self) action_delete_row = QAction('删除当前行') action_add_row_above = QAction('在此之上添加新行') selected_items = self.tableWidget.selectedItems() if not selected_items: return clicked_row = selected_items[0].row() action_delete_row.triggered.connect(lambda: self.deleteRow(clicked_row)) action_add_row_above.triggered.connect(lambda: self.addRowAbove(clicked_row)) menu.addAction(action_delete_row) menu.addAction(action_add_row_above) menu.popup(event.globalPos()) Example.mouseReleaseEvent = mouseReleaseEvent ``` 上述代码实现了两个功能：一是删除选中的那一行记录；二是允许在现有条目上方新增一条空白记录。这里利用到了匿名函数 (`lambda`) 来传递额外参数给槽函数。 #### 响应组合框(`ComboBox`)的变化 如果希望让 `QTableWidget` 中嵌套的 `QComboBox` 控件能够正常工作——即改变选项后能被检测到变动并作出相应反馈的话，那么应该监听 `currentIndexChanged()` 信号而不是依赖于默认情况下不会更新的 `cellChanged` 信号[^3]。 ```python combo_box.currentIndexChanged.connect( lambda index: print(f'选择了索引 {index}')) ``` 这段脚本会打印出所选项目的索引值作为示范说明。实际应用当中可以根据业务逻辑执行更复杂的动作，比如保存更改后的状态至数据库等。