往期回顾
【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;});
}
都看到这里了,点个赞再走呗朋友~
加油吧,预祝大家变得更强!