QListWidget和QListWidgetItem的简单使用

最新推荐文章于 2026-05-26 15:54:43 发布

原创最新推荐文章于 2026-05-26 15:54:43 发布 · 7.2w 阅读

63 ·

本内容遵循CC 4.0 BY-SA版权协议

收录于

本文通过三个示例介绍QListWidget的基本用法：创建仅包含文本的列表项、带有图标的列表项，以及如何响应列表项的选择变化。

开发板推荐：天空星STM32F407VET6开发板

超高性价比 STM32主控 | 超高主频 | 一板兼容百芯 | 比赛神器 | 沉金彩色丝印

点击查看

QListWidget可以显示一个清单，清单中的每个项目是QListWidgetItem的一个实例，每个项目可以通过QListWidgetItem来操作。可以通过QListWidgetItem来设置每个项目的图像与文字。下面说明3个例子，一个例子只显示文字，一个例子显示文字和图标，最后一个例子增加每个项的选择的信号。

例子1：

#include <QApplication> #include <QWidget> #include <QVBoxLayout> #include <QListWidget> #include <QListWidgetItem> int main(int argc, char** argv) { QApplication app(argc, argv); QWidget* widget = new QWidget; QListWidget* listWidget = new QListWidget; QVBoxLayout* layout = new QVBoxLayout; QListWidgetItem* lst1 = new QListWidgetItem("data", listWidget); QListWidgetItem* lst2 = new QListWidgetItem("decision", listWidget); QListWidgetItem* lst3 = new QListWidgetItem("document", listWidget); QListWidgetItem* lst4 = new QListWidgetItem("process", listWidget); QListWidgetItem* lst5 = new QListWidgetItem("printer", listWidget); listWidget->insertItem(1, lst1); listWidget->insertItem(2, lst2); listWidget->insertItem(3, lst3); listWidget->insertItem(4, lst4); listWidget->insertItem(5, lst5); listWidget->show(); layout->addWidget(listWidget); widget->setLayout(layout); widget->show(); app.exec(); }

运行如下图：

第2个例子：

#include <QApplication> #include <QWidget> #include <QVBoxLayout> #include <QListWidget> #include <QListWidgetItem> int main(int argc, char** argv) { QApplication app(argc, argv); QWidget* widget = new QWidget; QListWidget* listWidget = new QListWidget; QVBoxLayout* layout = new QVBoxLayout; QListWidgetItem* lst1 = new QListWidgetItem(QIcon("images/data.png"), "data", listWidget); QListWidgetItem* lst2 = new QListWidgetItem(QIcon("images/decision.png"), "decision", listWidget); QListWidgetItem* lst3 = new QListWidgetItem(QIcon("images/document.png"), "document", listWidget); QListWidgetItem* lst4 = new QListWidgetItem(QIcon("images/process.png"), "process", listWidget); QListWidgetItem* lst5 = new QListWidgetItem(QIcon("images/printer.png"), "printer", listWidget); listWidget->insertItem(1, lst1); listWidget->insertItem(2, lst2); listWidget->insertItem(3, lst3); listWidget->insertItem(4, lst4); listWidget->insertItem(5, lst5); listWidget->show(); layout->addWidget(listWidget); widget->setLayout(layout); widget->show(); app.exec(); }

运行如下图：

第3个例子：

#include <QApplication> #include <QWidget> #include <QHBoxLayout> #include <QListWidget> #include <QListWidgetItem> #include <QLabel> int main(int argc, char** argv) { QApplication app(argc, argv); QWidget* widget = new QWidget; QListWidget* listWidget = new QListWidget; QHBoxLayout* layout = new QHBoxLayout; QLabel* label = new QLabel; label->setFixedWidth(100); QListWidgetItem* lst1 = new QListWidgetItem(QIcon("images/data.png"), "data", listWidget); QListWidgetItem* lst2 = new QListWidgetItem(QIcon("images/decision.png"), "decision", listWidget); QListWidgetItem* lst3 = new QListWidgetItem(QIcon("images/document.png"), "document", listWidget); QListWidgetItem* lst4 = new QListWidgetItem(QIcon("images/process.png"), "process", listWidget); QListWidgetItem* lst5 = new QListWidgetItem(QIcon("images/printer.png"), "printer", listWidget); listWidget->insertItem(1, lst1); listWidget->insertItem(2, lst2); listWidget->insertItem(3, lst3); listWidget->insertItem(4, lst4); listWidget->insertItem(5, lst5); QObject::connect(listWidget, SIGNAL(currentTextChanged(const QString &)), label, SLOT(setText(const QString &))); listWidget->show(); layout->addWidget(listWidget); layout->addWidget(label); widget->setLayout(layout); widget->show(); app.exec(); }

运行如下图：