Qt开发-QListWidget控件

一、介绍

  QListWidget 是Qt中用于显示可选项列表的控件。

        QListWidget 支持两种显示模式：列表模式（List Mode）和图标模式（Icon Mode）。

enum ViewMode
{
    ListMode, // 列表模式
    IconMode  // 图标模式
};

列表模式（List Mode）       

        在列表模式下，项目以纵向列表的形式显示，每个项目占据一行。这是 QListWidget 的默认模式。就像：

        可以使用以下方法设置列表模式：       

listWidget->setViewMode(QListView::ListMode);

 图标模式（Icon Mode）

        在图标模式下，项目以图标和文本的形式水平排列。就像：

        可以使用以下方法设置图标模式：

listWidget->setViewMode(QListView::IconMode);

二、实现

        1. 列表模式简单用法

        添加项目： 使用 addItem 方法可以向列表中添加新项目。

QListWidget *listWidget = new QListWidget(this);
QListWidgetItem *item = new QListWidgetItem("Item 1");
listWidget->addItem(item);

        移除项目： 使用 takeItem 方法可以从列表中移除项目。

QListWidgetItem *item = listWidget->takeItem(row);
delete item; // 释放内存

        图标和文本

QListWidgetItem* pItem = new QListWidgetItem(QIcon("填入路径"), "文本");
listWidget->addItem(pItem);

可以结合其他控件和信号与槽做功能扩展。

    2. 图标模式

        允许您以图标的形式水平排列项目。以下是一些设置和用法示例：

#include <QListWidget>
#include <QListWidgetItem>
#include <QIcon>

// 创建一个QListWidget
QListWidget *listWidget = new QListWidget(this);

// 设置视图模式为图标模式
listWidget->setViewMode(QListView::IconMode);

// 设置图标的大小
listWidget->setIconSize(QSize(64, 64));

// 创建图标项并添加到列表
QListWidgetItem *item1 = new QListWidgetItem(QIcon(":/images/icon1.png"), "Item 1");
QListWidgetItem *item2 = new QListWidgetItem(QIcon(":/images/icon2.png"), "Item 2");
QListWidgetItem *item3 = new QListWidgetItem(QIcon(":/images/icon3.png"), "Item 3");

listWidget->addItem(item1);
listWidget->addItem(item2);
listWidget->addItem(item3);

// 设置图标的调整方式以适应窗口大小变化
listWidget->setResizeMode(QListView::Adjust);

// 设置图标的排列方式
listWidget->setFlow(QListView::LeftToRight);

// 其他可能的设置
// listWidget->setGridSize(QSize(80, 80));  // 设置图标的网格大小
// listWidget->setWrapping(true);  // 允许图标换行

// 将列表添加到布局或窗口中
layout->addWidget(listWidget);

        上述示例中，QListWidget 中的每个项都有一个图标和相应的文本。setIconSize 方法用于设置图标的大小，setFlow 方法用于设置图标的排列方向，setResizeMode 方法用于设置图标的调整方式。