一、前言
QTableWidget是常用的显示数据表格的控件，使用QTableWidget时就需要QTableWidgetItem。用来表示表格中的一个单元格，整个表格就是用各个单元格构建起来的。
二、学习目标
1.QTableWidget常用方法
2.QTableWidget常用信号
3.QTableWidget组件的应用
三、知识点
1.【QTableWidget、QTableWidgetItem常用方法】
-
QTableWidget常用方法
方法 描述 setRowCount(rows) 设置QTableWidget表格控件的行数 setColumnCount(columns) 设置QTableWidget表格控件的列数 setHorizontalHeaderLabels(labels) 设置QTableWidget表格控件的水平标签 setVerticalHeaderLabels(labels) 设置QTableWidget表格控件的垂直标签 setRowHeight(row) 设置单元格行的高度 setColumnWidth(column) 设置单元格列的宽度 setItem(row,column,item) 设置QTableWidgetItem给指定的行和列 insertRow(row) 在行索引处插入行 insertColumn(column) 在列索引处插入列 removeRow(row) 在行索引处删除行 removeColumn(column) 在列索引处删除列 findItems(text,flags) 使用给定的标志查找文本与字符串文本匹配的项目 setCellWidget(row,column,widget) 给指定行和列的单元格设置组件 removeCellWidget(row,column) 删除指定行和列的单元格的组件 item(row,column) 返回给定行和列的项目（如果已设置）；否则返回None row(item) 返回该表格项的行索引 column(item) 返回该表格项的列索引 rowCount() 返回表格的所有行数 columnCount() 返回表格的所有列数 currentItem() 返回当前的表格项 currentRow() 返回当前表格项的行索引 currentColumn() 返回当前表格项的列索引 selectedItems() 返回所有选定表格项的列表 horizontalHeader().hide() 隐藏水平表头 verticalHeader().hide() 隐藏垂直表头 clear() 清除表格内容和表头 clearContents() 清除表格内容 setEditTriggers(triggers) 设置编辑规则
QAbstractItemView.NoEditTriggers0No：不能对表格内容进行修改
QAbstractItemView.CurrentChanged1Editing：任何时候都能对单元格进行修改
QAbstractItemView.DoubleClicked2Editing：双击单元格
QAbstractItemView.SelectedClicked4Editing：单击已经选中的内容
QAbstractItemView.EditKeyPressed8Editing：当修改键按下时修改单元格
QAbstractItemView.AnyKeyPressed16Editing：按任意键修改单元格
QAbstractItemView.AllEditTriggers31Editing：包括以上所有条件setSelectionBehavior(behavior) 设置表格选择行为
QAbstractItemView.SelectItems0Selecting：选中单个单元格
QAbstractItemView.SelectRows1Selecting：选中一行
QAbstractItemView.SelectColumns2Selecting：选中一列 -
QTableWidgetItem常用方法
方法 描述 checkState() 返回复选状态 setCheckState(state) 设置复选框的勾选状态
Qt.Checked：选中状态
Qt.PartiallyChecked：半选中状态
Qt.Unchecked：没有被选中icon() 返回列表项的图标 setIcon(icon) 设置列表项的图标 isHidden() 返回列表项是否隐藏，如果隐藏返回True;不隐藏返回False setHidden(hide) 设置列表项是否隐藏，如果True则隐藏;False则不隐藏 text() 返回列表项的文本 setText(text) 设置列表项的文本 flags() 返回列表项的项目标志 setForeground(brush) 设置前景色 setBackground(brush) 设置背景色 setFlags(flags) 设置列表项的项目标志设置为flags setTextAlignment(alignment) 单元格文本对齐方式
Qt.AlignLeft：将单元格内的内容沿单元格的左边缘对齐
Qt.AlignRight：将单元格内的内容沿单元格的右边缘对齐
Qt.AlignHCenter：在可用空间中，居中显示在水平方向上
Qt.AlignJustify：将文本在可用空间内对齐，默认从左到右
Qt.AlignTop：与顶部对齐
Qt.AlignBottom：与底部对齐
Qt.AlignVCenter：在可用空间中，居中显示在垂直方向上
Qt.AlignBaseline：与基线对齐
2.【QTableWidget常用信号】
| 信号 | 描述 |
|---|---|
| itemClicked(item) | 当单击表格中单元格时，发射此信号 |
| itemDoubleClicked(item) | 当双击表格中单元格时，发射此信号 |
| itemChanged(item) | 当改变表格中单元格时，发射此信号 |
| itemEntered(item) | 当鼠标光标进入表格的单元格时，发射此信号 |
| itemPressed(item) | 当鼠标在表格的单元格上按下时，发射此信号 |
| itemSelectionChanged() | 当选择的单元格发生改变时，发射此信号 |
| cellClicked(row,column) | 当单击表格中单元格时，发射此信号 |
| cellDoubleClicked(row,column) | 当双击表格中单元格时，发射此信号 |
| cellEntered(row,column) | 当鼠标光标进入表格的单元格时，发射此信号 |
| cellPressed(row,column) | 当鼠标在表格的单元格上按下时，发射此信号 |
3.【QTableWidget组件的应用】
import sys
from PyQt5.QtCore import Qt
from PyQt5.QtGui import QIcon, QBrush, QColor
from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QPushButton, QTableWidget, QTableWidgetItem
class QmyWidget(QWidget):
def __init__(self, parent=None):
super().__init__(parent) # 调用父类的构造函数，创建QWidget窗体
self.setupUi()
def setupUi(self):
"""页面初始化"""
# 设置窗体大小及标题
self.resize(500, 400)
self.setWindowTitle("QTableWidget组件示例")
# 创建布局
self.layout = QVBoxLayout()
# QTableWidget组件定义
self.tableWidget = QTableWidget()
# QTableWidget组件设置
self.tableWidget.setRowCount(3) # 给列表设置行数
self.tableWidget.setColumnCount(3) # 给表格设置列数
self.tableWidget.setHorizontalHeaderLabels(["姓名", "性别", "体重"]) # 设置行标题
self.tableWidget.setVerticalHeaderLabels(["a", "b", "c"]) # 设置列标题
self.tableWidget.setRowHeight(0, 100) # 设置第1行行宽100
self.tableWidget.setColumnWidth(0, 100) # 设置第1列列宽100
# self.tableWidget.horizontalHeader().hide() # 隐藏水平表头
self.tableWidget.verticalHeader().hide() # 隐藏垂直表头
# 设置表格项
for row in range(3):
for col in range(3):
item = QTableWidgetItem("第%d行 %d列" % (row, col))
self.tableWidget.setItem(row, col, item)
# 绑定信号
self.tableWidget.itemChanged.connect(self.on_tableWidget_itemChanged)
# 创建两个按钮组件
self.button1 = QPushButton("插入行和列", self)
self.button1.clicked.connect(self.insert_item) # 为button绑定槽函数
self.button2 = QPushButton("删除行和列", self)
self.button2.clicked.connect(self.delete_item) # 为button绑定槽函数
self.button3 = QPushButton("查询单元格", self)
self.button3.clicked.connect(self.select_item) # 为button绑定槽函数
# 将组件添加到布局中
self.layout.addWidget(self.tableWidget)
self.layout.addWidget(self.button1)
self.layout.addWidget(self.button2)
self.layout.addWidget(self.button3)
# 为窗体添加布局
self.setLayout(self.layout)
def insert_item(self):
"""新增item槽函数"""
print("item新增成功！")
self.tableWidget.insertRow(0)
self.tableWidget.insertColumn(0)
def delete_item(self):
"""删除item槽函数"""
print("item删除成功！")
self.tableWidget.removeRow(0)
self.tableWidget.removeColumn(0)
def select_item(self):
"""查询item槽函数"""
print("item查询成功！")
# 查询第1行 1列并设置颜色
item_list = self.tableWidget.findItems("第1行 1列", Qt.MatchContains | Qt.MatchRecursive)
for item in item_list:
item.setBackground(QBrush(QColor(0, 255, 0)))
item.setForeground(QBrush(QColor(255, 0, 0)))
def on_tableWidget_itemChanged(self, item):
"""槽函数"""
print(item.text())
if __name__ == '__main__':
app = QApplication(sys.argv)
myMain = QmyWidget()
myMain.show()
sys.exit(app.exec_())