QListWidget 是 Qt 提供的一个用于显示和管理列表项的控件。它是 QListView 的子类，并且集成了 QListView 和 QStandardItemModel 的功能，使得使用起来更加方便。以下是 QListWidget 开发的详细介绍，包括基本使用方法、添加和删除项、响应用户交互等。

一、QListWidget基本使用

1.1 创建 QListWidget

QListWidget *listWidget = new QListWidget(this);

1.2 QListWidget添加项

有多种方式可以向 QListWidget 添加项：

• 添加单个项：

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

• 添加多个项：

QStringList items;
items << "Item 3" << "Item 4" << "Item 5";
listWidget->addItems(items);

• 使用 QListWidgetItem 添加项：

QListWidgetItem *item = new QListWidgetItem("Item 6");
listWidget->addItem(item);

1.3 QListWidget删除项

• 删除单个项：

delete listWidget->takeItem(listWidget->row(item)); // 删除指定项

• 删除当前选中的项：

delete listWidget->takeItem(listWidget->currentRow());

1.4 QListWidget获取和设置项

• 获取当前选中的项：

QListWidgetItem *currentItem = listWidget->currentItem();
if (currentItem) {qDebug() << "Current item:" << currentItem->text();
}

• 设置项的文本：

QListWidgetItem *item = listWidget->item(0); // 获取第一个项
if (item) {item->setText("New Text");
}

二、QListWidget响应用户交互

2.1 QListWidget的单击响应

在 QListWidget 中实现单击响应，可以使用 itemClicked 信号。这个信号会在用户单击列表项时发射，并传递被单击的 QListWidgetItem 对象。通过连接该信号到槽函数，就可以在单击时执行相应的操作。

下面是一个示例，展示如何在 QListWidget 中实现单击响应，并显示被单击的项的文本：

#include <QListWidget>
#include <QVBoxLayout>
#include <QMessageBox>
#include <QWidget>
#include <QApplication>class MainWindow : public QWidget
{Q_OBJECTpublic:MainWindow(QWidget *parent = nullptr) : QWidget(parent){// 创建 QListWidget 并添加一些项QListWidget *listWidget = new QListWidget(this);listWidget->addItem("Item 1");listWidget->addItem("Item 2");listWidget->addItem("Item 3");// 将 itemClicked 信号连接到自定义槽函数connect(listWidget, &QListWidget::itemClicked, this, &MainWindow::onItemClicked);// 布局设置QVBoxLayout *layout = new QVBoxLayout(this);layout->addWidget(listWidget);setLayout(layout);}private slots:// 自定义槽函数，处理单击事件void onItemClicked(QListWidgetItem *item){QMessageBox::information(this, "Item Clicked", "You clicked: " + item->text());}
};int main(int argc, char *argv[])
{QApplication app(argc, argv);MainWindow window;window.show();return app.exec();
}#include "main.moc"

• 详细说明

1. 创建 QListWidget 并添加项：

   QListWidget *listWidget = new QListWidget(this);
   listWidget->addItem("Item 1");
   listWidget->addItem("Item 2");
   listWidget->addItem("Item 3");
   

2. 连接 itemClicked 信号到槽函数：

   connect(listWidget, &QListWidget::itemClicked, this, &MainWindow::onItemClicked);
   

3. 定义槽函数：

   void onItemClicked(QListWidgetItem *item)
   {QMessageBox::information(this, "Item Clicked", "You clicked: " + item->text());
   }
   

4. 显示窗口：

   int main(int argc, char *argv[])
   {QApplication app(argc, argv);MainWindow window;window.show();return app.exec();
   }
   

2.3 QListWidget的 currentItemChanged

2.3 QListWidget的右键餐单

要在 QListWidget 上实现右键菜单操作，可以通过以下步骤完成：

1. 创建右键菜单： 在需要右键菜单的地方创建一个 QMenu 对象，并添加菜单项。
2. 连接信号与槽： 将 QListWidget 的 customContextMenuRequested 信号连接到一个槽函数，该函数在用户请求自定义上下文菜单时触发。
3. 显示菜单： 在槽函数中根据需要显示右键菜单。

下面是一个简单的示例，演示如何实现这些步骤：

#include <QtWidgets>class MyListWidget : public QListWidget {
public:MyListWidget(QWidget *parent = nullptr) : QListWidget(parent) {// 添加一些项作为示例addItem("Item 1");addItem("Item 2");addItem("Item 3");// 连接右键菜单请求信号connect(this, &QListWidget::customContextMenuRequested, this, &MyListWidget::showContextMenu);}private:void showContextMenu(const QPoint &pos) {QMenu contextMenu(tr("Context menu"), this);QAction *action1 = new QAction("Action 1", this);connect(action1, &QAction::triggered, this, &MyListWidget::action1Clicked);contextMenu.addAction(action1);QAction *action2 = new QAction("Action 2", this);connect(action2, &QAction::triggered, this, &MyListWidget::action2Clicked);contextMenu.addAction(action2);contextMenu.exec(mapToGlobal(pos));}void action1Clicked() {qDebug() << "Action 1 clicked!";}void action2Clicked() {qDebug() << "Action 2 clicked!";}
};int main(int argc, char *argv[]) {QApplication app(argc, argv);MyListWidget listWidget;listWidget.show();return app.exec();
}

在这个示例中，我们创建了一个自定义的 MyListWidget 类，继承自 QListWidget。在构造函数中，我们添加了几个项作为示例，并连接了 customContextMenuRequested 信号到 showContextMenu 槽函数。在 showContextMenu 函数中，我们创建了一个 QMenu 对象，并添加了两个动作 Action 1 和 Action 2，并分别连接到 action1Clicked 和 action2Clicked 槽函数。

当用户在 QListWidget 上右键单击时，会触发 customContextMenuRequested 信号，从而显示我们创建的右键菜单。

三、QListWidget和QTableWidget区别

QListWidget 和 QTableWidget 是 Qt 中用于显示和管理数据的两种不同类型的控件。它们的主要区别在于数据的组织和显示方式。

3.1 QListWidget

QListWidget 是一个单列的列表控件，适用于显示简单的列表数据。每个列表项是一个 QListWidgetItem 对象，可以包含文本、图标等。以下是 QListWidget 的一些特点：

1. 单列显示：QListWidget 只能显示一列数据，每个项是一个独立的对象。
2. 简单数据展示：适用于展示简单的、独立的列表项，例如任务列表、联系人列表等。
3. 操作简便：提供了方便的接口用于添加、删除、修改和获取列表项。

• 使用示例：

#include <QListWidget>
#include <QVBoxLayout>
#include <QWidget>QListWidget *listWidget = new QListWidget(this);
listWidget->addItem("Item 1");
listWidget->addItem("Item 2");
listWidget->addItem("Item 3");QVBoxLayout *layout = new QVBoxLayout(this);
layout->addWidget(listWidget);
setLayout(layout);

3.2 QTableWidget

QTableWidget 是一个表格控件，适用于显示多行多列的数据。每个单元格是一个 QTableWidgetItem 对象，可以包含文本、图标等。以下是 QTableWidget 的一些特点：

1. 多行多列显示：QTableWidget 可以显示多行多列的数据，类似于电子表格。
2. 复杂数据展示：适用于展示结构化的、多维度的数据，例如财务报表、商品清单等。
3. 灵活操作：提供了丰富的接口用于添加、删除、修改和获取单元格数据，还可以设置单元格的样式和属性。

• 使用示例：

#include <QTableWidget>
#include <QVBoxLayout>
#include <QWidget>QTableWidget *tableWidget = new QTableWidget(3, 2, this);
tableWidget->setHorizontalHeaderLabels(QStringList() << "Column 1" << "Column 2");tableWidget->setItem(0, 0, new QTableWidgetItem("Item 1-1"));
tableWidget->setItem(0, 1, new QTableWidgetItem("Item 1-2"));
tableWidget->setItem(1, 0, new QTableWidgetItem("Item 2-1"));
tableWidget->setItem(1, 1, new QTableWidgetItem("Item 2-2"));QVBoxLayout *layout = new QVBoxLayout(this);
layout->addWidget(tableWidget);
setLayout(layout);

3.3 对比总结

• 数据组织方式：

  • QListWidget：单列数据，每个项是独立的。
  • QTableWidget：多行多列数据，每个单元格都是独立的，可以有行和列的交互。

• 适用场景：

  • QListWidget：适用于简单的列表数据，例如文件列表、任务列表。
  • QTableWidget：适用于复杂的表格数据，例如财务报表、学生成绩表。

• 操作复杂度：

  • QListWidget：操作简单，接口直接，适合快速开发和简单数据展示。
  • QTableWidget：操作相对复杂，提供了更丰富的接口和更大的灵活性。

选择 QListWidget 还是 QTableWidget 主要取决于数据的结构和展示需求。如果需要展示简单的列表数据，可以选择 QListWidget；如果需要展示复杂的表格数据，可以选择 QTableWidget。

其他QT文章
1. QT开发环境安装以配置。
2. QT线段画板实战
3. 半小时玩转QT桌面系统托盘(含托盘消息)
4. QT入门开发一个时钟
5. 半小时教你做大转盘游戏（QT篇）
6. 手把手教你制作【带吸附效果的线段绘制】（QT）
7. 手把手教你开发-滚动效果号码抽奖（QT）
8. 100行代码实现贪吃蛇小游戏
9.C++实现《扫雷》游戏（入门经典）
10. svg转图片工具开发
11. Qt网路与通信(获取本机网络信息）
12. Qt网路与通信(UDP客户与服务）
13. Qt网络与通信（TCP聊天室）
14. Qt多线程以及线程池
15. Qt散点图、折线图、柱状图、盒须图、饼状图、雷达图开发实例
16. 取色器（QT）
17. MQTT客户端入门开发
18.QT文件上传带进度条实例（含源码）
19. Qt音乐播放器开发实例（可毕设含源码）
20. Qt学生管理系统-- 数据库课程设计（付源码）