实战PyQt5: 073-表格视图QTableView

QTableView简介

QTableView是模型-视图（Model-View）框架类之一，是Qt模型-视图框架的组成部分，它实现了一个表格视图。在一个应用需要和一批数据进行交互，需要以表格形式输出这些信息的时候，QTableView是最合适的选择。

QTableView实现了QAbstractItemView类定义的接口，因此它能够显示从QAbstractItemModel类派生的模型提供的数据。

我们可以通过使用鼠标单击某个单元格或者使用箭头来导航表格视图中的单元格。QTableView拥有一个水平表头和垂直标表头。表格视图中显示的条目与其他视图中的条目一样，使用标准委托类来渲染和编辑。

QTableView常用方法：

• setModel()： 设置视图的Model类；
• horizontalHeader()： 获得水平表头；
• verticalHeader()： 获得垂直表头；
• rowHeight()： 获得每一行的高度；
• columnWidth()： 获得列的宽度；
• hideRow()： 隐藏指定行；
• showRow()： 显示指定行；
• hideColumn()： 隐藏指定列；
• showColumn()： 显示指定列；
• selectRow()： 选择指定行；
• selectColumn()： 选择指定列。

QTableView类继承关系：

 

测试QTableView

在测试代码中，我们使用QStandardItemModel作为QTableView的模型类, 对视图的属性做了一些限制（只能选中一行，只允许行选中模式，不可编辑等等）。当我们选中某一行是，在状态条上添加信息显示，在菜单栏实现了添加行和删除行的功能。完整代码如下:

import sys
from PyQt5 import QtCore, QtGui, QtWidgets
from PyQt5.QtCore import Qt,QItemSelection, QItemSelectionModel, QModelIndex
from PyQt5.QtGui import QStandardItemModel, QStandardItem
from PyQt5.QtWidgets import (QApplication, QMainWindow, QTableView,
                             QAbstractItemView, QHeaderView, QMenu, QMenuBar, QAction)
 
class DemoTableView(QMainWindow):
    def __init__(self, parent=None):
        super(DemoTableView, self).__init__(parent)   
        
         # 设置窗口标题
        self.setWindowTitle('实战PyQt5: QTableView 演示')      
        # 设置窗口大小
        self.resize(520, 360)
      
        self.initUi()
        
    def initUi(self):
        
        #行数和列数
        self.rows = 8
        self.cols = 4
        
        #设置水平表头信息
        model = QStandardItemModel(self.rows, self.cols, self)
        hTitle=[]
        for col in range(self.cols):
            hTitle.append('第{}列'.format(col+1))
        model.setHorizontalHeaderLabels(hTitle)
        #设置垂直表头信息
        vTitle=[]
        for row in range(self.rows):
            vTitle.append('第{}行'.format(row+1))
        model.setVerticalHeaderLabels(vTitle)
        
        #设置Item里的内容
        for row in range (self.rows):
            for column in range (self.cols):
                item = QStandardItem('(row %s, column %s)'%(row, column))
                model.setItem(row, column, item)
        
        tableView = QTableView(self)
        tableView.setModel(model)
        #设置只能选中一行
        tableView.setSelectionMode(QAbstractItemView.SingleSelection)
        #不可编辑
        tableView.setEditTriggers(QTableView.NoEditTriggers)
        #设置只有行选中
        tableView.setSelectionBehavior(QAbstractItemView.SelectRows)
        #所有列自动拉伸，充满界面
        tableView.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch)
        
        #显示选中行的信息
        tableView.selectionModel().currentChanged.connect(self.onCurrentChanged)
                
        self.model = model
        self.tableView = tableView
        self.setCentralWidget(tableView)
    
        #添加菜单项
        menuBar = self.menuBar()
        fileMenu = menuBar.addMenu('文件')
        editMenu = menuBar.addMenu('编辑')
        
        #退出应用
        appExit = QAction('退出', self)
        appExit.triggered.connect(self.close)
        fileMenu.addAction(appExit)
        
        #添加一行
        editAppend = QAction('添加', self)
        editAppend.triggered.connect(self.appendRow)
        #删除一行
        editRemove = QAction('删除', self)
        editRemove.triggered.connect(self.removeRow)
        editMenu.addAction(editAppend)
        editMenu.addAction(editRemove)
        
    def appendRow(self):
        row = self.model.rowCount()
        items = list()
        for col in range (self.cols):
            items.append(QStandardItem('(row %s, column %s)'%(row, col)))
        #添加一行
        self.model.appendRow(items)
        #更新头信息
        self.model.setVerticalHeaderItem(row, QStandardItem('第{}行'.format(row+1)))
    
    def removeRow(self):
        #获取选中的行
        sel = self.tableView.selectionModel().selectedRows()
        print(sel)
        if sel:
            #下面删除时，选中多行中的最后一行，会被删掉；不选中，则默认第一行删掉
            index=self.tableView.currentIndex()
            print(index.row())
            self.model.removeRow(index.row())
            
    def onCurrentChanged(self,current, previous):
        #初始化时，previous.row() = -1，不显示信息
        if int(previous.row() < 0):
             return
        self.statusBar().showMessage('选中第{}行'.format(current.row()+1))
    
if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = DemoTableView()
    window.show()
    sys.exit(app.exec()) 

运行结果如下图：

测试QTableView

本文知识点

• QTableView的行和列的属性设置；
• QTableView的选择属性的设置；
• QTableView水平和垂直表头信息设置；
• 在QTableView中添加或者删除一行。

前一篇：  实战PyQt5: 072-列表部件QListWidget