【Qt】多元素控件QListWidget

 多元素控件QListWidget

使用List Widget表示一个纵向的列表，其每一个选项都可以被选中。

• 核心属性

• 核心方法

列表中的每一个元素/每一项都被称为是一个item，更具体地来讲，是通过QListWidgetitem类表示的。

在进行插入的row参数就表示插入完毕之后新元素在第row行，把新元素插入到第几行之前。

用来表示“删除”的术语：
take、erase、remove、delete、take

• 核心信号

QListWidget类

这个类表示QListWidget中的一个元素，本质上就是“文本+图标”构成的。

核心方法如下：

例子：使用List Widget新增与删除元素

（1）使用Qt Designer创建出一个List Widget、俩个按钮、一个lineEdit

（2）添加ListWidget的初始元素

方法一：直接使用字符串添加

• 这种方式简单直接，适用于只需要添加简单文本的情况。
• 系统会自动为添加的字符串创建一个默认的 QListWidgetItem 对象。

方法二：使用QListWidgetItem 添加对象

• 提供了更多的灵活性，可以对创建的 QListWidgetItem 进行更多的自定义设置
• 例如，可以设置图标、字体、前景色和背景色等属性，或者设置数据与项目相关联。

方法三：

在图形化界面中，右键QListWidget选择编辑项目，就可以直接添加内容了。

如果这里初始的内容是固定的，此时使用哪种方式都是可行的。

但是如果这里的内容是不固定的，需要读取文件/读取网络来构造数据。

此时就需要代码的方式来添加。

（3）点击添加按钮新增元素

（4）点击删除按钮删除元素

（5）代码实现

#include "widget.h"
#include "ui_widget.h"

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);

    // 添加初始元素
    ui->listWidget->addItem("C++");
    ui->listWidget->addItem("Python");
    ui->listWidget->addItem("Java");

//    //使用QlistWidget 添加初始元素
//    ui->listWidget->addItem(new QListWidgetItem("C++"));
//    ui->listWidget->addItem(new QListWidgetItem("Python"));
//    ui->listWidget->addItem(new QListWidgetItem("Java"));

}

Widget::~Widget()
{
    delete ui;
}


void Widget::on_pushButton_add_clicked()
{
    // 获取输入框里的内容
    const QString& text = ui->lineEdit->text();
    // 添加到 QListItem 中
    ui->listWidget->addItem(text);
}

void Widget::on_pushButton_sub_clicked()
{
    // 获取QListItem 的行数
    int row = ui->listWidget->currentRow();
    // 按照行数删除元素
    if(row < 0) return;
    ui->listWidget->takeItem(row);
}