Qt QListWidget控件的使用

本文轉載自查看原文 2020-09-24 15:53 595 Qt

Qt提供QListWidget類列表框控件用來加載並顯示多個列表項。QListWidgetItem類就是列表項類。

一般列表框控件中的列表項有兩種加載方式：

一種是由用戶手動添加的列表項，比如音樂播放器中加載音樂文件的文件列表，每一個音樂文件都是一個列表項。對於這種列表項，用戶可以進行增加、刪除、單擊以及雙擊等操作。
一種是由程序員事先編寫好，寫在程序中供用戶選擇的列表項，比如餐廳的電子菜單，每一道菜對應一個列表項。對於這種列表項，用戶可以進行單機和雙擊操作(增加和刪除操作也是可以進行的，但是一般的點菜系統會屏蔽掉這種功能)。

QListWidget類列表框控件支持兩種列表項顯示方式，即QListView::IconMode和QListView::ListMode。

總結一下列表框常用的增加、刪除、單擊、雙擊操作以及列表項顯示方式設置，先給出全部代碼，再解釋。

程序效果（程序的ui界面根據此設計）

首先是main.cpp源文件

 1 #include <QtGui>
 2 #include <QApplication>
 3 #include "mainwindow.h"
 4 
 5 int main(int argc, char *argv[])  6 {  7  QApplication a(argc, argv);  8     //Qt文本的國際化顯示  9 // QTextCodec::setCodecForTr(QTextCodec::codecForName("GB18030")); 10 // QTextCodec::setCodecForLocale(QTextCodec::codecForName("GB18030")); 11 // QTextCodec::setCodecForCStrings(QTextCodec::codecForName("GB18030"));
12 
13  MainWindow w; 14  w.show(); 15     return a.exec(); 16 }

其次是mainwindow.h頭文件

 1 #ifndef MAINWINDOW_H  2 #define MAINWINDOW_H
 3 
 4 #include <QMainWindow>
 5 
 6 #include <QtDebug>
 7 #include <QMessageBox>
 8 
 9 #include <QListWidgetItem>      //列表框空間頭文件
10 #include <QFileDialog>          //文件對話框控件
11 #include <QStringList>          //字符串容器
12 #include <QDir>                 //目錄類頭文件
13 #include <QString>
14 
15 namespace Ui { 16 class MainWindow; 17 } 18 
19 class MainWindow : public QMainWindow 20 { 21  Q_OBJECT 22 
23 public: 24     explicit MainWindow(QWidget *parent = 0); 25     ~MainWindow(); 26 
27 private: 28     Ui::MainWindow *ui; 29 private slots: 30     void addbtn(); 31     void deletebtn(); 32     void delallbtn(); 33     void addallbtn(); 34     void singleclicked(QListWidgetItem* item); 35     void doubleclicked(QListWidgetItem* item); 36 
37 }; 38 
39 #endif // MAINWINDOW_H

最后是mainwindow.cpp源文件

 1 #include "mainwindow.h"
 2 #include "ui_mainwindow.h"
 3 
 4 MainWindow::MainWindow(QWidget *parent) :  5  QMainWindow(parent),  6     ui(new Ui::MainWindow)  7 {  8     ui->setupUi(this);  9     this->setWindowTitle(tr("listWidget學習"));   //設置標題框文本
 10     ui->listWidget->setViewMode(QListView::IconMode);   //設置顯示模式為圖標模式  11 // ui->listWidget->setViewMode(QListView::ListMode); //設置顯示模式為列表模式
 12     QObject::connect(ui->AddButton,SIGNAL(clicked()),this,SLOT(addbtn()));  13     QObject::connect(ui->lineEdit,SIGNAL(returnPressed()),this,SLOT(addbtn()));  14     QObject::connect(ui->DeleteButton,SIGNAL(clicked()),this,SLOT(deletebtn()));  15     QObject::connect(ui->DelAllButton,SIGNAL(clicked()),this,SLOT(delallbtn()));  16     QObject::connect(ui->ShowDirButton,SIGNAL(clicked()),this,SLOT(addallbtn()));  17 // QObject::connect(ui->listWidget,SIGNAL(itemClicked(QListWidgetItem*)),this,SLOT(singleclicked(QListWidgetItem*)));
 18     QObject::connect(ui->listWidget,SIGNAL(itemDoubleClicked(QListWidgetItem*)),this,SLOT(doubleclicked(QListWidgetItem*)));  19 }  20 
 21 MainWindow::~MainWindow()  22 {  23     delete ui;  24 }  25 
 26 /***** 添加單個列表項 *****/
 27 void MainWindow::addbtn()  28 {  29     QString str = ui->lineEdit->text();     //獲取行編輯框文本
 30     QListWidgetItem *item = new QListWidgetItem;  31     item->setText(str);                     //設置列表項的文本
 32     ui->listWidget->addItem(item);          //加載列表項到列表框  33 // delete item; //此處若解除注釋，將無法添加到列表框  34 // item = NULL;
 35     ui->lineEdit->clear();                  //清空行編輯框
 36 }  37 
 38 /***** 刪除單個列表項 *****/
 39 void MainWindow::deletebtn()  40 {  41     //獲取列表項的指針
 42     QListWidgetItem *item = ui->listWidget->takeItem(ui->listWidget->currentRow());  43     delete item;        //釋放指針所指向的列表項
 44 }  45 
 46 /***** 刪除多個列表項 *****/
 47 void MainWindow::delallbtn()  48 {  49     int num = ui->listWidget->count();  //獲取列表項的總數目
 50     ui->listWidget->setFocus(); //將光標設置到列表框上，若注釋該語句，則刪除時，要手動將焦點設置到列表框，即點擊列表項
 51     for(int i=0;i<num;i++)  52     {   //逐個獲取列表項的指針，並刪除
 53         QListWidgetItem *item = ui->listWidget->takeItem(ui->listWidget->currentRow());  54         delete item;  55  }  56 }  57 
 58 /***** 添加多個列表項 *****/
 59 void MainWindow::addallbtn()  60 {  61     QStringList FileNames = QFileDialog::getOpenFileNames(this,"打開",QDir::currentPath(),"所有文件(*.*);;文本文檔(*.txt)");  62 
 63     //方法1 整體添加  64 // ui->listWidget->addItems(FileNames);  65 
 66     //方法2 逐個添加
 67     int index=0,count=0;  68 // QListWidgetItem *item = new QListWidgetItem; //…………注釋1
 69     count = FileNames.count();              //獲取打開文件的總數目  70 
 71 // for(index = 0;index<count;index++) //這樣會報錯，無法先取出棧底元素 //注釋2
 72     for(index=count-1;index>=0;index--)     //QList<QString>的數據結構是棧，只能從棧頂取元素
 73  {  74         QListWidgetItem *item = new QListWidgetItem;  75         item->setText(FileNames.takeAt(index)); //逐個設置列表項的文本  76 // qDebug()<<FileNames.takeAt(index); //…………注釋3
 77         ui->listWidget->addItem(item);      //加載列表項到列表框
 78  }  79 }  80 /*
 81 注意事項：  82 1、QList<QString>的數據結構是棧，只能從棧頂取元素，所以如果將for循環注釋掉，  83 將注釋2解開，程序會出錯。因為無法首先取出棧底元素，只能從棧頂開始。  84 2、對於for循環中的takeAt()函數來說，是將index 所指定的索引位置的數據取走，  85 並不是復制。所以，如果將注釋3的打印語句解開的話，數據元素被取走，無法成功打印，程序出錯。  86 3、如果將for循環中的QListWidgetItem *item = new QListWidgetItem;語句注釋起來，  87 並將注釋1和注釋3解開，就可以打印出字符串列表FileNames中所有的字符串。只是運行程序會發成覆蓋，  88 最終顯示在列表框中的列表項是棧底元素(編譯時，需要將takeAt()函數注釋掉)。  89 */
 90 
 91 
 92 /***** 列表項單擊操作 *****/
 93 void MainWindow::singleclicked(QListWidgetItem* item)  94 {  95     QMessageBox::information(this,"單擊消息","單擊"+item->text());  96 }  97 
 98 /***** 列表項雙擊操作 *****/
 99 void MainWindow::doubleclicked(QListWidgetItem* item) 100 { 101     QMessageBox::information(this,"雙擊消息","雙擊"+item->text()); 102 }

一、列表項的顯示設置

ui->listWidget->setViewMode(QListView::IconMode);   //設置顯示模式為圖標模式
ui->listWidget->setViewMode(QListView::ListMode);   //設置顯示模式為列表模式

二、列表框常用操作

列表框控件常用的操作：添加操作、刪除操作、單擊操作以及雙擊操作，下面分別介紹。

1、添加操作

添加操作又可以分為單列表項操作和多列表項操作。

①單列表項操作(以添加用戶輸入到行編輯框中的數據為例)

voidMainWindow::addbtn()
{
    QStringstr=ui->lineEdit->text();     //獲取行編輯框文本
    QListWidgetItem*item=newQListWidgetItem;
    item->setText(str);                   
 //設置列表項的文本
    ui->listWidget->addItem(item);    //加載列表項到列表框
//    deleteitem;                          //此處若解除注釋，將無法添加到列表框
//    item=NULL;
    ui->lineEdit->clear();                  //清空行編輯框
}

②多列表項操作(以添加多個文件名到列表框為例)

QStringList QFileDialog::getOpenFileNames ( QWidget * parent = 0, constQString & caption = QString(), const QString & dir = QString(), const QString& filter = QString(), QString * selectedFilter = 0, Options options =0 )[static]

該靜態成員函數將按照給定的參數構造一個模態文件對話框，將用戶選擇的一個或多個現存的文件的路徑名存儲到字符串列表中，並返回該字符串列表。

QString QDir::currentPath () [static]

該靜態成員函數用來返回應用程序的當前工作目錄的絕對路徑。

void QListWidget::addItems (const QStringList & labels )

該函數用來將字符串列表中的全部字符串作為列表項，添加到列表框中。

void QListWidget::addItem ( QListWidgetItem * item )

該函數用來將一個列表項添加到列表框當中。

注意：一個列表項只能被添加到列表框中一次，如果多次添加同一個列表項到列表框中，將導致不可預期的結果。

void QListWidget::addItem (const QString & label )

重載函數，用來將參數label所引用的字符串作為一個列表項，添加到列表框中。

int QList::count ()const          int QList::size ()const

上述兩個函數的功能等價，都是用來返回列表中存儲的對象元素的個數。

T QList::takeAt ( int i )

該函數按照參數i指定的索引位置，將存儲在列表中對應的對象元素移除並返回。返回類型為模板類型，由存儲的數據的類型決定。索引值的大小范圍為0<= i <= size()。

//方法1 整體添加

voidMainWindow::addallbtn()
{
    QStringListFileNames=QFileDialog::getOpenFileNames(this,"打開",
      QDir::currentPath(),
      "所有文件(*.*);;文本文檔(*.txt)");
    ui->listWidget->addItems(FileNames);
}

//方法2 逐個添加

voidMainWindow::addallbtn()
{  
 
    QStringListFileNames=QFileDialog::getOpenFileNames(this,"打開",
      QDir::currentPath(),
      "所有文件(*.*);;文本文檔(*.txt)");
    intindex=0,count=0;
//    QListWidgetItem*item=newQListWidgetItem;       //…………注釋1
    count=FileNames.count();            //獲取打開文件的總數目
//    for(index=0;index<count;index++)    //這樣會報錯，無法先取出棧底元素  //注釋2
    //QList<QString>的數據結構是棧，只能從棧頂取元素
  for(index=count-1;index>=0;index--)     
   {
        QListWidgetItem*item=newQListWidgetItem;
        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()函數注釋掉)。

2、刪除操作

刪除操作又可以分為單文件操作和多文件操作。

①刪除單個列表項(刪除列表框中的單個列表項)

QListWidgetItem *QListWidget::takeItem ( int row )

該函數用來將索引號為row的列表項從列表框移除，並返回該列表項的指針。

int currentRow() const

該常成員函數用來獲取當前列表項的索引號，並返回。

voidMainWindow::deletebtn()
{
    //獲取列表項的指針
    QListWidgetItem*item=ui->listWidget->takeItem(ui->listWidget->currentRow());
    deleteitem;        //釋放指針所指向的列表項
}

②刪除多個文件(刪除列表框中的所有列表項)

voidMainWindow::delallbtn()
{
    intnum=ui->listWidget->count();  //獲取列表項的總數目
    ui->listWidget->setFocus();      //將光標設置到列表框上
    for(inti=0;i<num;i++)
    {  //逐個獲取列表項的指針，並刪除
        QListWidgetItem*item=ui->listWidget->takeItem(ui->listWidget->currentRow());
        deleteitem;
    }
}

3、點擊操作

①單擊操作(輸出單擊項的文本)

voidMainWindow::singleclicked(QListWidgetItem*item)
{
    QMessageBox::information(this,"單擊消息","單擊"+item->text());
}

②雙擊操作(輸出雙擊項的文本)

voidMainWindow::doubleclicked(QListWidgetItem*item)
{
    QMessageBox::information(this,"雙擊消息","雙擊"+item->text());
}

免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。

猜您在找 Qt學習——QListWidget控件的使用 qt5--列表控件QListWidget Qt QListWidget Qt：QListWidget PyQt5-高級控件使用（QListWidget） QListWidget加入小控件 QT QListWidget 簡單的操作 Qt Qlistwidget、Qlistview Qt的常用控件及控件的使用 pyqt5--列表控件QListWidget