目录
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);
}
}
