Qt:QTableWidget
作者:互联网
0、说明
QTableWidget类提供了一个基于Item的Table视图,如下图:
Table Widget提供了表格用于显示。Table中的每个Item都是QTableWidgetItem对象。
如果我们想要一个存储我们自己的model的Table,应该用QTableView而不是这个类。
Table Widget构造时,传入Table的行数和列数作为参数:
tableWidget = new QTableWidget(12, 3, this);
不过,也可以先构造一个空Table Widget,之后再为它设置行列数:
tableWidget = new QTableWidget(this); tableWidget->setRowCount(10); tableWidget->setColumnCount(5);
Item在Table外构造(没有parent widget),之后通过setItem()把它插入到Table中。
QTableWidgetItem *newItem = new QTableWidgetItem(tr("%1").arg( (row+1)*(column+1))); tableWidget->setItem(row, column, newItem);
如果我们想实现排序功能,需要在填充item之后进行,否则会被插入顺序所干扰(可以看setItem()来获取详细信息)。
Table可以设置索引行和索引列。最简单的构造方法是,通过setHorizontalHeaderLabels()和setVerticalHeaderLabels(),传入的参数是索引StringList,List中每一项都是一个索引。更成熟的方法是从已存在的Table Item构造索引Header。例如,我们可以用一个icon和一串文本(aligned text)构造一个特殊索引列。
QTableWidgetItem *cubesHeaderItem = new QTableWidgetItem(tr("Cubes")); cubesHeaderItem->setIcon(QIcon(QPixmap(":/Images/cubed.png"))); cubesHeaderItem->setTextAlignment(Qt::AlignVCenter);
Table中的行数可以通过rowCount()得知,列数可以通过columnCount()得知。通过clear()来清空Table。
1、模块和加载项
Header: | #include <QTableWidget> |
qmake: | QT += widgets |
Inherits: | QTableView |
2、构造
QTableWidget(int rows, int columns, QWidget *parent = nullptr) | 构造一个指定行列数的空Table |
QTableWidget(QWidget *parent = nullptr) | 构造一个空Table |
4、成员字段
int | columnCount | 列数 |
int | rowCount | 行数 |
6、成员方法
返回值类型 |
方法 |
说明 |
QWidget * | cellWidget(int row, int column) | 返回一个QWidget展示给定行列的cell |
void | closePersistentEditor(QTableWidgetItem *item) | 关闭当前Item编辑器 |
int | column(const QTableWidgetItem *item) | 返回参数Item的所在列 |
int | columnCount() | 一共多少列 |
int | currentColumn() | 当前Item所在列 |
QTableWidgetItem * | currentItem() | 当前Item |
int | currentRow() | 当前Item所在行 |
void | editItem(QTableWidgetItem *item) | 如果Item是可编辑的,那么开始编辑该Item |
QList<QTableWidgetItem *> | findItems(QString text, Qt::MatchFlags flags) | 查找Item |
QTableWidgetItem * | horizontalHeaderItem(int column) | 返回某一列的行Header Item |
bool | isPersistentEditorOpen(QTableWidgetItem *item) | Item编辑器是否开启 |
QTableWidgetItem * | item(int row, int column) | 提取指向指定行、列的Item的指针 |
QTableWidgetItem * |
itemAt(QPoint point) itemAt(int ax, int ay) |
提取Widget坐标系中指定坐标的Item的指针 |
QTableWidgetItem * | itemPrototype() | |
void | openPersistentEditor(QTableWidgetItem *item) | 为给定Item打开编辑器,编辑器在完成编辑后会一直开启 |
void | removeCellWidget(int row, int column) | 移除指定行列cell的Widget |
int | row(const QTableWidgetItem *item) | 返回Item的Row |
int | rowCount() | 行数 |
QList<QTableWidgetItem *> | selectedItems() | 返回一个List *,其中有所有选中的Items |
QList<QTableWidgetSelectionRange> | selectedRanges() | |
void | setCellWidget(int row, int column, QWidget *widget) |
在指定Cell处展示Widget,如果先后在同一个Cell设置了不同的Widget,那么后一个Widget会覆盖前一个 setCellWidget(row, column, new QLineEdit); ... setCellWidget(row, column, new QTextEdit); |
setColumnCount(int columns) | 重定义列数,如果小于当前列数,则会丢弃多余列 | |
setCurrentCell(int row, int column) | 设置当前Cell为指定的Cell | |
setCurrentItem(QTableWidgetItem *item) | 设置当前Item为指定的Item | |
setHorizontalHeaderItem(int column, QTableWidgetItem *item) | 设置column列的索引Item为item | |
setHorizontalHeaderLabels(QStringList labels) | 设置索引行标签 | |
setItem(int row, int column, QTableWidgetItem *item) | 设置指定行列的Item为item | |
setItemPrototype(const QTableWidgetItem *item) | ||
setRangeSelected(QTableWidgetSelectionRange range, bool select) | ||
setRowCount(int rows) | 重定义行数,多出的行会被丢弃 | |
setVerticalHeaderItem(int row, QTableWidgetItem *item) | 设置row行的索引Item为item | |
setVerticalHeaderLabels(QStringList labels) | 设置索引列标签 | |
sortItems(int column, Qt::SortOrder order = Qt::AscendingOrder) | 对Table所有行按column列和order规则进行排序 | |
QTableWidgetItem * | takeHorizontalHeaderItem(int column) | 提取指定column的索引行的Item |
QTableWidgetItem * | takeItem(int row, int column) | 提取指定行、列的Item |
QTableWidgetItem * | takeVerticalHeaderItem(int row) | 提取指定row的索引列的Item |
QTableWidgetItem * | verticalHeaderItem(int row) | 提取指定row的索引列的Item |
int | visualColumn(int logicalColumn) | 返回给定logicalColumn的可视列 |
QRect | visualItemRect(const QTableWidgetItem *item) | 返回只有指定Item的矩形视图 |
int | visualRow(int logicalRow) | 返回给定logicalRow的可视行 |
7、信号
信号 |
说明 |
cellActivated(int row, int column) | 当指定行列的cell被激活时发送该信号 |
cellChanged(int row, int column) | 当指定行列的cell中的数据被激活时发送该信号 |
cellClicked(int row, int column) | 每当Table中的一个cell被点击时发送该信号,信号中的参数是被点击的cell的行、列 |
cellDoubleClicked(int row, int column) | 每当Table中的一个cell被双击时发送该信号,信号中的参数是被双击的cell的行、列 |
cellEntered(int row, int column) | 每当鼠标光标进入一个cell时发送该信号,信号中的参数是cell的行、列 |
cellPressed(int row, int column) | 每当Table中的一个cell被按时,信号中的参数是被按的cell的行、列(可能是键盘?该信号不确定) |
currentCellChanged(int currentRow, int currentColumn, int previousRow, int previousColumn) | 每当Table中的当前聚焦的cell改变时,参数分别标明改变前后的cell的行、列 |
currentItemChanged(QTableWidgetItem *current, QTableWidgetItem *previous) | 每当Table中的当前的Item改变时,参数分别标明改变前后的Item |
itemActivated(QTableWidgetItem *item) | 每当Table中参数指明的Item激活(选中)时,发送该信号 |
itemChanged(QTableWidgetItem *item) | 每当Table中参数指明的Item改变时,发送该信号 |
itemClicked(QTableWidgetItem *item) | 每当Table中参数指明的Item被单击时,发送该信号 |
itemDoubleClicked(QTableWidgetItem *item) | 每当Table中参数指明的Item被双击时,发送该信号 |
itemEntered(QTableWidgetItem *item) | 每当鼠标焦点进入Table中的某个Item时,发送该信号,参数指明这个Item |
itemPressed(QTableWidgetItem *item) | 每当Table中的某个Item被按时,发送该信号,参数指明这个Item |
itemSelectionChanged() | 每当选中的Item改变时发送该信号 |
8、槽
槽 |
说明 |
clear() | 移除Table中的所有Item,包括索引 |
clearContents() | 移除Table中的所有Item,不包括索引。 |
insertColumn(int column) | 在column列插入一个空列 |
insertRow(int row) | 在row行插入一个空行 |
removeColumn(int column) | 移除column列 |
removeRow(int row) | 移除row行 |
scrollToItem(const QTableWidgetItem *item, QAbstractItemView::ScrollHint hint = EnsureVisible) | 上下滚动视图,以保证item始终可见 |
标签:Qt,int,QTableWidget,column,Item,QTableWidgetItem,Table,row 来源: https://www.cnblogs.com/ShineLeBlog/p/14983837.html