列表控件QListWidget

显示模式

有两种显示模式，列表模式和图标模式

// 获取和设置显示模式
QListView::ViewMode viewMode() const
void setViewMode(QListView::ViewMode mode)

QListView::ViewMode有两个取值

• QListView::ListMode   列表模式

• QListView::IconMode 图标模式 

交替背景色

设置相邻行交替显示不同的背景色，便于显示和浏览时定位

// 获取和设置交替显示(win11该接口失效)
bool alternatingRowColors() const
void setAlternatingRowColors(bool enable)

添加条目

// 在尾部添加
void addItem(const QString &label)
void addItem(QListWidgetItem *item)
void addItems(const QStringList &labels)// 在指定行之前添加
void insertItem(int row, QListWidgetItem *item)
void insertItem(int row, const QString &label)
void insertItems(int row, const QStringList &labels) 

使用QListWidgetItem为参数的函数，可以为条目指定图标

QListWidgetItem::QListWidgetItem(const QIcon &icon, const QString &text, QListWidget *parent = nullptr, int type = Type) 

删除条目

列表中的条目可以删除，以删除当前行为例

// 方法一
QListWidgetItem* item = ui->lwProvince->currentItem();
ui->lwProvince->removeItemWidget(item);
delete item;// 方法二
int row = ui->lwProvince->currentRow();
QListWidgetItem* item = ui->lwProvince->takeItem(row);
delete item;

都需要手动delete掉item；

常用信号

// 当条目被单击时，发射该信号
void itemClicked(QListWidgetItem *item);// 当条目被双击时，发射该信号
void itemDoubleClicked(QListWidgetItem *item);

举例

#ifndef WIDGET_H
#define WIDGET_H#include <QWidget>
#include<QPushButton>
#include<QListWidget>
#include<QVBoxLayout>
#include<QHBoxLayout>
#include<QMessageBox>class Widget : public QWidget
{Q_OBJECTpublic:Widget(QWidget *parent = nullptr): QWidget(parent){resize(200,200);QVBoxLayout* v_box=new QVBoxLayout(this);v_box->setSpacing(20);//创建列表list=new QListWidget(this);//添加一条初始条目QListWidgetItem* item1=new QListWidgetItem(QIcon(":/11.png"),"湖北");list->addItem(item1);v_box->addWidget(list);QHBoxLayout* h_box=new QHBoxLayout();h_box->setSpacing(20);//创建按钮add=new QPushButton("添加一行",this);del=new QPushButton("删除选中行",this);change_mod=new QPushButton("改变显示模式",this);h_box->addWidget(add);h_box->addWidget(del);h_box->addWidget(change_mod);v_box->addLayout(h_box);//绑定槽函数//添加connect(add,&QPushButton::clicked,this,[=](){//直接在尾部添加QListWidgetItem* item1=new QListWidgetItem(QIcon(":/11.png"),"浙江");list->addItem(item1);});//删除connect(del,&QPushButton::clicked,this,[=](){//删除当前选中的行QListWidgetItem* item=list->currentItem();list->removeItemWidget(item);delete item;//记手动delete// //如何遍历list里面控件的条目// for(int i=0;i<list->count();++i)// {//     获取条目的个数，然后根据索引获取条目//     auto item=list->takeItem(i);// }});//改变显示模式connect(change_mod,&QPushButton::clicked,this,[=](){//设为列表或者图标模式if(list->viewMode()==QListWidget::ListMode){list->setViewMode(QListWidget::IconMode);}else if(list->viewMode()==QListWidget::IconMode){list->setViewMode(QListWidget::ListMode);}});//绑定QListWidget控件的信号connect(list,&QListWidget::itemClicked,this,[=](){//将选中条目的文本提示下auto item=list->currentItem();//该接口获取当前选条目QMessageBox::information(this,"",QStringLiteral("当前选中：")+item->text());});}~Widget()=default;
private:QPushButton* add;QPushButton* del;QPushButton* change_mod;QListWidget* list;};
#endif // WIDGET_H

学习链接：https://github.com/0voice