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

目录

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控件

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

属性

核心方法

核心信号

细节

• 对于一个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对象构成。

核心方法

QTableWidgetItem核心信号

QTableWidgetItem核心方法

细节

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

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设置顶层节点，顶层节点可以是多个，然后再给顶层节点添加子节点，从而构成了树形结构。

核心方法

核心信号

QTreeWidgetItem核心方法

细节

• 在添加顶层节点或者子节点传递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);
    }
}