Qt5.9中使用列表控件QListWidget显示缩略图（完全模仿Windows图片视图文档）

本文链接：https://blog.youkuaiyun.com/naibozhuan3744/article/details/81070068

本文介绍了如何在Qt5.9的QListWidget中展示缩略图并实现图片底部居中、文字顶部居中的效果。关键函数包括addItem、setIcon、setTxt和setItemWidget，通过创建QWidget并在其中布局实现自定义显示。参考了两篇优快云博客以完成这一功能。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

本文主要用关键代码，介绍用Qt的QListWidget控件显示缩略图，实现图片底端居中对齐，文字顶端居中对齐。（提醒：可以直接跳过从后面的步骤1.1开始看起）

注意关键函数用法总结：

void QListWidget::addItem(QListWidgetItem *aitem)：QListWidget添加QListWidgetItem项。

QListWidgeItem::setIcon(QIcon)：设置QListWidgeItem项的图标。

QListWidgeItem::setTxt(QString)：设置QListWidgeItem项的内容，通常和setIcon()函数搭配使用，上面是图标下面是文字。

void setSizeHint(const QSize &size)：设置QListWidgeItem项的单元格大小。如果把每一个QListWidgeItem等同于与一个QPushbutton按钮，则该函数可以理解为设置QPushbutton按钮的尺寸大小，因为每一个QListWidgeItem项都可以跟按钮一样实现触发和鼠标滑过，被选中功能。

void itemClicked(QListWidgetItem *item)：单击QListWidgeItem项时触发一个信号。可以通过函数QListWidget::row(item)在获取当前选中的是哪一个QListWidgetItem 项。注意：加入有九宫格排列的QListWidgetItem，其在QListWidget中的排列顺序是从左到右，从上到下进行排序的。即：

0 1 2

3 4 5

6 7 8

void setItemWidget(QListWidgetItem *item, QWidget *widget)：将QListWidgetItem和QWidget关联起来，其中QWidget可以是一个QWidget，也可以是一个QPushbutton按钮。

列