QListWidget控件的使用

Qt提供QListWidget类列表框控件用来加载并显示多个列表项。QListWidgetItem类就是列表项类。一般列表框控件中的列表项有两种加载方式:

一种是由用户手动添加的列表项,比如音乐播放器中加载音乐文件的文件列表,每一个音乐文件都是一个列表项。

对于这种列表项,用户可以进行增加、删除、单击以及双击等操作。

 

一种是由程序员事先编写好,写在程序*用户选择的列表项,比如餐厅的电子菜单,每一道菜对应一个列表项。

对于这种列表项,用户可以进行单机和双击操作(增加和删除操作也是可以进行的,但是一般的点菜系统会屏蔽掉这种功能)。

QListWidget类列表框控件支持两种列表项显示方式,即QListView::IconMode和QListView::ListMode。

总结一下列表框常用的增加、删除、单击、双击操作以及列表项显示方式设置,先给出全部代码,再解释。

QListWidget控件的使用


widget.h:

#ifndef WIDGET_H
#define WIDGET_H

#include <QWidget>
#include <QtDebug>
#include <QMessageBox>
#include <QListWidgetItem>      //列表框空间头文件
#include <QFileDialog>          //文件对话框控件
#include <QStringList>          //字符串容器
#include <QDir>                 //目录类头文件
#include <QString>

namespace Ui {
class Widget;
}

class Widget : public QWidget
{
    Q_OBJECT

public:
    explicit Widget(QWidget *parent = 0);
    ~Widget();

private:
    Ui::Widget *ui;

    void addbtn();
    void deletebtn();
    void delallbtn();
    void addallbtn();
    void singleclicked(QListWidgetItem* item);
    void doubleclicked(QListWidgetItem* item);
};

#endif // WIDGET_H


Widget.cpp

#include "widget.h"
#include "ui_widget.h"
Widget::Widget(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::Widget)
{
    ui->setupUi(this);
    this->setWindowTitle(tr("listWidget学习"));   //设置标题框文本
    ui->listWidget->setViewMode(QListView::IconMode);   //设置显示模式为图标模式
    //ui->listWidget->setViewMode(QListView::ListMode);   //设置显示模式为列表模式
    QObject::connect(ui->AddButton,&QPushButton::clicked,this,&Widget::addbtn);
    QObject::connect(ui->lineEdit,&QLineEdit::returnPressed,this,&Widget::addbtn);
    QObject::connect(ui->DeleteButton,&QPushButton::clicked,this,&Widget::deletebtn);
    QObject::connect(ui->DelAllButton,&QPushButton::clicked,this,&Widget::delallbtn);
    QObject::connect(ui->ShowDirButton,&QPushButton::clicked,this,&Widget::addallbtn);
    //QObject::connect(ui->listWidget,&QListWidget::itemClicked,this,&Widget::singleclicked);
    QObject::connect(ui->listWidget,&QListWidget::itemDoubleClicked,this,&Widget::doubleclicked);
}
Widget::~Widget()
{
    delete ui;
}
/***** 添加单个列表项 *****/
void Widget::addbtn()
{
    QString str = ui->lineEdit->text();     //获取行编辑框文本
    QListWidgetItem *item = new QListWidgetItem;
    item->setText(str);                     //设置列表项的文本
    ui->listWidget->addItem(item);          //加载列表项到列表框
//    delete item;                          //此处若解除注释,将无法添加到列表框
//    item = NULL;
    ui->lineEdit->clear();                  //清空行编辑框
}
/***** 删除单个列表项 *****/
void Widget::deletebtn()
{
    //获取列表项的指针
    QListWidgetItem *item = ui->listWidget->takeItem(ui->listWidget->currentRow());
    delete item;        //释放指针所指向的列表项
}
/***** 删除多个列表项 *****/
void Widget::delallbtn()
{
    int num = ui->listWidget->count();  //获取列表项的总数目
    ui->listWidget->setFocus(); //将光标设置到列表框上,若注释该语句,则删除时,要手动将焦点设置到列表框,即点击列表项
    for(int i=0;i<num;i++)
    {   //逐个获取列表项的指针,并删除
        QListWidgetItem *item = ui->listWidget->takeItem(ui->listWidget->currentRow());
        delete item;
    }
}
/***** 添加多个列表项 *****/
void Widget::addallbtn()
{
    QStringList FileNames = QFileDialog::getOpenFileNames(this,"打开",QDir::currentPath(),"所有文件(*.*);;文本文档(*.txt)");
    //方法1  整体添加
//    ui->listWidget->addItems(FileNames);
    //方法2  逐个添加
    int index=0,count=0;
//    QListWidgetItem *item = new QListWidgetItem;  //…………注释1
    count = FileNames.count();              //获取打开文件的总数目
//    for(index = 0;index<count;index++)    //这样会报错,无法先取出栈底元素  //注释2
    for(index=count-1;index>=0;index--)     //QList<QString>的数据结构是栈,只能从栈顶取元素
   {
        QListWidgetItem *item = new QListWidgetItem;
        item->setText(FileNames.takeAt(index)); //逐个设置列表项的文本
//        qDebug()<<FileNames.takeAt(index);        //…………注释3
        ui->listWidget->addItem(item);      //加载列表项到列表框
   }
}
/*
注意事项:
1、QList<QString>的数据结构是栈,只能从栈顶取元素,所以如果将for循环注释掉,
将注释2解开,程序会出错。因为无法首先取出栈底元素,只能从栈顶开始。
2、对于for循环中的takeAt()函数来说,是将index 所指定的索引位置的数据取走,
并不是复制。所以,如果将注释3的打印语句解开的话,数据元素被取走,无法成功打印,程序出错。
3、如果将for循环中的QListWidgetItem *item = new QListWidgetItem;语句注释起来,
并将注释1和注释3解开,就可以打印出字符串列表FileNames中所有的字符串。只是运行程序会发成覆盖,
最终显示在列表框中的列表项是栈底元素(编译时,需要将takeAt()函数注释掉)。
*/
/***** 列表项单击操作 *****/
void Widget::singleclicked(QListWidgetItem* item)
{
    QMessageBox::information(this,"单击消息","单击"+item->text());
}
/***** 列表项双击操作 *****/
void Widget::doubleclicked(QListWidgetItem* item)
{
    QMessageBox::information(this,"双击消息","双击"+item->text());
}