09-Qt QListWidget列表框用法详解

本人微信公众号：程序员架构笔记

欢迎大家关注。

很多应用程序中需要以列表的形式向用户展示数据（资源），比如 Windows 操作系统会以列表的方式展示很多张桌面背景图（如图 1a) 所示），再比如很多音乐播放器中以列表的形式展示音乐资源，用户可以选择自己喜欢的音乐（如图 1b) 所示）。
 

图 1 常见的列表窗口

使用 Qt 框架开发 GUI 程序，如果需要以列表的方法展示数据，可以优先考虑用 QListWidget 类实现。

QListWidget列表框的创建

QListWidget 是 Qt 提供的控件类，专门用来创建列表。QListWidget 类的继承关系如下：

QListWidget -> QListView -> QAbstractItemView -> QAbstractScrollArea -> QFrame -> QWidget

这里着重介绍一下 QListView 类，它也可以用来创建列表。对于初学者来说，我强烈建议先学习 QListWidget，它是“简易版”的 QListView，创建和使用列表的方式更简单、门槛更低，对初学者更友好。当然，QListWidget 只能创建结构简单的列表，如果要制作复杂的列表，应优先考虑 QListView，因为它的功能更强大，很多 QListWidget 难以实现的功能，QListView 都能实现。

通过实例化 QListWidget 类，可以很轻松地创建一个列表。QListWidget 类只提供了 1 个构造函数：

QListWidget(QWidget *parent = Q_NULLPTR)

parent 参数用来指定新建列表的父窗口，该参数的默认值是 Q_NULLPTR，表示新建控件没有父窗口。

语法层面上分析，可以不为 QListWidget 列表指定父窗口，那么它将作为一个独立的窗口。但实际开发中，通常会为 QListWidget 列表指定一个父窗口（例如 QWidget 窗口），它将作为父窗口中的一个子控件，和窗口中的其它控件一起搭配使用。

QListWidgetItem列表项

QListWidget 列表控件可以显示多份数据，每份数据习惯称为列表项（简称项），每个列表项都是 QListWidgetItem 类的实例对象。也就是说，QListWidget 中有多少个列表项，就有多少个 QListWidgetItem 类对象。

默认情况下，QListWidget 中每个列表项独自占用一行，每个列表项中可以包含文字、图标等内容。实际开发中，我们还可以将指定的窗口或者控件放置到列表项中显示，例如 QWidget 窗口、QLabel 文本框、QPushButton 按钮、QLineEdit 输入框等。

借助 QListWidgetItem 类，可以轻松管理 QListWidget 中的每个列表项，包括：

• 借助 QListWidgetItemo 类提供的 set