【Qt控件之QListWidget】介绍及使用，利用QListWidget、QToolButton、和布局控件实现抽屉式组合控件

概述

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

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

      QListWidget *listWidget = new QListWidget(this);
1

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

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

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

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

对于多个项目，可以使用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 
#include 
#include 
#include 


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_OBJECT

public:
    explicit MainWindow(QWidget *parent = nullptr);
    ~MainWindow();

private:
    Ui::MainWindow *ui;
};

#endif // MAINWINDOW_H
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

.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;
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

main.cpp

#include "mainwindow.h"
#include 

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    MainWindow w;
    w.show();

    return a.exec();
}

1
2
3
4
5
6
7
8
9
10
11
12

效果

实现思路

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