【PyQt学习篇 · ⑭】:QTableView的使用

QTableView的使用

QTableView 是 PyQt 中用于显示表格数据的窗口部件,它提供了一个灵活的方式来显示和编辑数据。下面是一些关于 QTableView 的使用的具体信息:

  1. 创建 QTableView 对象:

    from PyQt5.QtWidgets import QApplication, QTableView
    
    app = QApplication([])  # 创建应用程序对象
    tableView = QTableView()  # 创建 QTableView 对象
    
  2. 设置数据模型:

    QTableView 依赖于数据模型来提供数据。常用的数据模型有 QStandardItemModelQAbstractTableModel。可以根据数据的不同复杂性来选择合适的数据模型。

    from PyQt5.QtGui import QStandardItemModel
    
    # 创建数据模型
    model = QStandardItemModel()
    
    # 设置表头
    model.setHorizontalHeaderLabels(["Column 1", "Column 2"])
    
    # 设置数据
    data = [
        ["Row 1, Column 1", "Row 1, Column 2"],
        ["Row 2, Column 1", "Row 2, Column 2"],
        # ...
    ]
    for i, row in enumerate(data):
        for j, value in enumerate(row):
            item = QStandardItem(value)
            model.setItem(i, j, item)
    
    # 将数据模型设置给 QTableView
    tableView.setModel(model)
    
  3. 显示 QTableView:

    tableView.show()
    
  4. 设置选择模式:

    from PyQt5.QtCore import Qt
    
    tableView.setSelectionMode(QTableView.SingleSelection)  # 单选模式
    tableView.setSelectionBehavior(QTableView.SelectRows)  # 选择整行
    tableView.setEditTriggers(QTableView.NoEditTriggers)  # 禁止编辑
    
  5. 获取选中的数据:

    selected_indexes = tableView.selectedIndexes()
    selected_values = []
    for index in selected_indexes:
     	# 判断索引是否有效
        if index.isValid():
            value = index.data()
            selected_values.append(value)
    
  6. 其他常用操作:

    • 调整列宽:tableView.resizeColumnsToContents()
    • 调整行高:tableView.resizeRowsToContents()
    • 隐藏水平表头:tableView.horizontalHeader().setVisible(False)
    • 设置表格样式:tableView.setStyleSheet("QTableView { background-color: white; }")

示例

import sys
from PyQt5.QtWidgets import *
from PyQt5.QtCore import Qt
from PyQt5.QtGui import QStandardItemModel, QStandardItem

class MyWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("QTableView Example")

        # 创建数据模型
        self.model = QStandardItemModel(4, 3)
        self.model.setHorizontalHeaderLabels(["Name", "Age", "Gender"])

        # 添加数据
        data = [
            ["Alice", "25", "Female"],
            ["Bob", "32", "Male"],
            ["Charlie", "42", "Male"],
            ["Diana", "28", "Female"]
        ]

        for row in range(len(data)):
            for col in range(len(data[row])):
                item = QStandardItem(data[row][col])
                self.model.setItem(row, col, item)

        # 创建 QTableView
        self.table_view = QTableView()
        self.table_view.setModel(self.model)

        # self.table_view.setSelectionBehavior(QTableView.SelectRows)     # 设置 QTableView 控件的选择行为为选择整行(默认为选择单个单元格)
        self.table_view.setContextMenuPolicy(Qt.CustomContextMenu)      # 设置 QTableView 控件的上下文菜单的策略为自定义菜单策略,即用户可以通过customContextMenuRequested信号自定义显示菜单
        self.table_view.customContextMenuRequested.connect(self.show_context_menu)      # 将self.tabel_view控件的 custonContextMenuRequested 信号连接到自定义函数 show_context_menu 上,以便于显示自定义的上下文菜单

        # 设置表头自适应宽度
        self.table_view.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch)

        # 创建主布局,并将 QTableView 放入其中
        layout = QVBoxLayout()
        layout.addWidget(self.table_view)

        # 创建 QWidget,并将布局设置为其主布局
        central_widget = QWidget()
        central_widget.setLayout(layout)
        self.setCentralWidget(central_widget)

    def show_context_menu(self, position):
        # 右键菜单
        menu = QMenu(self)

        # 删除行
        delete_action = QAction("Delete", self)
        delete_action.triggered.connect(self.delete_selected_row)
        # 添加行
        append_row_action = QAction('Append Row', self)
        append_row_action.triggered.connect(self.append_row)
        # 插入行
        insert_row_action = QAction('Insert Row', self)
        insert_row_action.triggered.connect(self.insert_row)
        # 获取值
        getValue_action = QAction('Get Value', self)
        getValue_action.triggered.connect(self.get_selected_values)

        menu.addActions([delete_action, append_row_action, insert_row_action, getValue_action])

        # 显示菜单
        menu.exec_(self.table_view.viewport().mapToGlobal(position))

    # 删除行
    def delete_selected_row(self):
        # 删除选中的行
        rows = sorted(set(index.row() for index in self.table_view.selectedIndexes()), reverse=True)
        for row in rows:
            self.model.removeRow(row)

    # 添加行
    def append_row(self):
        # 创建空的数据项
        empty_item = QStandardItem()
        self.model.appendRow([empty_item, empty_item, empty_item])

    # 插入行
    def insert_row(self):
        # 创建空的数据项
        empty_item = QStandardItem()
        # 获取当前选中的行
        selected_row = self.table_view.currentIndex().row()
        # 插入空行到选中行下方
        self.model.insertRow(selected_row + 1, [empty_item, empty_item, empty_item])

    def get_selected_values(self):
        selected_row, selected_column = self.table_view.currentIndex().row(), self.table_view.currentIndex().column()
        item = self.model.item(selected_row, selected_column)
        print(item.text())


if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MyWindow()
    window.show()
    sys.exit(app.exec_())

运行结果:

在这里插入图片描述

  • 选中“Bob”,鼠标点击右键,点击“Delete”。
    在这里插入图片描述
  • 鼠标右键,点击“Append Row”
    在这里插入图片描述
  • 鼠标右键,点击“Insert Row”
    在这里插入图片描述
  • 鼠标右键,点击“Get Value”
    在这里插入图片描述