原文:http://blog.csdn.net/gdutlyp/article/details/50370536
Qt提供QListWidget類列表框控件用來加載並顯示多個列表項。QListWidgetItem類就是列表項類。一般列表框控件中的列表項有兩種加載方式:
一種是由用戶手動添加的列表項,比如音樂播放器中加載音樂文件的文件列表,每一個音樂文件都是一個列表項。
對於這種列表項,用戶可以進行增加、刪除、單擊以及雙擊等操作。
一種是由程序員事先編寫好,寫在程序中供用戶選擇的列表項,比如餐廳的電子菜單,每一道菜對應一個列表項。
對於這種列表項,用戶可以進行單機和雙擊操作(增加和刪除操作也是可以進行的,但是一般的點菜系統會屏蔽掉這種功能)。
QListWidget類列表框控件支持兩種列表項顯示方式,即QListView::IconMode和QListView::ListMode。
總結一下列表框常用的增加、刪除、單擊、雙擊操作以及列表項顯示方式設置,先給出全部代碼,再解釋。
圖1 程序界面
首先是main.cpp源文件#include <QtGui/QApplication>
#include "mainwindow.h"
#include <QTextCodec>
int main(int argc, char *argv[])
{
QApplication a(argc, argv);
//Qt文本的國際化顯示
QTextCodec::setCodecForTr(QTextCodec::codecForName("GB18030"));
QTextCodec::setCodecForLocale(QTextCodec::codecForName("GB18030"));
QTextCodec::setCodecForCStrings(QTextCodec::codecForName("GB18030"));
MainWindow w;
w.show();
return a.exec();
}
其次是mainwindow.h頭文件
#ifndef MAINWINDOW_H
#define MAINWINDOW_H
#include <QMainWindow>
#include <QtDebug>
#include <QMessageBox>
#include <QListWidgetItem> //列表框空間頭文件
#include <QFileDialog> //文件對話框控件
#include <QStringList> //字符串容器
#include <QDir> //目錄類頭文件
#include <QString>
namespace Ui {
class MainWindow;
}
class MainWindow : public QMainWindow
{
Q_OBJECT
public:
explicit MainWindow(QWidget *parent = 0);
~MainWindow();
private:
Ui::MainWindow *ui;
private slots:
void addbtn();
void deletebtn();
void delallbtn();
void addallbtn();
void singleclicked(QListWidgetItem* item);
void doubleclicked(QListWidgetItem* item);
};
#endif // MAINWINDOW_H
最後是mainwindow.cpp源文件
#include "mainwindow.h"
#include "ui_mainwindow.h"
MainWindow::MainWindow(QWidget *parent) :
QMainWindow(parent),
ui(new Ui::MainWindow)
{
ui->setupUi(this);
this->setWindowTitle(tr("listWidget學習")); //設置標題框文本
ui->listWidget->setViewMode(QListView::IconMode); //設置顯示模式爲圖標模式
// ui->listWidget->setViewMode(QListView::ListMode); //設置顯示模式爲列表模式
QObject::connect(ui->AddButton,SIGNAL(clicked()),this,SLOT(addbtn()));
QObject::connect(ui->lineEdit,SIGNAL(returnPressed()),this,SLOT(addbtn()));
QObject::connect(ui->DeleteButton,SIGNAL(clicked()),this,SLOT(deletebtn()));
QObject::connect(ui->DelAllButton,SIGNAL(clicked()),this,SLOT(delallbtn()));
QObject::connect(ui->ShowDirButton,SIGNAL(clicked()),this,SLOT(addallbtn()));
// QObject::connect(ui->listWidget,SIGNAL(itemClicked(QListWidgetItem*)),this,SLOT(singleclicked(QListWidgetItem*)));
QObject::connect(ui->listWidget,SIGNAL(itemDoubleClicked(QListWidgetItem*)),this,SLOT(doubleclicked(QListWidgetItem*)));
}
MainWindow::~MainWindow()
{
delete ui;
}
/***** 添加單個列表項 *****/
void MainWindow::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 MainWindow::deletebtn()
{
//獲取列表項的指針
QListWidgetItem *item = ui->listWidget->takeItem(ui->listWidget->currentRow());
delete item; //釋放指針所指向的列表項
}
/***** 刪除多個列表項 *****/
void MainWindow::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 MainWindow::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 MainWindow::singleclicked(QListWidgetItem* item)
{
QMessageBox::information(this,"單擊消息","單擊"+item->text());
}
/***** 列表項雙擊操作 *****/
void MainWindow::doubleclicked(QListWidgetItem* item)
{
QMessageBox::information(this,"雙擊消息","雙擊"+item->text());
}
一、列表項的顯示設置
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());