---

PySide6快速入门：QTableWidget 表格控件

前言

在开发图形用户界面（GUI）时，表格控件是常用的元素之一。它允许用户以行列的形式查看和编辑数据。QTableWidget 是 PySide6 提供的一个表格控件，支持显示二维数据、编辑单元格内容、设置单元格样式等功能。本文将介绍 QTableWidget 控件的基本用法，并深入探讨其常用函数，帮助你快速掌握如何在 PySide6 中使用该控件。

什么是QTableWidget？

QTableWidget 是一个用于显示表格数据的控件，类似于电子表格应用中的表格。它可以用来显示和编辑数据，并提供了多种功能，例如设置表头、修改单元格内容、控制单元格的样式等。QTableWidget 适用于需要以表格形式显示大量数据，并需要对数据进行编辑的场景。

特点：

1. 行列结构： 数据以行列的形式显示。
2. 支持编辑： 可以在表格中直接编辑单元格内容。
3. 灵活的操作： 支持设置行列、单元格样式、排序等功能。

如何使用QTableWidget？

1. 基本用法

要使用 QTableWidget，首先需要创建一个 QTableWidget 对象，并设置表格的行数和列数。然后，你可以设置表格中的每个单元格的内容，或者将数据动态地插入到表格中。

示例代码：

from PySide6.QtWidgets import QApplication, QWidget, QTableWidget, QTableWidgetItem, QVBoxLayout

app = QApplication([])

window = QWidget()
layout = QVBoxLayout()

# 创建QTableWidget，设置行数和列数
table = QTableWidget(3, 3)  # 3行3列

# 设置表格头部标题
table.setHorizontalHeaderLabels(["Column 1", "Column 2", "Column 3"])

# 向单元格添加内容
table.setItem(0, 0, QTableWidgetItem("Item 1"))
table.setItem(0, 1, QTableWidgetItem("Item 2"))
table.setItem(0, 2, QTableWidgetItem("Item 3"))
table.setItem(1, 0, QTableWidgetItem("Item 4"))
table.setItem(1, 1, QTableWidgetItem("Item 5"))
table.setItem(1, 2, QTableWidgetItem("Item 6"))

# 将表格添加到布局中
layout.addWidget(table)

# 设置窗口布局并显示
window.setLayout(layout)
window.show()

app.exec()

在这个例子中，我们创建了一个 QTableWidget，并设置了表格的行数和列数。然后，我们为每个单元格添加了数据，并将表格显示在窗口中。

2. 设置表头

可以使用 setHorizontalHeaderLabels() 方法设置表格的列标题。此外，也可以使用 setVerticalHeaderLabels() 方法设置行标题。

示例代码：

table.setHorizontalHeaderLabels(["Name", "Age", "Occupation"])
table.setVerticalHeaderLabels(["Row 1", "Row 2", "Row 3"])

3. 获取和设置单元格内容

可以使用 setItem() 方法为特定单元格设置内容，使用 item() 方法获取单元格的内容。

示例代码：

# 设置单元格内容
table.setItem(0, 0, QTableWidgetItem("Alice"))

# 获取单元格内容
item = table.item(0, 0)
print(item.text())  # 输出：Alice

4. 设置单元格样式

可以通过 setItem() 方法获取到单元格的 QTableWidgetItem，然后设置它的样式。例如，可以设置字体、颜色、对齐方式等。

示例代码：

from PySide6.QtGui import QFont, QColor
from PySide6.QtCore import Qt

item = table.item(0, 0)
item.setFont(QFont("Arial", 12, QFont.Bold))
item.setForeground(QColor(255, 0, 0))  # 设置字体颜色为红色
item.setTextAlignment(Qt.AlignCenter)  # 设置文本居中

5. 编辑单元格内容

QTableWidget 默认支持直接编辑单元格内容。如果你不想让某些单元格可编辑，可以使用 setItem() 方法中的 setFlags() 方法来禁用编辑功能。

示例代码：

item = table.item(0, 0)
item.setFlags(item.flags() ^ Qt.ItemIsEditable)  # 禁用编辑

QTableWidget 常用函数分类介绍

1. 基本操作

• setRowCount(row_count)
  设置表格的行数。

  • 参数： row_count：表格的行数。
  • 返回值： 无。

• setColumnCount(column_count)
  设置表格的列数。

  • 参数： column_count：表格的列数。
  • 返回值： 无。

• setItem(row, column, item)
  设置指定行列位置的单元格内容。

  • 参数： row：行索引，column：列索引，item：QTableWidgetItem 对象，表示要显示的内容。
  • 返回值： 无。

• item(row, column)
  获取指定行列位置的单元格内容。

  • 参数： row：行索引，column：列索引。
  • 返回值： 返回对应位置的 QTableWidgetItem 对象。

2. 表格头部操作

• setHorizontalHeaderLabels(labels)
  设置表格的列标题。

  • 参数： labels：一个列表，包含每列的标题。
  • 返回值： 无。

• setVerticalHeaderLabels(labels)
  设置表格的行标题。

  • 参数： labels：一个列表，包含每行的标题。
  • 返回值： 无。

• resizeColumnsToContents()
  根据内容自动调整列宽。

  • 返回值： 无。

• resizeRowsToContents()
  根据内容自动调整行高。

  • 返回值： 无。

3. 单元格样式操作

• setItemDelegate(delegate)
  设置自定义的单元格代理，控制单元格的显示和编辑行为。

  • 参数： delegate：自定义的 QAbstractItemDelegate 对象。
  • 返回值： 无。

• setSpan(row, column, row_span, column_span)
  设置某个单元格跨越的行数和列数，用于合并单元格。

  • 参数： row：起始行索引，column：起始列索引，row_span：合并的行数，column_span：合并的列数。
  • 返回值： 无。

4. 编辑功能

• setEditTriggers(triggers)
  设置单元格的编辑触发条件。

  • 参数： triggers：一个 QAbstractItemView.EditTrigger 枚举值的组合，用于控制单元格编辑的触发条件（例如，双击、按键等）。
  • 返回值： 无。

• setSelectionBehavior(behavior)
  设置表格选择的行为（例如，按行选择或按列选择）。

  • 参数： behavior：选择行为（QAbstractItemView.SelectRows 或 QAbstractItemView.SelectColumns）。
  • 返回值： 无。

5. 排序功能

• setSortingEnabled(enabled)
  启用或禁用排序功能。

  • 参数： enabled：布尔值，True 表示启用排序，False 表示禁用排序。
  • 返回值： 无。

• sortByColumn(column, order)
  按指定列进行排序。

  • 参数： column：列索引，order：排序方式（Qt.AscendingOrder 或 Qt.DescendingOrder）。
  • 返回值： 无。

总结

QTableWidget 是一个功能强大的表格控件，能够方便地展示和编辑二维数据。它支持设置表头、编辑单元格、设置单元格样式、排序等功能，适用于需要展示大量数据并提供交互编辑功能的场景。通过掌握 QTableWidget 的基本用法和常用函数，你可以灵活地在 PySide6 应用中实现各种表格相关的功能，提高用户体验。