PyQt5实现在 QTableWidget第一列增加QCheckBox控件并居中

### PyQt5 QTableWidget 第一列 添加 QCheckBox 并居中对齐 要在 `QTableWidget` 的第一列添加 `QCheckBox` 控件并使其居中显示，可以按照以下方法实现： #### 方法概述 为了在 `QTableWidget` 中嵌入自定义控件（如 `QCheckBox`），通常需要使用 `setCellWidget()` 方法。此方法允许我们将任意的 `QWidget` 子类放置到单元格中。为了让 `QCheckBox` 居中显示，可以通过创建一个水平布局 (`QHBoxLayout`) 来管理其位置。 以下是完整的代码示例以及解释： ```python import sys from PyQt5.QtWidgets import QApplication, QMainWindow, QTableWidget, QTableWidgetItem, QWidget, QHBoxLayout, QCheckBox class MainWindow(QMainWindow): def __init__(self): super().__init__() self.setWindowTitle("QTableWidget with CheckBox Example") self.resize(800, 600) # 创建 QTableWidget self.table_widget = QTableWidget() self.setCentralWidget(self.table_widget) # 设置行数和列数 row_count = 6 col_count = 5 self.table_widget.setRowCount(row_count) self.table_widget.setColumnCount(col_count) # 设置表头 headers = ['姓名', '语文', '数学', '英语', '地理'] self.table_widget.setHorizontalHeaderLabels(headers) # 在第一列添加 QCheckBox 并居中 for row in range(row_count): checkbox_widget = QWidget() # 创建一个新的 QWidget 容器 layout = QHBoxLayout() # 使用水平布局 layout.setAlignment(Qt.AlignCenter) # 设置布局中的内容居中 layout.setContentsMargins(0, 0, 0, 0) # 移除边距以确保紧凑排列 checkbox = QCheckBox() # 创建 QCheckBox layout.addWidget(checkbox) # 将 QCheckBox 添加到布局中 checkbox_widget.setLayout(layout) # 将布局应用到容器 # 将容器设置到指定单元格 self.table_widget.setCellWidget(row, 0, checkbox_widget) if __name__ == "__main__": app = QApplication(sys.argv) window = MainWindow() window.show() sys.exit(app.exec_()) ``` --- #### 关键点解析 1. **创建容器 Widget** - 每个单元格内的控件都需要放在一个独立的 `QWidget` 容器中。 - 这是因为 `setCellWidget()` 只能接受整个 `QWidget` 对象作为参数[^3]。 2. **使用水平布局** - 利用 `QHBoxLayout` 管理 `QCheckBox` 的位置，并通过 `layout.setAlignment(Qt.AlignCenter)` 实现居中效果[^2]。 3. **移除多余间距** - 调整布局的外边距为零（即调用 `layout.setContentsMargins(0, 0, 0, 0)`），从而避免额外的空间影响视觉效果[^4]。 4. **动态填充数据** - 上述代码循环遍历每一行，在每行的第一列插入带有 `QCheckBox` 的容器[^1]。 --- #### 获取勾选状态的方法 如果需要读取所有 `QCheckBox` 的勾选状态，可以在程序运行期间执行以下逻辑： ```python for row in range(self.table_widget.rowCount()): cell_widget = self.table_widget.cellWidget(row, 0) if cell_widget: checkbox = cell_widget.findChild(QCheckBox) if checkbox and checkbox.isChecked(): print(f"Row {row} is checked.") ``` 这段代码逐行检查每个单元格中的 `QCheckBox` 是否被勾选，并打印对应的结果[^4]。 --- ###