PyQt6/PySide6 的 QTableView 类
QTableView 是 PyQt6 或 PySide6 库中用于显示二维表格数据的控件。它是一个非常强大且灵活的控件，适用于展示和编辑表格数据。QTableView 通常与 QAbstractItemModel 的子类（如 QStandardItemModel 或自定义模型）一起使用，以提供数据源。下面我将详细介绍 QTableView 的主要特性及其使用方法。
1. 基本概念
- 表格视图：用于显示二维表格数据的控件。
- 模型-视图架构：
QTableView使用模型-视图架构，其中QTableView是视图部分，负责显示数据；而模型（如QStandardItemModel）则负责管理数据。 - 列和行：表格中的基本单位，由行和列组成。
- 单元格：表格中的单个数据项。
- 选择模式：控制用户如何选择单元格、行或列。
- 排序：支持对表格数据进行排序。
- 编辑模式：允许用户直接在表格中编辑数据。
2. 创建 QTableView 实例
要使用 QTableView，首先需要导入相应的库：
from PyQt6.QtWidgets import QApplication, QTableView, QVBoxLayout, QWidget, QPushButton
from PyQt6.QtGui import QStandardItemModel, QStandardItem
# 或者
from PySide6.QtWidgets import QApplication, QTableView, QVBoxLayout, QWidget, QPushButton
from PySide6.QtGui import QStandardItemModel, QStandardItem
接着创建一个窗口，并在其中添加 QTableView 控件：
class MyWindow(QWidget):
def __init__(self):
super().__init__()
self.setWindowTitle("我的应用程序")
self.setGeometry(100, 100, 800, 600)
# 初始化UI
self.initUI()
def initUI(self):
layout = QVBoxLayout()
# 创建表格视图
self.table_view = QTableView(self)
# 创建模型
self.model = QStandardItemModel(4, 3) # 4行3列
self.model.setHorizontalHeaderLabels(['姓名', '年龄', '职业'])
# 添加数据
self.model.setItem(0, 0, QStandardItem('张三'))
self.model.setItem(0, 1, QStandardItem('28'))
self.model.setItem(0, 2, QStandardItem('工程师'))
self.model.setItem(1, 0, QStandardItem('李四'))
self.model.setItem(1, 1, QStandardItem('32'))
self.model.setItem(1, 2, QStandardItem('教师'))
self.model.setItem(2, 0, QStandardItem('王五'))
self.model.setItem(2, 1, QStandardItem('25'))
self.model.setItem(2, 2, QStandardItem('医生'))
self.model.setItem(3, 0, QStandardItem('赵六'))
self.model.setItem(3, 1, QStandardItem('30'))
self.model.setItem(3, 2, QStandardItem('律师'))
# 设置模型到视图
self.table_view.setModel(self.model)
# 添加按钮
button = QPushButton("打印选中项", self)
button.clicked.connect(self.print_selection)
# 添加到布局
layout.addWidget(self.table_view)
layout.addWidget(button)
self.setLayout(layout)
def print_selection(self):
selected_indices = self.table_view.selectedIndexes()
for index in selected_indices:
row = index.row()
column = index.column()
value = index.data()
print(f"行: {row}, 列: {column}, 值: {value}")
if __name__ == "__main__":
app = QApplication([])
window = MyWindow()
window.show()
app.exec()
3. QTableView 的常用属性和方法
属性
- model：获取或设置当前使用的模型。
- selectionModel：获取或设置当前的选择模型。
- currentIndex：获取或设置当前选中的索引。
- horizontalHeader：获取水平表头。
- verticalHeader：获取垂直表头。
- cornerButtonEnabled：获取或设置是否启用角落按钮。
- showGrid：获取或设置是否显示网格线。
- gridStyle：获取或设置网格线样式。
- alternatingRowColors：获取或设置是否交替行颜色。
- sortingEnabled：获取或设置是否启用排序。
- wordWrap：获取或设置是否启用自动换行。
- resizeMode：获取或设置调整大小模式。
- selectionBehavior：获取或设置选择行为（选择单元格、行或列）。
- selectionMode：获取或设置选择模式（单选或多选）。
- editTriggers：获取或设置编辑触发器。
- toolTip：获取或设置工具提示文本。
- statusTip：获取或设置状态栏提示文本。
方法
- setModel(QAbstractItemModel)：设置当前使用的模型。
- model() -> QAbstractItemModel：获取当前使用的模型。
- setSelectionModel(QItemSelectionModel)：设置当前的选择模型。
- selectionModel() -> QItemSelectionModel：获取当前的选择模型。
- setCurrentIndex(QModelIndex)：设置当前选中的索引。
- currentIndex() -> QModelIndex：获取当前选中的索引。
- horizontalHeader() -> QHeaderView：获取水平表头。
- verticalHeader() -> QHeaderView：获取垂直表头。
- setCornerButtonEnabled(bool)：设置是否启用角落按钮。
- isCornerButtonEnabled() -> bool：判断是否启用角落按钮。
- setShowGrid(bool)：设置是否显示网格线。
- showGrid() -> bool：判断是否显示网格线。
- setGridStyle(Qt.PenStyle)：设置网格线样式。
- gridStyle() -> Qt.PenStyle：获取网格线样式。
- setAlternatingRowColors(bool)：设置是否交替行颜色。
- alternatingRowColors() -> bool：判断是否交替行颜色。
- setSortingEnabled(bool)：设置是否启用排序。
- isSortingEnabled() -> bool：判断是否启用排序。
- setWordWrap(bool)：设置是否启用自动换行。
- wordWrap() -> bool：判断是否启用自动换行。
- setResizeMode(QHeaderView.ResizeMode)：设置调整大小模式。
- resizeMode() -> QHeaderView.ResizeMode：获取调整大小模式。
- setSelectionBehavior(QAbstractItemView.SelectionBehavior)：设置选择行为。
- selectionBehavior() -> QAbstractItemView.SelectionBehavior：获取选择行为。
- setSelectionMode(QAbstractItemView.SelectionMode)：设置选择模式。
- selectionMode() -> QAbstractItemView.SelectionMode：获取选择模式。
- setEditTriggers(QAbstractItemView.EditTrigger)：设置编辑触发器。
- editTriggers() -> QAbstractItemView.EditTrigger：获取编辑触发器。
- setToolTip(str)：设置工具提示文本。
- toolTip() -> str：获取工具提示文本。
- setStatusTip(str)：设置状态栏提示文本。
- statusTip() -> str：获取状态栏提示文本。
- selectRow(int)：选择指定行。
- selectColumn(int)：选择指定列。
- clearSelection()：清除选择。
- selectAll()：全选。
- selectedIndexes() -> List[QModelIndex]：获取所有选中的索引。
- resizeColumnsToContents()：根据内容调整列宽。
- resizeRowsToContents()：根据内容调整行高。
- hideColumn(int)：隐藏指定列。
- showColumn(int)：显示指定列。
- hideRow(int)：隐藏指定行。
- showRow(int)：显示指定行。
4. 详细示例
设置模型
# 创建模型
model = QStandardItemModel(4, 3) # 4行3列
model.setHorizontalHeaderLabels(['姓名', '年龄', '职业'])
# 添加数据
model.setItem(0, 0, QStandardItem('张三'))
model.setItem(0, 1, QStandardItem('28'))
model.setItem(0, 2, QStandardItem('工程师'))
model.setItem(1, 0, QStandardItem('李四'))
model.setItem(1, 1, QStandardItem('32'))
model.setItem(1, 2, QStandardItem('教师'))
model.setItem(2, 0, QStandardItem('王五'))
model.setItem(2, 1, QStandardItem('25'))
model.setItem(2, 2, QStandardItem('医生'))
model.setItem(3, 0, QStandardItem('赵六'))
model.setItem(3, 1, QStandardItem('30'))
model.setItem(3, 2, QStandardItem('律师'))
# 设置模型到视图
table_view.setModel(model)
获取当前选中的索引
def print_selection():
selected_indices = table_view.selectedIndexes()
for index in selected_indices:
row = index.row()
column = index.column()
value = index.data()
print(f"行: {row}, 列: {column}, 值: {value}")
选择行或列
# 选择第1行
table_view.selectRow(1)
# 选择第2列
table_view.selectColumn(2)
清除选择
table_view.clearSelection()
全选
table_view.selectAll()
根据内容调整列宽和行高
table_view.resizeColumnsToContents()
table_view.resizeRowsToContents()
隐藏和显示列或行
# 隐藏第2列
table_view.hideColumn(2)
# 显示第2列
table_view.showColumn(2)
# 隐藏第3行
table_view.hideRow(3)
# 显示第3行
table_view.showRow(3)
启用或禁用排序
table_view.setSortingEnabled(True) # 启用排序
table_view.setSortingEnabled(False) # 禁用排序
设置选择行为
table_view.setSelectionBehavior(QAbstractItemView.SelectionBehavior.SelectRows) # 选择整行
table_view.setSelectionBehavior(QAbstractItemView.SelectionBehavior.SelectColumns) # 选择整列
table_view.setSelectionBehavior(QAbstractItemView.SelectionBehavior.SelectItems) # 选择单元格
设置选择模式
table_view.setSelectionMode(QAbstractItemView.SelectionMode.SingleSelection) # 单选
table_view.setSelectionMode(QAbstractItemView.SelectionMode.ContiguousSelection) # 连续多选
table_view.setSelectionMode(QAbstractItemView.SelectionMode.ExtendedSelection) # 扩展多选
table_view.setSelectionMode(QAbstractItemView.SelectionMode.MultiSelection) # 多选
设置编辑触发器
table_view.setEditTriggers(QAbstractItemView.EditTrigger.DoubleClicked | QAbstractItemView.EditTrigger.SelectedClicked) # 双击或选中后点击编辑
设置工具提示和状态栏提示
table_view.setToolTip("这是一个表格视图")
table_view.setStatusTip("查看和编辑数据")
5. 信号与槽机制
QTableView 支持多种信号，这些信号可以在用户交互时发射。常见的信号包括 clicked、doubleClicked、pressed、activated 和 selectionChanged。你可以通过连接这些信号到槽函数来处理用户的输入事件。
def on_clicked(index):
row = index.row()
column = index.column()
value = index.data()
print(f"点击: 行: {row}, 列: {column}, 值: {value}")
def on_double_clicked(index):
row = index.row()
column = index.column()
value = index.data()
print(f"双击: 行: {row}, 列: {column}, 值: {value}")
def on_pressed(index):
row = index.row()
column = index.column()
value = index.data()
print(f"按下: 行: {row}, 列: {column}, 值: {value}")
def on_activated(index):
row = index.row()
column = index.column()
value = index.data()
print(f"激活: 行: {row}, 列: {column}, 值: {value}")
def on_selection_changed(selected, deselected):
print("选择发生变化")
table_view.clicked.connect(on_clicked)
table_view.doubleClicked.connect(on_double_clicked)
table_view.pressed.connect(on_pressed)
table_view.activated.connect(on_activated)
table_view.selectionModel().selectionChanged.connect(on_selection_changed)
6. 自定义样式
除了使用内置的样式设置外，你还可以通过样式表（QSS）来自定义 QTableView 的外观。样式表类似于CSS，提供了强大的样式控制能力。
table_view.setStyleSheet("""
QTableView {
background-color: #f0f0f0;
alternate-background-color: #e0e0e0;
selection-background-color: #0078d7;
selection-color: white;
gridline-color: #cccccc;
border: 1px solid #cccccc;
}
QTableView::item {
padding: 5px;
}
QTableView::item:selected {
background-color: #0078d7;
color: white;
}
QTableView::item:hover {
background-color: #d0d0d0;
}
QTableView::item:focus {
outline: none;
}
QHeaderView::section {
background-color: #e0e0e0;
border: 1px solid #cccccc;
padding: 5px;
}
QHeaderView::section:checked {
background-color: #0078d7;
color: white;
}
""")
7. 动态更新和控制
你可以动态地更新 QTableView 的内容，或者根据某些条件控制其行为。例如，在定时器或其他事件触发时更新表格的数据。
import time
from PyQt6.QtCore import QTimer
class MyWindow(QWidget):
def __init__(self):
super().__init__()
self.setWindowTitle("我的应用程序")
self.setGeometry(100, 100, 800, 600)
# 初始化UI
self.initUI()
# 创建定时器
self.timer = QTimer(self)
self.timer.timeout.connect(self.update_table_view)
self.timer.start(5000) # 每5秒触发一次
def initUI(self):
layout = QVBoxLayout()
# 创建表格视图
self.table_view = QTableView(self)
# 创建模型
self.model = QStandardItemModel(4, 3) # 4行3列
self.model.setHorizontalHeaderLabels(['姓名', '年龄', '职业'])
# 添加数据
self.model.setItem(0, 0, QStandardItem('张三'))
self.model.setItem(0, 1, QStandardItem('28'))
self.model.setItem(0, 2, QStandardItem('工程师'))
self.model.setItem(1, 0, QStandardItem('李四'))
self.model.setItem(1, 1, QStandardItem('32'))
self.model.setItem(1, 2, QStandardItem('教师'))
self.model.setItem(2, 0, QStandardItem('王五'))
self.model.setItem(2, 1, QStandardItem('25'))
self.model.setItem(2, 2, QStandardItem('医生'))
self.model.setItem(3, 0, QStandardItem('赵六'))
self.model.setItem(3, 1, QStandardItem('30'))
self.model.setItem(3, 2, QStandardItem('律师'))
# 设置模型到视图
self.table_view.setModel(self.model)
# 添加到布局
layout.addWidget(self.table_view)
self.setLayout(layout)
def update_table_view(self):
# 更新模型数据
self.model.clear()
self.model.setHorizontalHeaderLabels(['姓名', '年龄', '职业'])
# 添加新的数据
self.model.setItem(0, 0, QStandardItem('张三'))
self.model.setItem(0, 1, QStandardItem('29'))
self.model.setItem(0, 2, QStandardItem('工程师'))
self.model.setItem(1, 0, QStandardItem('李四'))
self.model.setItem(1, 1, QStandardItem('33'))
self.model.setItem(1, 2, QStandardItem('教师'))
self.model.setItem(2, 0, QStandardItem('王五'))
self.model.setItem(2, 1, QStandardItem('26'))
self.model.setItem(2, 2, QStandardItem('医生'))
self.model.setItem(3, 0, QStandardItem('赵六'))
self.model.setItem(3, 1, QStandardItem('31'))
self.model.setItem(3, 2, QStandardItem('律师'))
if __name__ == "__main__":
app = QApplication([])
window = MyWindow()
window.show()
app.exec()
总结
QTableView 是 PyQt6/PySide6 中非常强大且灵活的控件，适用于各种需要展示和编辑表格数据的场景。通过设置不同的属性和使用样式表，你可以创建出丰富多样的表格视图样式。同时，通过信号与槽机制，你可以方便地处理用户的输入事件。希望以上内容能帮助你更好地理解和运用 QTableView，并能够根据具体需求创建出功能丰富且用户友好的表格视图控件。