当前位置：首页 > news >正文

[Qt]常用控件介绍-多元素控件-QListWidget、QTableWidget、QQTreeWidget

news 2025/7/13 9:49:58

1.多元素控件介绍

2.ListWidget控件

属性

核心方法

核心信号

细节

Demo：编辑日程

3.TableWidget控件

核心方法

QTableWidgetItem核心信号

QTableWidgetItem核心方法

细节

Demo：编辑学生信息

4.TreeWidget控件

核心方法

核心信号

QTreeWidgetItem核心方法

细节

控件使用案例

1.多元素控件介绍

Qt中为我们提供的多元素控件有QListWidget、QListView、QTableWidget、QTableView、QTreeWidget、QTreeView六个。那么我可以发现，他们是两两一组，xxxWidget和xxxView两种形式，那么他俩之间有什么区别呢？

xxxView是更底层的实现，xxxWidget是基于xxxView封装而来的，用户使用起来比较容易。此处的xxxView是MVC结构的实现，MVC是软件开发中非常经典的软件结构组织形式。

M：model数据 V：view视图（界面） C：controller控制器，数据和视图之间的业务流程。

对于xxxView来说只是负责了上述的视图，不负责数据如何表示，以及数据和视图之间如何交互，如果用户使用xxxView的话，就需要自己创建model对象，和视图关联起来。而QxxxWidget则是QxxxView的子类，对Model进行了封装，不需要我们自己去创建model对象，直接向xxxWidget中添加数据即可。

2.ListWidget控件

该控件表示的是一个纵向的列表

属性

属性	说明
currentRow	当前被选中的是第几行
count	一共有多少行
sortingEnabled	是否允许排序
isWrapping	是否允许换行
itemAlignment	元素的对齐方式
selectRectVisible	被选中的元素矩形是否可见
spacing	元素之间的间隔

核心方法

方法	说明
addItem(QString& label) addItem(QListWidgetItem* item)	列表中添加元素
currentItem()	返回当前选中的QListWidgetItem* 对象元素
setCurrentItem(QListWidgetItem* item)	设置选中哪一个元素
setCurrentRow(int row)	设置选中第几行的元素
insertItem(const QString& label, int row) insertItem(QListWidgetItem* item, int row)	第一个是添加到最后一行，这个方法是插入到第row行
item(int row)	获取第row行的QListWidgetItem* 对象元素
takeItem(int row)	删除指定行的元素，返回删除的元素对象

核心信号

信号	说明
currentItemChanged(QListWidgetItem* current, QListWidgetItem* old)	选中不同元素的时候会触发，参数是当前选中的元素和之前选中的元素
currentRowChanged(int)	选中不同元素的时候触发，参数是当前选中元素的行数
itemClicked(QListWidgetItem* item)	点击某个元素的时候触发
itemDoubleClicked(QListWidgetItem* item)	双击某个元素的时候触发
itemEntered(QListWidgetItem* item)	鼠标进入元素范围触发

细节

对于一个QListWidget控件，内部的元素是一个个的QListWidgetItem组成的。本质上改类的内部就是一个文本+图标构成，所以QListWidgetItem内部提供了很多操作文本和图标的方法。例如：设置字体、设置图标、设置对齐方式等内容。

Demo：编辑日程

该demo中有QListWidget控件来显示日程列表，提供了两个按钮去进行操作日程表的添加和删除的操作，为添加按钮设置一个QLineEdit控件，在增加的时候，获取QLineEdit控件输入的内容，然后添加到日程表当中。删除的时候，获取到选中的是第几行，然后进行调用方法删除。

#include "widget.h"
#include "ui_widget.h"Widget::Widget(QWidget *parent): QWidget(parent), ui(new Ui::Widget)
{ui->setupUi(this);//初始化日程表//以字符串形式添加元素ui->listWidget->addItem("健身");ui->listWidget->addItem("学习");ui->listWidget->addItem("打球");//用对象的形式添加元素QListWidgetItem* item = new QListWidgetItem("玩游戏");ui->listWidget->addItem(item);//匿名对象添加元素ui->listWidget->addItem(new QListWidgetItem("吃饭"));
}Widget::~Widget()
{delete ui;
}//增加日程
void Widget::on_pushButton_add_clicked()
{//获取lineEdit单行输入框中的内容const QString str = ui->lineEdit->text();//设置到listWidegt控件中ui->listWidget->addItem(new QListWidgetItem(str));
}//删除日程
void Widget::on_pushButton_del_clicked()
{//获取到被选中的元素的行号int row = ui->listWidget->currentRow();if(row < 0)return;//删除ui->listWidget->takeItem(row);
}

3.TableWidget控件

该控件表示的是一个表格控件，包括横向和纵向两个方向由若干行若干列组成，每一个表格都是由一个QTableWidgetItem对象构成。

核心方法

方法	说明
item(int row, int column)	根据行数和列数获取指定的QTableWidgetItem*对象
setItem(int row, int column, QTbleWidget*)	根据行数列数设置表格中的元素
currentItem()	返回被选中的表格QTableWidgetItem对象
currentRow()	返回被选中的是第几行
currentColumn()	返回被选中的是第几列
row(QTableWidgetItem*)	获取指定item是第几行
column(QTableWidgetItem*)	获取指定item是第几列
rowCount()	获取行数
columnCount()	获取列数
insertRow(int row)	在第row行插入
insertColumn(int column)	在第column列插入
removeRow(int row)	删除第row行
removeColumn(int column)	删除第column列
setHorizontalHeaderItem(int column, QTableWidget*)	设置指定列的表头
setVericalHeaderItem(int row, QTableWidget*)	设置指定行的表头

QTableWidgetItem核心信号

信号	说明
cellClicked(int row, int column)	点击单元格的时候触发
cellDoubleClicked(int row, int column)	双击单元格的时候触发
cellEntered(int row, int column)	鼠标进入单元格的时候触发
currentCellChanged(int row, int column, int prevuiousRow, int previousColumn)	选中不同的单元格的时候触发

QTableWidgetItem核心方法

方法	说明
row()	获取当前在第几行
column()	获取当前在第几列
setText(const QString&)	设置文本
setTextAlignment(int)	设置文本呢对齐方式
setlcon(const QIcon&)	设置图标
setSelected(bool)	设置被选中
setSizeHints(const QSize&)	设置尺寸
setFont(onst QFont&)	设置字体

细节

对于单元格默认程序运行之后是可以编写文本内容的，如果我们不想让用户去修改单元格中的内容的话，需要设置：

ui->tableWidget->setEditTriggers(QAbstractItemView::NoEditTriggers);

Demo：编辑学生信息

#include "widget.h"
#include "ui_widget.h"Widget::Widget(QWidget *parent): QWidget(parent), ui(new Ui::Widget)
{ui->setupUi(this);ui->lineEdit->setPlaceholderText("请输入新增的列名称");//创建3行3列ui->tableWidget->insertRow(0);ui->tableWidget->insertRow(1);ui->tableWidget->insertRow(2);ui->tableWidget->insertColumn(0);ui->tableWidget->insertColumn(1);ui->tableWidget->insertColumn(2);//设置每一列的名称ui->tableWidget->setHorizontalHeaderItem(0, new QTableWidgetItem("学号"));ui->tableWidget->setHorizontalHeaderItem(1, new QTableWidgetItem("姓名"));ui->tableWidget->setHorizontalHeaderItem(2, new QTableWidgetItem("电话号"));//添加初始数据ui->tableWidget->setItem(0, 0, new QTableWidgetItem("2000"));ui->tableWidget->setItem(0, 1, new QTableWidgetItem("zhangsan"));ui->tableWidget->setItem(0, 2, new QTableWidgetItem("000-0000-0000"));ui->tableWidget->setItem(1, 0, new QTableWidgetItem("2001"));ui->tableWidget->setItem(1, 1, new QTableWidgetItem("lisi"));ui->tableWidget->setItem(1, 2, new QTableWidgetItem("123-4567-8901"));ui->tableWidget->setItem(2, 0, new QTableWidgetItem("2002"));ui->tableWidget->setItem(2, 1, new QTableWidgetItem("wangwu"));ui->tableWidget->setItem(2, 2, new QTableWidgetItem("342-4483-1992"));
}Widget::~Widget()
{delete ui;
}//增加一行
void Widget::on_pushButton_add_row_clicked()
{//获取行数int row_count = ui->tableWidget->rowCount();//增加一行ui->tableWidget->insertRow(row_count);
}//增加一列
void Widget::on_pushButton_column_add_clicked()
{//获取列数int column_count = ui->tableWidget->columnCount();//获取新增列的表头const QString str = ui->lineEdit->text();//如果为空的话，就不添加了if(str.isEmpty())return;//增加一列ui->tableWidget->insertColumn(column_count);//设置表头ui->tableWidget->setHorizontalHeaderItem(column_count, new QTableWidgetItem(str));
}//删除选中行
void Widget::on_pushButton_row_del_clicked()
{//获取当前选中的行int row = ui->tableWidget->currentRow();//删除ui->tableWidget->removeRow(row);
}//删除选中列
void Widget::on_pushButton_column_del_clicked()
{//获取当前选中的列int column = ui->tableWidget->currentColumn();//删除ui->tableWidget->removeColumn(column);
}

4.TreeWidget控件

该控件表示的是一个树形的控件，里面的每一元素都是一个QTreeWidgetItem对象，该对象内部可以包含多个文本和图标，每一个文本或者图标是一列。可以给QTreeWidget设置顶层节点，顶层节点可以是多个，然后再给顶层节点添加子节点，从而构成了树形结构。

核心方法

方法	说明
clear()	清空所有子节点
addTopLevelItem(QTreeWidegtItem* item)	新增顶层节点
topLevelItem(int index)	获取指定下标的顶层节点
topLevelItemCount()	获取顶层节点的个数
indexOfTopLevelItem(QTreeWidgetItem* item)	查询指定节点在顶层节点中的下标
takeTopLevelItem(int index)	删除指定的顶层节点，返回删除的QTreeWidgetItem*元素对象
currentItem()	获取到当前选中的节点，返回QTreeWidgetItem元素怒对象
setCurrentItem(QTreeWidgetItem* item)	选中指定节点
setExpanded(bool)	展开/关闭节点
setHeaderLabel(const QString& text)	设置TreeWidget的header名称

核心信号

信号	说明
currentChanged(QTreeWidgetItem* current, QTreeWidgetItem* old)	切换园中元素的时候触发
itemClicked(QTreeWidgetItem* item, int col)	点击元素的时候触发
itemDoubleClicked(QTreeWidgetItem* item, int col)	双击元素的时候触发
itemEntered(QTreeWidgetItem* item, int col)	鼠标进入元素范围的时候触发
itemExpanded(QTreeWidgetItem* item)	元素被展开的时候触发
itemCollapsend(QTreeWidgetItem* item)	元素被折叠的时候触发

QTreeWidgetItem核心方法

方法	说明
addChild(QTreeWidgetItem* child)	新增子节点
childCount()	获取子节点个数
child(int index)	获取指定下标的子节点，返回QTreeWidgetItem对象指针
takeChild(int index)	删除指定下标的子节点
removeChild(QTreeWidgetItem* child)	删除对应的元素
parent()	获取该元素的父节点

细节

在添加顶层节点或者子节点传递QTreeWidgetItem对象的时候，在设置文本的时候，需要传递两个参数，第一个表示第n列，第二个参数是文本内容，因为QTreeWidgetItem对象可以有很多列，所以需要传递设置的文本是第几列。但是如果设置多列的话，那么我们对应的设置控件名称的时候就需要调用setHeaderLabels设置多个列名称了。这样的话才能显示出来我们设置的多列元素。
对于删除的时候来说，删除的时候需要调用他的父节点的删除函数，所以说要考虑删除元素的是不是顶层元素，因为顶层元素没有父元素，所以需要调用控件的删除函数去删除顶层元素，如果不是的话，调用父节点的删除函数即可。
如果删除的节点下面还有子节点的话，也会一起删除的。

控件使用案例

#include "widget.h"
#include "ui_widget.h"Widget::Widget(QWidget *parent): QWidget(parent), ui(new Ui::Widget)
{ui->setupUi(this);//设置根节点的名称ui->treeWidget->setHeaderLabel("食物");//添加顶层节点QTreeWidgetItem* item1 = new QTreeWidgetItem();item1->setText(0, "蔬菜");ui->treeWidget->addTopLevelItem(item1);QTreeWidgetItem* item2 = new QTreeWidgetItem();item2->setText(0, "水果");ui->treeWidget->addTopLevelItem(item2);
}Widget::~Widget()
{delete ui;
}//添加顶层元素
void Widget::on_pushButton_topItem_add_clicked()
{//获取输入框的文本内容const QString& str = ui->lineEdit->text();if(str.isEmpty())return;//设置到顶层节点QTreeWidgetItem* item = new QTreeWidgetItem();item->setText(0, str);ui->treeWidget->addTopLevelItem(item);
}//添加到选中元素
void Widget::on_pushButton_item_add_clicked()
{//获取输入框中的本文内容const QString& str = ui->lineEdit->text();if(str.isEmpty())return;//获取选中元素QTreeWidgetItem* item = ui->treeWidget->currentItem();if(item == nullptr)return;//添加节点QTreeWidgetItem* new_item = new QTreeWidgetItem();new_item->setText(0, str);item->addChild(new_item);//设置展开父节点item->setExpanded(true);
}//删除选中元素
void Widget::on_pushButton_item_del_clicked()
{//获取选中元素QTreeWidgetItem* item = ui->treeWidget->currentItem();if(item == nullptr)return;//获取父元素QTreeWidgetItem* parent = item->parent();//如果是顶层节点的话if(parent == nullptr){//获取下标int index = ui->treeWidget->indexOfTopLevelItem(item);//删除ui->treeWidget->takeTopLevelItem(index);}//非顶层节点else{parent->removeChild(item);}
}

1.多元素控件介绍

2.ListWidget控件

属性

核心方法

核心信号

细节

Demo：编辑日程

3.TableWidget控件

核心方法

QTableWidgetItem核心信号

QTableWidgetItem核心方法

细节

Demo：编辑学生信息

4.TreeWidget控件

核心方法

核心信号

QTreeWidgetItem核心方法

细节

控件使用案例

相关文章：