【QT入门】 QListWidget各种常见用法详解之列表模式

不吃~香菜

已于 2024-03-29 09:40:52 修改

阅读量5.2k

点赞数 38

分类专栏： QT入门文章标签： qt 开发语言 QListWidget QListWidgetItem

于 2024-03-28 15:07:34 首次发布

本文链接：https://blog.csdn.net/LF__plus/article/details/137105197

版权

QT入门专栏收录该内容

49 篇文章 22 订阅

订阅专栏

往期回顾

【QT入门】 Qt代码创建布局之setLayout使用-CSDN博客

【QT入门】 Qt代码创建布局之多重布局变换与布局删除技巧-CSDN博客

【QT入门】 QTabWidget各种常见用法详解-CSDN博客

【QT入门】 QListWidget各种常见用法详解之列表模式

QListWidget有列表和图标两种显示模式，默认是列表模式我们就先看列表模式。

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

一样的，学一个新的控件，首先要看他是怎么构造的，其次看怎么用，常用的方法，然后要去看他的信号函数，特别是熟悉常用方法和信号。而且ui界面创建和手动代码创建都要学会。

一、UI界面创建

ui界面创建List Widget是很简单的，找到List Widget拖动到窗口上即可。

在里面可以实现添加，删除选项的基本功能，还能对添加的每个Item进行样式设计，添加图片等，ui操作简单明了，还很容易实现。

二、手动代码创建

1、最终效果

2、QListWidgetItem

主要用到的就是 QListWidgetItem 这个类去创建QListWidget里面的选项，也就是Item

我先用ui搭建了整体框架

然后再用代码添加Item，用addItem()方法。

代码很简单，就没什么好说的，方法参数什么的，忘记了就点进去看。

值得一提的是，这里依旧是可以自定义Item对象，因为Item里面实际放的是Widget，所以我们可以创建Widget对象用ui界面设计了放进Item对象里去。最终效果里的头像、昵称、内容就是用的自定义Item对象，搭了一个大概框架，如果做精细化，其实就类似于微信里一个个好友聊天框。

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);

    QListWidgetItem *pListItem1 = new QListWidgetItem(QIcon(":/new/prefix2/res/editor.png"),"editor");
    QListWidgetItem *pListItem2 = new QListWidgetItem(QIcon(":/new/prefix2/res/env.png"),"env");
    QListWidgetItem *pListItem3 = new QListWidgetItem(QIcon(":/new/prefix2/res/help.png"),"help");
    QListWidgetItem *pListItem4 = new QListWidgetItem(QIcon(":/new/prefix2/res/kits.png"),"kits");
    QListWidgetItem *pListItem5 = new QListWidgetItem(QIcon(":/new/prefix2/res/vim.png"),"vim");
    QListWidgetItem *pListItem6 = new QListWidgetItem;

    ui->listWidget->addItem(pListItem1);
    ui->listWidget->addItem(pListItem2);
    ui->listWidget->addItem(pListItem3);
    ui->listWidget->addItem(pListItem4);
    ui->listWidget->addItem(pListItem5);
    ui->listWidget->addItem(pListItem6);

    CuserItem *cuseritem = new CuserItem(this);
    ui->listWidget->setItemWidget(pListItem6,cuseritem);

}

三、附加功能：右键单击菜单，item删除

这里主要是对列表模式的一个扩展，就是说当我们用列表模式能够在listWidget里显示item的时候，我们想要实现单击选项出现菜单，实现删除item等功能。

1、思路

1、先是创建item加入到listWidget里面去，

2、然后是执行初始化菜单函数，在初始化函数的实现里，创建action对象并对每个对象连接相应的槽函数

3、设置菜单策略，不设置无法显示菜单

4、最后是连接item对象和菜单，也就是右键单击item才出现相应的菜单

2、知识点分析

2.1、设置菜单策略

1、ui.listWidget->setContextMenuPolicy(Qt::CustomContextMenu);

将listWidget对象的上下文菜单策略设置为Qt::CustomContextMenu。这意味着可以为列表部件设置自定义上下文菜单。必须设置，不然无法显示菜单。

2.2、创建指针

2、QListWidgetItem* pItem = ui.listWidget->itemAt(pos);

这行代码创建了一个指向QListWidgetItem对象的指针pItem，该对象对应于listWidget中位置pos处的项目。

要知道这个itemAt方法，是Qt中用于检索给定坐标位置处的列表部件中的项目的方法

QListWidgetItem* QListWidget::itemAt(const QPoint& position) const;

如果给定的位置处有项目，则返回一个指向该项目的QListWidgetItem指针；如果该位置没有项目，则返回nullptr。这个方法通常用于处理鼠标事件，以确定用户单击或右键单击的是哪个项目。由于我们要是实现单击选择删除item，所以需要用到这个方法。

2.3、删除item

2.3.1动态删除

知道item的名字, 根据名字删除,这种可用于用户掉线，信息丢失等。

在listWidget中查找包含字符串"kits"的项目，然后将找到的第一个匹配项目移除并删除。

2.3.1.1代码示例

      QList<QListWidgetItem*> list;
      list = ui.listWidget->findItems("kits", Qt::MatchCaseSensitive);
      QListWidgetItem* sel = list[0];
      int r = ui.listWidget->row(sel);
      QListWidgetItem* item = ui.listWidget->takeItem(r); 
      ui.listWidget->removeItemWidget(item);
      delete item;

我们一一分析这段代码：

QList<QListWidgetItem*> list;	声明了一个QList类型的列表list，用于存储QListWidgetItem*指针。
list = ui.listWidget->findItems("kits", Qt::MatchCaseSensitive);	调用findItems函数在listWidget中查找内容为"kits"的项目，并以区分大小写的方式进行匹配。搜索结果存储在列表list中。
QListWidgetItem* sel = list[0];	从存储搜索结果的列表中获取第一个匹配项，并将其赋值给指针sel。
int r = ui.listWidget->row(sel);	获取项目sel在listWidget中的行索引，并将其存储在变量r中。
QListWidgetItem* item = ui.listWidget->takeItem(r);	从listWidget中移除第r行的项目，并将其返回给指针item。此时，该项目已经不再属于listWidget。
ui.listWidget->removeItemWidget(item);	移除与项目item关联的部件。这一步是为了确保在删除项目之前先移除其部件，以避免内存泄漏。
delete item;	删除项目item对象，释放其在内存中的空间。

2.3.2右键点击删除

QListWidgetItem* item = ui.listWidget-> currentItem();
ui.listWidget->removeItemWidget(item);
delete item;

这个就没什么好说的，很简单，推荐用这个，就是找到当前点击的item并移除。

3、完整实例代码

#include "QListWidget_02.h"
#include <QListWidgetItem>
#include <QAction>
#include <QMessageBox>

QListWidget_02::QListWidget_02(QWidget *parent)
    : QWidget(parent)
{
    ui.setupUi(this);
    
    QListWidgetItem* pListItem1 = new QListWidgetItem(QIcon(":/QListWidget_02/res/editor.png"), "editor");
    QListWidgetItem* pListItem2 = new QListWidgetItem(QIcon(":/QListWidget_02/res/env.png"), "env");
    QListWidgetItem* pListItem3 = new QListWidgetItem(QIcon(":/QListWidget_02/res/help.png"), "help");
    QListWidgetItem* pListItem4 = new QListWidgetItem(QIcon(":/QListWidget_02/res/kits.png"), "kits");
    QListWidgetItem* pListItem5 = new QListWidgetItem(QIcon(":/QListWidget_02/res/vim.png"), "vim");

    ui.listWidget->addItem(pListItem1);
    ui.listWidget->addItem(pListItem2);
    ui.listWidget->addItem(pListItem3);
    ui.listWidget->addItem(pListItem4);
    ui.listWidget->addItem(pListItem5);

    initRight();

    //设置菜单策略，必须设置，不然无法显示菜单
    ui.listWidget->setContextMenuPolicy(Qt::CustomContextMenu);

    //连接信号槽
    connect(ui.listWidget, &QListWidget::customContextMenuRequested, 
        this, &QListWidget_02::onPopupRightMenu);

}

QListWidget_02::~QListWidget_02()
{}

void QListWidget_02::onPopupRightMenu(const QPoint& pos)
{
    QListWidgetItem* pItem = ui.listWidget->itemAt(pos);

    if (!pItem)
    {
        return;
    }

    m_pRightMenu->exec(QCursor::pos());
}

void QListWidget_02::initRight()
{
    m_pRightMenu = new QMenu(this);

    QAction* qAce1 = new QAction(u8"动作一", this);
    QAction* qAce2 = new QAction(u8"动作二", this);
    QAction* qAce3 = new QAction(u8"动作三", this);
    QAction* qAce4 = new QAction(u8"删除", this);

    m_pRightMenu->addAction(qAce1);
    m_pRightMenu->addAction(qAce2);
    m_pRightMenu->addAction(qAce3);
    m_pRightMenu->addAction(qAce4);

    connect(qAce1, &QAction::triggered, [=] {
        QMessageBox::information(this, "title", "qAce1");
        });

    connect(qAce4, &QAction::triggered, [=] {
    //方式1:知道item的名字, 根据名字删除,这种可用于用户掉线，信息丢失等，动态删除
      //  QList<QListWidgetItem*> list;
      //list = ui.listWidget->findItems("kits", Qt::MatchCaseSensitive);
      //QListWidgetItem* sel = list[0];
      //int r = ui.listWidget->row(sel);
      //QListWidgetItem* item = ui.listWidget->takeItem(r); ui.listWidget->removeItemWidget(item);
      //delete item; 


    //方式2:
    //    右键点击删除，或者选中删除
            QListWidgetItem* item = ui.listWidget-> currentItem();
        ui.listWidget->removeItemWidget(item);
        delete item;

        });
}

都看到这里了，点个赞再走呗朋友~

加油吧，预祝大家变得更强！