Qt/C++ 如何删除QListWidget的指定项

1. 简介

QListWidget是Qt中，用于展示列表类型数据的常用控件。它提供了一个类似于QListView的列表视图，但是具有用于添加和删除项的接口。QListWidget使用一个内部模型来管理列表中的每个QListWidgetItem。

删除匹配指定字符串的项并没有想象中地那么直接，所以这里才有了这篇笔记，让有需要的同学能够快速的实现这个需求。

2. 方法

要删除QListWidget中特定字符串的QListWidgetItem，简单而言，就是使用findItems函数查找匹配项，然后使用takeItem函数从列表中删除该项。

QList<QListWidgetItem *> QListWidget::findItems(const QString &text, Qt::MatchFlags flags) const

该函数使用给定标志查找具有与字符串匹配的文本的项。

QListWidgetItem *QListWidget::takeItem(int row)

该函数从QListWidget的给定行中删除并返回该项；否则返回nullptr。需要注意的是，从QListWidget中删除的项将不会被Qt管理，需要手动删除。

另外，这个函数的参数形参是需要删除的项所在的行号，因此，我们并不能直接使用findItems返回的结果。还需要使用row函数获取项所在的行：

int QListWidget::row(const QListWidgetItem *item) const

该函数返回包含给定项的行。

综上，以下是一个示例代码：

QListWidget *listWidget = new QListWidget();
// 假设现在列表中有一些项
// ...

// 要删除的字符串
QString itemText = "item to remove";

// 查找匹配项
QList<QListWidgetItem*> items = listWidget->findItems(itemText, Qt::MatchExactly);

// 逐个删除匹配项
for (QListWidgetItem* item : items) {
    listWidget->takeItem(listWidget->row(item));
    delete item;
}

在上述代码中，我们首先使用findItems函数查找匹配itemText的QListWidgetItem。然后，我们使用row将item转换为row id，并使用takeItem函数从列表中删除项，最后释放QListWidgetItem的内存。

3. Reference

1. QListWidget Class