QTableWidget

前言

QTableWidget是Qt程序中常用的显示数据表格的控件，类似于c#中的DataGrid。QTableWidget是QTableView的子类，它使用标准的数据模型，并且其单元数据是通过QTableWidgetItem对象来实现的，使用QTableWidget时就需要QTableWidgetItem。用来表示表格中的一个单元格，整个表格就是用各个单元格构建起来的

QTableWidget类中的常用方法

方法	描述
setRowCount(int row)	设置QTableWidget表格控件的行数
setColumnCount(int col)	设置QTableWidget表格控件的列数
setHorizontalHeaderLabels()	设置QTableWidget表格控件的水平标签
setVerticalHeaderLabels()	设置QTableWidget表格控件的垂直标签
setItem(int ,int ,QTableWidgetItem)	在QTableWidget表格控件的每个选项的单元控件内添加控件
horizontalHeader()	获得QTableWidget表格控件的表格头，以便执行隐藏
rowCount()	获得QTableWidget表格控件的行数
columnCount()	获得QTableWidget表格控件的列数
setEditTriggers(EditTriggers triggers)	设置表格是否可以编辑，设置表格的枚举值
setSelectionBehavior	设置表格的选择行为
setTextAlignment()	设置单元格内文本的对齐方式
setSpan(int row,int column,int rowSpanCount,int columnSpanCount)	合并单元格，要改变单元格的第row行，column列，要合并rowSpancount行数和columnSpanCount列数
	row：要改变的行数
	column：要改变的列数
	rowSpanCount：需要合并的行数
	columnSpanCount：需要合并的列数
setShowGrid()	在默认情况下表格的显示是有网格的，可以设置True或False用于是否显示，默认True
setColumnWidth(int column,int width)	设置单元格行的宽度
setRowHeight(int row,int height)	设置单元格列的高度

编辑规则的枚举值类型

选项	值	描述
QAbstractItemView.NoEditTriggers0No	0	不能对表格内容进行修改
QAbstractItemView.CurrentChanged1Editing	1	任何时候都能对单元格进行修改
QAbstractItemView.DoubleClicked2Editing	2	双击单元格
QAbstractItemView.SelectedClicked4Editing	4	单击已经选中的内容
QAbstractItemView.EditKeyPressed8Editing	8	当修改键按下时修改单元格
QAbstractItemView.AnyKeyPressed16Editing	16	按任意键修改单元格
QAbstractItemView.AllEditTriggers31Editing	31	包括以上所有条件

表格选择行为的枚举值

选择	值	描述
QAbstractItemView.SelectItems0Selecting	0	选中单个单元格
QAbstractItemView.SelectRows1Selecting	1	选中一行
QAbstractItemView.SelectColumns2Selecting	2	选中一列

单元格文本水平对齐方式

选项	描述
Qt.AlignLeft	将单元格内的内容沿单元格的左边缘对齐
Qt.AlignRight	将单元格内的内容沿单元格的右边缘对齐
Qt.AlignHCenter	在可用空间中，居中显示在水平方向上
Qt.AlignJustify	将文本在可用空间内对齐，默认从左到右

单元格文本垂直对齐方式

选项	描述
Qt.AlignTop	与顶部对齐
Qt.AlignBottom	与底部对齐
Qt.AlignVCenter	在可用空间中，居中显示在垂直方向上
Qt.AlignBaseline	与基线对齐

如果要设置水平和垂直方向对齐方式，比如在表格空间内上下，左右居中对齐，那么只要使用Qt,AlignHCenter和Qt,AlignVCenter即可

实例：QTableWidget的基本用法

import sys
from PyQt5.QtWidgets import *class Table(QWidget):def __init__(self):super(Table, self).__init__()self.initUI()def initUI(self):self.setWindowTitle("QTableWidget例子")self.resize(400,300)layout=QHBoxLayout()#实现的效果是一样的，四行三列，所以要灵活运用函数，这里只是示范一下如何单独设置行列TableWidget=QTableWidget(4,3)# TableWidget = QTableWidget()# TableWidget.setRowCount(4)# TableWidget.setColumnCount(3)#设置水平方向的表头标签与垂直方向上的表头标签，注意必须在初始化行列之后进行，否则，没有效果TableWidget.setHorizontalHeaderLabels(['姓名','性别','体重（kg）'])#Todo 优化1 设置垂直方向的表头标签#TableWidget.setVerticalHeaderLabels(['行1', '行2', '行3', '行4'])#TODO 优化 2 设置水平方向表格为自适应的伸缩模式##TableWidget.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch)#TODO 优化3 将表格变为禁止编辑#TableWidget.setEditTriggers(QAbstractItemView.NoEditTriggers)#TODO 优化 4 设置表格整行选中#TableWidget.setSelectionBehavior(QAbstractItemView.SelectRows)#TODO 优化 5 将行与列的高度设置为所显示的内容的宽度高度匹配#QTableWidget.resizeColumnsToContents(TableWidget)#QTableWidget.resizeRowsToContents(TableWidget)#TODO 优化 6 表格头的显示与隐藏#TableWidget.verticalHeader().setVisible(False)#TableWidget.horizontalHeader().setVisible(False)#TOdo 优化7 在单元格内放置控件# comBox=QComboBox()# comBox.addItems(['男','女'])# comBox.addItem('未知')# comBox.setStyleSheet('QComboBox{margin:3px}')# TableWidget.setCellWidget(0,1,comBox)## searchBtn=QPushButton('修改')# searchBtn.setDown(True)# searchBtn.setStyleSheet('QPushButton{margin:3px}')# TableWidget.setCellWidget(0,2,searchBtn)#添加数据newItem=QTableWidgetItem('张三')TableWidget.setItem(0,0,newItem)newItem=QTableWidgetItem('男')TableWidget.setItem(0,1,newItem)newItem=QTableWidgetItem('160')TableWidget.setItem(0,2,newItem)layout.addWidget(TableWidget)self.setLayout(layout)
if __name__ == '__main__':app=QApplication(sys.argv)win=Table()win.show()sys.exit(app.exec_())

初始运行程序，显示效果如下

代码分析

构造一个QTableWidget对象，设置表格为4行3列

TableWidget=QTableWidget(4,3)

设置表格头

TableWidget.setHorizontalHeaderLabels(['姓名','性别','体重（kg）'])

生成一个QTableWidgetItem对象，并添加到表格的0行0列处

 newItem=QTableWidgetItem('张三')TableWidget.setItem(0,0,newItem)

优化1:设置垂直方向表格头标签

TableWidget.setVerticalHeaderLabels(['行1', '行2', '行3', '行4'])

效果如下

优化2：设置表格头为伸缩模式
使用QTableWidget对象的horizontalHeader（）函数，设置表格为自适应的伸缩模式，即可根据窗口的大小来改变网格的大小

TableWidget.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch)

优化3：将表格设置为禁止编辑
在默认情况下，表格中的字符是可以更改的，比如双击一个单元格，就可以修改原来的内容，如果想禁止这种操作，让表格对用户只是只读，则可以编辑一下代码

TableWidget.setEditTriggers(QAbstractItemView.NoEditTriggers)

优化4：表格整行选中
表格默认选择的是单个单元格，通过以下代码可以设置整行选中

 TableWidget.setSelectionBehavior(QAbstractItemView.SelectRows)

优化5：将行与列的宽度高度与文本内容的宽高相匹配

QTableWidget.resizeColumnsToContents(TableWidget)
QTableWidget.resizeRowsToContents(TableWidget)

优化6：表格头的显示与隐藏

TableWidget.verticalHeader().setVisible(False)
TableWidget.horizontalHeader().setVisible(False)

优化7：在单元格内放置控件
QTableWidget不仅允许往单元格内放置文字，还允许放置控件，通过QTableWidget.setItem()来添加PyQt的基本控件
这里把一个下拉列表框和一个按钮加入单元格中，设置控件与单元格的边距，如为3px像素，代码如下

         comBox=QComboBox()comBox.addItems(['男','女'])comBox.addItem('未知')comBox.setStyleSheet('QComboBox{margin:3px}')TableWidget.setCellWidget(0,1,comBox)searchBtn=QPushButton('修改')searchBtn.setDown(True)searchBtn.setStyleSheet('QPushButton{margin:3px}')TableWidget.setCellWidget(0,2,searchBtn)

实例二：在表格中快速定位到指定行

import sys
from PyQt5.QtWidgets import *
from PyQt5.QtGui import *
from PyQt5.QtCore import *class Table(QWidget):def __init__(self):super(Table, self).__init__()self.initUI()def initUI(self):#设置标题与初始大小self.setWindowTitle('QTableWidget例子')self.resize(600,800)##水平布局layout=QHBoxLayout()#实例化表格视图（30*4）tablewidget=QTableWidget(30,4)layout.addWidget(tablewidget)for i in range(30):for j in range(4):itemContent='(%d,%d)'%(i,j)#为每个表格内添加数据tablewidget.setItem(i,j,QTableWidgetItem(itemContent))self.setLayout(layout)#遍历表格查找对应项text='(10,1)'items=tablewidget.findItems(text,Qt.MatchExactly)item=items[0]#选中单元格item.setSelected(True)#设置单元格的背脊颜色为红item.setForeground(QBrush(QColor(255,0,0)))row=item.row()#通过鼠标滚轮定位，快速定位到第十一行tablewidget.verticalScrollBar().setSliderPosition(row)
if __name__ == '__main__':app=QApplication(sys.argv)table=Table()table.show()sys.exit(app.exec_())

效果如图

实例三：QTableWidget的高级用法


import sys
from PyQt5.QtWidgets import (QWidget, QTableWidget, QHBoxLayout, QApplication, QTableWidgetItem)
from PyQt5.QtGui import QBrush, QColor, QFont
from PyQt5.QtCore import Qtclass Table(QWidget):def __init__(self):super().__init__()self.initUI()def initUI(self):#设置标题与初始大小self.setWindowTitle("QTableWidget 例子")self.resize(430, 230)#水平布局，初始表格为（4*3），添加到布局中conLayout = QHBoxLayout()tableWidget = QTableWidget(5,3)conLayout.addWidget(tableWidget)#设置水平头标签tableWidget.setHorizontalHeaderLabels(['姓名', '性别', '体重(kg)'])#创建新条目，设置背景颜色，添加到表格指定行列中newItem = QTableWidgetItem("张三")#newItem.setForeground(QBrush(QColor(255, 0, 0)))tableWidget.setItem(0, 0, newItem)# 创建新条目，设置背景颜色，添加到表格指定行列中newItem = QTableWidgetItem("男")#newItem.setForeground(QBrush(QColor(255, 0, 0)))tableWidget.setItem(0, 1, newItem)# 创建新条目，设置背景颜色，添加到表格指定行列中newItem = QTableWidgetItem("160")#newItem.setForeground(QBrush(QColor(255, 0, 0)))tableWidget.setItem(0, 2, newItem)# newItem = QTableWidgetItem("李四")# #将字体加粗，黑色字体# newItem.setFont(QFont('Times',12,QFont.Black))# tableWidget.setItem(1, 0, newItem)## # 创建新条目，设置背景颜色，添加到表格指定行列中# newItem = QTableWidgetItem("男")# newItem.setFont(QFont('Times', 12, QFont.Black))# tableWidget.setItem(1, 1, newItem)## # 创建新条目，设置背景颜色，添加到表格指定行列中# newItem = QTableWidgetItem("150")# newItem.setFont(QFont('Times', 12, QFont.Black))# tableWidget.setItem(1, 2, newItem)## newItem = QTableWidgetItem("王五")# #将字体加粗，黑色字体# newItem.setFont(QFont('Times',12,QFont.Black))# tableWidget.setItem(2, 0, newItem)## # 创建新条目，设置背景颜色，添加到表格指定行列中# newItem = QTableWidgetItem("女")# newItem.setFont(QFont('Times', 12, QFont.Black))# tableWidget.setItem(2, 1, newItem)## # 创建新条目，设置背景颜色，添加到表格指定行列中# newItem = QTableWidgetItem("175")# newItem.setFont(QFont('Times', 12, QFont.Black))# 设置单元格文本的对齐方式#newItem.setTextAlignment(Qt.AlignRight|Qt.AlignBottom)#tableWidget.setItem(2, 2, newItem)#按照体重排序#Qt.DescendingOrder降序#Qt.AscEndingOrder升序#tableWidget.sortItems(2,Qt.DescendingOrder)#合并单元格#tableWidget.setSpan(2,0,4,1)#设置单元格的大小#将第一列的单元宽度设置为150#tableWidget.setColumnWidth(0,150)#将第一行的单元格高度的设置为120#tableWidget.setRowHeight(0,120)#表格中不显示分割线#tableWidget.setShowGrid(False)#隐藏垂直头标签#tableWidget.verticalHeader().setVisible(False)self.setLayout(conLayout)if __name__ == '__main__':app = QApplication(sys.argv)example = Table()example.show()sys.exit(app.exec_())

初始运行，效果如下

优化1：设置单元格的文本颜色，将第一行中的三个文本颜色设置为红色

newItem.setForeground(QBrush(QColor(255, 0, 0)))

优化2：将字体加粗

#设置字体类型，大小号，颜色
newItem.setFont(QFont('Times',12,QFont.Black))

优化3：设置单元格的排序方式

from PyQt5.QtCore import Qt
#按照体重排序
#Qt.DescendingOrder降序
#Qt.AscEndingOrder升序
tableWidget.sortItems(2,Qt.DescendingOrder)

优化4：单元格的文本对齐方式
这里更改了王五体重的文本对齐方式为右下角处

         # 设置单元格文本的对齐方式(右下)newItem.setTextAlignment(Qt.AlignRight|Qt.AlignBottom)tableWidget.setItem(2, 2, newItem)

优化5：合并单元格
将表格中第一行第一列的单元格，更改为占据5行1列

#合并单元格
tableWidget.setSpan(2,0,5,1)

优化6：设置单元格的大小
这里将第一行宽度设置为150，高度设置为120

#将第一列的单元宽度设置为150
tableWidget.setColumnWidth(0,150)
#将第一行的单元格高度的设置为120
tableWidget.setRowHeight(0,120)

优化7：在表格中不显示分割线
QTableWidget类的setShowGrid（）函数是从QTableView类继承的，用来设置是否显示表格的分割线，默认显示分割线

 #表格中不显示分割线
tableWidget.setShowGrid(False)

优化8：为单元格添加图片
还可以在单元格内添加图片并显示图片描述信息，代码如下
这里图片放置在王五体重的单元格内

#添加图片
newItem = QTableWidgetItem(QIcon("./images/bao1.png"), "背包")
tableWidget.setItem(2, 2, newItem)

实例四：单元格内图片的显示


import sys
from PyQt5.QtWidgets import *
from PyQt5.QtGui import *
from PyQt5.QtCore  import *class Table(QWidget):def __init__(self):super().__init__()self.initUI()def initUI(self):#设置标题与初始大小self.setWindowTitle("QTableWidget 例子")self.resize(1000 ,900);#设置布局，初始表格5*3conLayout = QHBoxLayout()table= QTableWidget(5,3)#设置表格水平头标签table.setHorizontalHeaderLabels(['图片1' ,'图片2' ,'图片3'])#设置不可编辑模式table.setEditTriggers( QAbstractItemView.NoEditTriggers)#设置图片的大小table.setIconSize(QSize(300 ,200))#设置所有行列宽高数值与图片大小相同for i in range(3):   # 让列宽和图片相同table.setColumnWidth(i , 300)for i in range(5):   # 让行高和图片相同table.setRowHeight(i , 200)for k in range(15):i = k/ 3j = k % 3#实例化表格窗口条目item = QTableWidgetItem()#用户点击表格时，图片被选中item.setFlags(Qt.ItemIsEnabled)#图片路径设置与图片加载icon = QIcon(r'.\images\bao%d.png' % k)item.setIcon(QIcon(icon))#输出当前进行的条目序号print('e/icons/%d.png i=%d  j=%d' % (k, i, j))#将条目加载到相应行列中table.setItem(i, j, item)conLayout.addWidget(table)self.setLayout(conLayout)if __name__ == '__main__':app = QApplication(sys.argv)example = Table()example.show()sys.exit(app.exec_())

效果如下

实例五：支持右键菜单

import sys
from PyQt5.QtWidgets import *
from PyQt5.QtCore import *
from PyQt5.QtGui import *class Table(QWidget):def __init__(self):super(Table, self).__init__()self.initUI()def initUI(self):# 设置标题与初始大小self.setWindowTitle('QTableWidget demo')self.resize(500, 300)# 水平布局，初始表格5*3，添加到布局layout = QHBoxLayout()self.tableWidget = QTableWidget(5, 3)layout.addWidget(self.tableWidget)# 设置表格水平方向的头标签self.tableWidget.setHorizontalHeaderLabels([ '姓名', '性别', '体重' ])# 设置水平方向自动伸缩填满窗口self.tableWidget.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch)# 添加数据到指定行列newItem = QTableWidgetItem("张三")self.tableWidget.setItem(0, 0, newItem)newItem = QTableWidgetItem("男")self.tableWidget.setItem(0, 1, newItem)newItem = QTableWidgetItem("160")self.tableWidget.setItem(0, 2, newItem)newItem = QTableWidgetItem("李四")self.tableWidget.setItem(1, 0, newItem)newItem = QTableWidgetItem("女")self.tableWidget.setItem(1, 1, newItem)newItem = QTableWidgetItem("120")self.tableWidget.setItem(1, 2, newItem)# 允许右键产生菜单self.tableWidget.setContextMenuPolicy(Qt.CustomContextMenu)# 将右键菜单绑定到槽函数generateMenuself.tableWidget.customContextMenuRequested.connect(self.generateMenu)self.setLayout(layout)def generateMenu(self, pos):# 计算有多少条数据，默认-1,row_num = -1for i in self.tableWidget.selectionModel().selection().indexes():row_num = i.row()# 表格中只有两条有效数据，所以只在前两行支持右键弹出菜单if row_num < 2:menu = QMenu()item1 = menu.addAction(u'选项一')item2 = menu.addAction(u'选项二')item3 = menu.addAction(u'选项三')action = menu.exec_(self.tableWidget.mapToGlobal(pos))# 显示选中行的数据文本if action == item1:print('你选了选项一，当前行文字内容是：', self.tableWidget.item(row_num, 0).text(),self.tableWidget.item(row_num, 1).text(),self.tableWidget.item(row_num, 2).text())if action == item2:print('你选了选项二，当前行文字内容是：', self.tableWidget.item(row_num, 0).text(),self.tableWidget.item(row_num, 1).text(),self.tableWidget.item(row_num, 2).text())if action == item3:print('你选了选项三，当前行文字内容是：', self.tableWidget.item(row_num, 0).text(),self.tableWidget.item(row_num, 1).text(),self.tableWidget.item(row_num, 2).text())if __name__ == '__main__':app = QApplication(sys.argv)example = Table()example.show()sys.exit(app.exec_())

文章目录

QTableWidget
- 前言
- QTableWidget类中的常用方法
- 编辑规则的枚举值类型
- 表格选择行为的枚举值
- 单元格文本水平对齐方式
- 单元格文本垂直对齐方式
- 实例：QTableWidget的基本用法
- 代码分析
- 实例二：在表格中快速定位到指定行
- 实例三：QTableWidget的高级用法
- 实例四：单元格内图片的显示
- 实例五：支持右键菜单

PyQt5高级界面控件之QTableWidget（四）相关推荐

PyQt5高级界面控件之QDockWidget
使用PyQt5高级界面控件之QDockWidget实现主页面模块关闭与显示前言 QDockWidget是一个可以停靠在QMainWindow内的窗口控件,它可以保持在浮动状态或者在指定位置作为子窗口 ...
PyQt高级界面控件及操作
PyQt高级界面控件一.表格与树结构 1.表格 1.代码示例 2.代码解析: 3.补充说明属性参数 2.树结构 1.自定义树结构 2.系统定制模式二.QStackedWidget组件三.QTab ...
基于PyQt5实现界面控件自适应大小
基于PyQt5实现界面控件自适应大小界面控件自适应大小,点击窗口放大后,界面控件大小随之发生变化. 实现效果实例1 点击窗口放大后: 实例2
PYQT5(17)-高级界面控件-表格与树
表格与树解决的问题是如何在一个控件中有规律地呈现更多的数据.PyQt提供了两种控件类用于解决该问题,其中一种是表格结构的控件类:另一种是树形结构的控件类. QTableView 以表格形式输出信息,可 ...
python日历gui_python GUI库图形界面开发之PyQt5日期时间控件QDateTimeEdit详细使用方法与实例...
PyQt5日期时间控件QDateTimeEdit介绍 QDateTimeEdit是一个允许用户编辑日期时间的控件,可以使用键盘上的上下键头按钮来增加或减少日期的时间值,QDateTimeEdit通过s ...
移动界面控件Essential Studio for Mobile MVC网格控件解析
移动界面控件Essential Studio for Mobile MVC是Syncfusion公司旗下一款企业级的用于移动应用开发的界面控件,整个套包中包含了grids.charts.gauges. ...
C#多线程操作界面控件的解决方案
C#中利用委托实现多线程跨线程操作 - 张小鱼 2010-10-22 08:38 在使用VS2005的时候,如果你从非创建这个控件的线程中访问这个控件或者操作这个控件的话就会抛出这个异常.这是微软为了 ...
界面控件包Essential Studio for Windows Forms 2017 v3发布丨附下载
2019独角兽企业重金招聘Python工程师标准>>> Essential Studio for Windows Forms界面控件包含了高性能的Windows应用程序开发中所需的所 ...
qtabwidget设置表头_Qt GUI图形图像开发之QT表格控件QTableView,QTableWidget复杂表头(多行表头) 及冻结、固定特定的行的详细方法与实例...
我们在开发过程中对于表格使用频率还是挺高的,使用QT框架开发时候我们使用QTableView或者QTableWidget创建表格. 其中表格分为表格头与表格体: 对于简单地表格,我们可以设置表头来满 ...

PyQt5高级界面控件之QTableWidget（四）