嵌入式 QT QListWidget 显示列表视图的小部件类

不念不忘少年蓝@ 2024-03-17 10:33 8阅读 0赞

**目录**

1. 添加对象

2. 设置间距

3. 获取内容

4. 删除对象

5.更改对象内容

![ccc075798b6f4a33919eb22edeff424e.gif][]

在Qt框架中，QListWidget是一个用于显示列表视图的小部件类。它提供了一种方便的方式来显示和管理项目列表。QListWidget可以显示文本、图像和其他自定义的项目项，并允许用户进行选择和交互操作。

QListWidget可以用于创建类似于文件浏览器、播放列表、菜单等的功能。它可以以列表形式显示项目，并支持多种操作，如添加、删除、移动、选择和编辑项目。

以下是QListWidget的一些主要特性和用法：

> 1.  显示项目列表：QListWidget可以显示项目列表，每个项目可以包含文本、图像或其他自定义的小部件。
> 2.  选择操作：用户可以使用鼠标或键盘选择列表中的项目。可以设置选择模式，例如单选、多选或扩展选择。
> 3.  交互操作：QListWidget支持常见的交互操作，如双击、右击和拖放。你可以捕获这些交互事件，并根据需要执行相应的操作。
> 4.  编辑操作：QListWidget可以允许用户编辑项目的文本内容。编辑模式可以手动启用或自动启动，以便用户可以对项目进行编辑。
> 5.  信号与槽机制：QListWidget通过信号与槽机制提供了各种事件和操作的通知。你可以连接到这些信号，并根据需要执行自定义操作。

总之，QListWidget是一个灵活且易于使用的Qt小部件，用于在应用程序中显示和管理项目列表。它提供了丰富的功能和操作，可以满足各种列表显示和交互的需求。

QListWidget  是一个列表窗口 , 它可以存放客户自定义的元素。如；

![9ce7389f11e84cdf93a186f0263e5244.png][]

QListWidget  里的元素是  QListWidgetItem, 主要由图标和文字构成

例如：

![0dac947f60504248add963db1ddb1dea.png][]

QLabel *label = new QLabel;
     label->setFixedWidth(100);
     QListWidget *listWidget = new QListWidget;
     listWidget->addItem(new QListWidgetItem(QIcon(QObject::tr("images/china.png")),
    QObject::tr("China")));
     listWidget->addItem(new QListWidgetItem(QIcon(QObject::tr("images/hk.png")),
    QObject::tr("Hong Kong")));
     listWidget->addItem(new QListWidgetItem(QIcon(QObject::tr("images/macau.png")),
    QObject::tr("Macau")));
     
     QHBoxLayout *mainlayout = new QHBoxLayout;
     mainlayout->addWidget(listWidget);
     mainlayout->addWidget(label);
     QObject::connect(listWidget, SIGNAL(currentTextChanged(QString)), label,
    SLOT(setText(QString)));

其他的功能使用：

#### 1. 添加对象 ####

QString listString = ui->lEditUserName->text() + "\n"+ui->lEditChipID->text();
    QListWidgetItem *item = new QListWidgetItem(QIcon(":/images/images/user.png"),
    listString);
    
    ui-> listWidget->addItem(item);

#### 2. 设置间距 ####

ui->listWidget->setIconSize(QSize(50,50));

#### 3. 获取内容 ####

QString str = ui->listWidget->item(currentRow)->text(); //获取当前行的内容
     QStringList listStr = str.split('\n');
     currentUserName = listStr.at(0);
     currentChipID = listStr.at(1);
     ui->lEditUserName->setText(currentUserName);
     ui->lEditChipID->setText(currentChipID);

#### 4. 删除对象 ####

QListWidgetItem* item = ui->listWidget->takeItem(currentWidgetRow); //删除当前
    行
    delete item;
    ui->listWidget->update(); //更新显示

#### 5.更改对象内容 ####

if(ui->listWidget->currentItem()!=Q_NULLPTR){
     QString listString = newUserName + "\n"+currentChipID;
     ui->listWidget->currentItem()->setText(listString);
    }

完成！！！

[ccc075798b6f4a33919eb22edeff424e.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/7bc83ceaa95c4934870c0ce5a6a05cfb.png
[9ce7389f11e84cdf93a186f0263e5244.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/f51cfa5746494bd5aef02105da8b9b6a.png
[0dac947f60504248add963db1ddb1dea.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/9490a41958e24dfd92d02c5030c7a9b2.png