---

如何在 Qt 的 QListWidget 中逐行添加和显示数据

QListWidget 是 Qt 提供的一个非常方便的控件，用于显示和操作列表项。在开发过程中，您可能需要动态地向 QListWidget 中添加数据，并实时展示这些数据。本文将介绍如何在 QListWidget 中逐行添加数据并展示出来。

目标

• 在 QListWidget 中逐行添加数据。
• 展示添加的数据。
• 了解如何动态地向 QListWidget 插入和修改数据。

实现步骤

1. 在 Qt Designer 中添加 QListWidget

首先，确保在 Qt Designer 中已经在您的窗口中添加了一个 QListWidget 控件，并为其命名。例如，命名为 listWidget。这个控件将用于展示我们添加的列表项。

2. 在代码中逐行添加数据

在代码中，我们将使用 QListWidget 提供的 addItem() 和 insertItem() 方法来逐行添加数据。

示例代码

以下是在一个窗口类（例如 Widget）中添加数据的示例代码：

#include "widget.h"
#include "ui_widget.h"Widget::Widget(QWidget *parent) :QWidget(parent),ui(new Ui::Widget)
{ui->setupUi(this);// 逐行添加数据到 QListWidgetui->listWidget->addItem("Item 1");ui->listWidget->addItem("Item 2");ui->listWidget->addItem("Item 3");// 使用 insertItem 在特定位置插入数据ui->listWidget->insertItem(1, "Inserted Item"); // 插入到索引 1 的位置// 使用循环添加多个条目for (int i = 4; i <= 10; ++i) {ui->listWidget->addItem(QString("Item %1").arg(i));}
}Widget::~Widget()
{delete ui;
}

代码解析

1. addItem() 方法：用于向 QListWidget 中添加新条目。该方法会将指定的字符串作为新项添加到列表中，并立即显示。例如：

   ui->listWidget->addItem("Item 1");
   

   这行代码将字符串 “Item 1” 添加到 QListWidget 中。

2. insertItem() 方法：用于在指定索引处插入新条目。例如：

   ui->listWidget->insertItem(1, "Inserted Item");
   

   这行代码将字符串 “Inserted Item” 插入到列表中的索引 1 位置，其他项会相应地向后移动。

3. 使用循环添加数据：通过循环可以方便地向列表中添加多个项。这里使用了 QString::arg() 来生成带有编号的字符串：

   for (int i = 4; i <= 10; ++i) {ui->listWidget->addItem(QString("Item %1").arg(i));
   }
   

   这段代码会向 QListWidget 中添加从 “Item 4” 到 “Item 10” 的条目。

3. 使用自定义项

除了添加简单的文本项外，QListWidget 还允许您添加自定义的项，例如带有图标、不同字体或颜色的项。可以使用 QListWidgetItem 来实现更复杂的列表项：

QListWidgetItem *item = new QListWidgetItem("Custom Item");
item->setIcon(QIcon(":/path/to/icon.png")); // 设置图标
item->setForeground(Qt::blue); // 设置文本颜色
ui->listWidget->addItem(item);

运行效果

在运行程序时，QListWidget 中将显示我们添加的列表项。每次调用 addItem() 或 insertItem()，列表都会更新并显示新添加的项。

总结

在 Qt 中，QListWidget 提供了一个简单且灵活的方式来管理和显示列表项。通过 addItem() 和 insertItem() 方法，我们可以轻松地逐行添加数据并实时展示。QListWidgetItem 提供了更高级的功能，让您可以定制每个列表项的外观。

这种方法可以广泛应用于需要动态列表显示的场景，例如联系人列表、文件列表或其他需要交互的列表项。