概述

QListWidget类提供了基于项目的列表小部件。

QListWidget是一个方便的类，类似于QListView提供的列表视图，但使用经典的基于项目的接口来添加和删除项目。QListWidget使用内部模型来管理列表中的每个QListWidgetItem。
对于更灵活的列表视图小部件，请使用具有标准模型的QListView类。
列表小部件的构造方式与其他小部件相同：

      QListWidget *listWidget = new QListWidget(this);

列表小部件的selectionMode()确定列表中可以同时选择多少个项目，以及是否可以创建复杂的项目选择。可以使用setSelectionMode()函数进行设置。
有两种方法可以将项目添加到列表中：可以将它们构造为具有列表小部件作为父小部件，也可以构造为没有父小部件，稍后将其添加到列表中。如果在构造项目时已经存在列表小部件，则使用第一种方法更容易：

      new QListWidgetItem(tr("Oak"), listWidget);new QListWidgetItem(tr("Fir"), listWidget);new QListWidgetItem(tr("Pine"), listWidget);

如果需要在特定位置将新项目插入列表中，则应该构造该项目时不带父小部件。然后应使用insertItem()函数将其放置在列表中。列表小部件将拥有该项目。

      QListWidgetItem *newItem = new QListWidgetItem;newItem->setText(itemText);listWidget->insertItem(row, newItem);

对于多个项目，可以使用insertItems()。可以使用count()函数获取列表中的项目数。要从列表中删除项目，请使用takeItem()。
可以使用currentItem()找到列表中的当前项目，并使用setCurrentItem()来更改当前项目。用户还可以通过键盘导航或单击不同的项目来更改当前项目。当前项目更改时，会发出currentItemChanged()信号，其中包含新的当前项目和先前的项目。

常用函数

QListWidget的构造函数:

• QListWidget(QWidget *parent = nullptr)：构造一个QListWidget对象，父对象为parent。

枚举类型:

• QListWidget::SelectionMode：用于指定列表项的选择模式，包括NoSelection、SingleSelection、MultiSelection、ExtendedSelection、ContiguousSelection。

常用函数包括但不限于:

• void addItem(const QIcon &icon, const QString &text)：向列表中添加一个带有图标和文本的项。
• void addItem(const QString &text)：向列表中添加一个只有文本的项。
• void addItems(const QStringList &labels)：向列表中一个字符串列表。
• void insertItem(int row, const QString &label)：在指定位置插入一个只有文本的项。
• int count() const：返回列表中的项数。
• int currentRow() const：返回当前选中项的索引。
• QListWidgetItem *item(int row) const：返回指定位置的列表项。
• QStringList selectedItems() const：返回当前选中的项的文本列表。
• void clear()：清除列表中的所有项。
• void setSelectionMode(QListWidget::SelectionMode mode)：设置选择模式。
• void setIconSize(const QSize &size)：设置图标的大小。
• void setCurrentRow(int row)：设置当前选中项的索引。
• void sortItems(Qt::SortOrder order = Qt::AscendingOrder)：按字母顺序对列表项进行排序。

信号和槽:

• void itemClicked(QListWidgetItem *item)：当点击一个项时发出的信号。可以使用 connect 函数将这个信号连接到自定义的槽函数上。
• void itemDoubleClicked(QListWidgetItem *item)：当双击一个项时发出的信号。
• void itemSelectionChanged()：当选中项发生改变时发出的信号。

以上只是QListWidget常用的函数和信号/槽，还有其他可用的函数和信号/槽可以根据需要查阅帮助文档。

示例

.h

#ifndef MAINWINDOW_H
#define MAINWINDOW_H#include <QMainWindow>
#include <QToolButton>
#include <QVBoxLayout>
#include <QListWidget>class DrawerWidget : public QWidget {Q_OBJECT
public:DrawerWidget(QWidget *parent = nullptr) : QWidget(parent) {listWidget = new QListWidget(this);listWidget->addItems(QStringList() << "1" << "2" << "3");toolButton = new QToolButton(this);toolButton->setArrowType(Qt::RightArrow);QVBoxLayout *layout = new QVBoxLayout(this);layout->addWidget(toolButton);layout->addWidget(listWidget);connect(toolButton, &QToolButton::clicked, this, &DrawerWidget::toggleDrawer);drawerOpened = true;}private slots:void toggleDrawer() {if (drawerOpened) {listWidget->hide();toolButton->setArrowType(Qt::DownArrow);} else {listWidget->show();toolButton->setArrowType(Qt::RightArrow);}drawerOpened = !drawerOpened;}private:QListWidget *listWidget;QToolButton *toolButton;bool drawerOpened;
};namespace Ui {
class MainWindow;
}class MainWindow : public QMainWindow
{Q_OBJECTpublic:explicit MainWindow(QWidget *parent = nullptr);~MainWindow();private:Ui::MainWindow *ui;
};#endif // MAINWINDOW_H

.cpp

#include "mainwindow.h"
#include "ui_mainwindow.h"MainWindow::MainWindow(QWidget *parent) :QMainWindow(parent),ui(new Ui::MainWindow)
{ui->setupUi(this);QWidget* pW = new QWidget(this);QVBoxLayout* pVB = new QVBoxLayout(pW);pVB->addWidget(new DrawerWidget(this));pVB->addWidget(new DrawerWidget(this));pVB->addWidget(new DrawerWidget(this));pVB->addStretch();setCentralWidget(pW);
}MainWindow::~MainWindow()
{delete ui;
}

main.cpp

#include "mainwindow.h"
#include <QApplication>int main(int argc, char *argv[])
{QApplication a(argc, argv);MainWindow w;w.show();return a.exec();
}

效果

实现思路

• 首先，创建自定义组合控件
  – 利用QToolButton和QListWidget实现抽屉式控件
• 将自定义组合控件添加到主窗口
• 显示