QListWidget常用方法

大家好，又见面了，我是你们的朋友全栈君。

本文转载自：http://blog.csdn.net/xgbing/article/details/7768226

QListWidget类也是GUI中常用的类，它从QListView下派生：

[cpp]
view plain
copy

   
 class Q_GUI_EXPORT QListWidget : public QListView  
 {  
     Q_OBJECT  

常用方法和属性：

（1）addItem

void addItem ( const QString & label )
void addItem ( QListWidgetItem * item )
void addItems ( const QStringList & labels )

添加一项或多项。

（2）

int count () const

包含隐藏的列表项在内的列表项总数。

（3）currentItem

QListWidgetItem * currentItem () const

返回当前选择的项。

（4）currentRow

int currentRow () const

返回当前选择的项的序号。

（5）insertItem

void insertItem ( int row, QListWidgetItem * item )
void insertItem ( int row, const QString & label )
void insertItems ( int row, const QStringList & labels )

插入新项到列表框。

（6）

QListWidgetItem * item ( int row ) const

返回序号为row处的列表项。

（7）removeItemWidget

void removeItemWidget ( QListWidgetItem * item )

删除指定项item。

（8）selectedItems

QList<QListWidgetItem *> selectedItems () const

返回当前选择的项。

（9）

void setCurrentItem ( QListWidgetItem * item )

设置当前选择的项为item。

（10）

void setCurrentRow ( int row )

设置当前选择项。

（11）

void setSortingEnabled ( bool enable )

设置排序功能是否启用。

（12）

void sortItems ( Qt::SortOrder order = Qt::AscendingOrder )

排序列表框，参数的值可以是：

Qt::AscendingOrder 0 The items are sorted ascending e.g. starts with ‘AAA’ ends with ‘ZZZ’ in Latin-1 locales
Qt::DescendingOrder 1 The items are sorted descending e.g. starts with ‘ZZZ’ ends with ‘AAA’ in Latin-1 locales
（13）

QListWidgetItem * QListWidget::takeItem ( int row )

删除一项。

示例：

Window.h

[cpp]
view plain
copy

   
 #ifndef __WINDOW_H__  
 #define __WINDOW_H__  
   
 #include <QMainWindow>  
 #include <QPushButton>  
 #include <QLineEdit>  
 #include <QLayout>  
 #include <QLabel>  
 #include <QComboBox>  
 #include <QMessageBox>  
 #include <QDialog>  
 #include <QListWidget>  
   
   
 class Window : public QMainWindow  
 {  
     Q_OBJECT  
   
 public:  
     Window(QWidget *parent = NULL):QMainWindow(parent)  
     {  
           
         listWidget = new QListWidget(this);  
         new QListWidgetItem(tr(“Oak”), listWidget);  
         new QListWidgetItem(tr(“Fir”), listWidget);  
         new QListWidgetItem(tr(“Pine”), listWidget);  
   
           
         QLabel *lbl = new QLabel(tr(“select text:”));  
         edt = new QLineEdit;  
           
         QVBoxLayout *leftLayout = new QVBoxLayout;  
           
         leftLayout->addWidget(listWidget);  
         leftLayout->addWidget(lbl);  
         leftLayout->addWidget(edt);  
   
         //  
         edt_add = new QLineEdit;  
         QPushButton *add_btn = new QPushButton(tr(“Add”));  
         QPushButton *del_btn = new QPushButton(tr(“Del”));  
         QPushButton *quit_btn = new QPushButton(tr(“Quit”));  
   
         QVBoxLayout *rightLayout = new QVBoxLayout;  
         rightLayout->addWidget(edt_add);  
         rightLayout->addWidget(add_btn);  
         rightLayout->addWidget(del_btn);  
         rightLayout->addStretch();  
         rightLayout->addWidget(quit_btn);  
   
         QHBoxLayout *mainLayout = new QHBoxLayout;  
         mainLayout->addLayout(leftLayout);  
         mainLayout->addLayout(rightLayout);  
   
         QWidget *mainWidget = new QWidget;  
         mainWidget->setLayout(mainLayout);  
   
         setCentralWidget(mainWidget);  
   
         connect(listWidget, SIGNAL(itemSelectionChanged()), this, SLOT(itemSelectionChanged ()));  
         connect(add_btn, SIGNAL(clicked()), this, SLOT(on_add()));  
         connect(del_btn, SIGNAL(clicked()), this, SLOT(on_del()));  
         connect(quit_btn, SIGNAL(clicked()), this, SLOT(close()));  
     }  
   
 private:  
     QListWidget *listWidget;  
     QLineEdit *edt, *edt_add;  
   
 private slots:  
     void itemSelectionChanged()  
     {  
         edt->setText(listWidget->currentItem()->text());  
     }  
   
     void on_add()  
     {  
         listWidget->insertItem(listWidget->currentRow() + 1, edt_add->text());  
     }  
   
     void on_del()  
     {  
         listWidget->takeItem(listWidget->currentRow());  
     }  
   
   
 };  
   
   
 #endif  

main.cpp

[cpp]
view plain
copy

   
 #include <QApplication>  
 #include <QDialog>  
 #include “Window.h”  
   
   
   
 int main(int argc, char *argv[])  
 {  
     QApplication a(argc, argv);  
     Window *mainWindow = new Window;  
   
   
   
     mainWindow->resize(300, 300);  
     mainWindow->setWindowTitle(QWidget::tr(“Qt Test”));  
     mainWindow->show();  
   
     return a.exec();  
 }  

编译运行，界面如下：

QListWidget常用方法

QListWidget的项可以是带图片的显示，示例：

[cpp]
view plain
copy

   
 QListWidgetItem *configButton = new QListWidgetItem(contentsWidget);  
 configButton->setIcon(QIcon(“:/images/config.png”));  
 configButton->setText(tr(“Configuration”));  
 configButton->setTextAlignment(Qt::AlignHCenter);  
 configButton->setFlags(Qt::ItemIsSelectable | Qt::ItemIsEnabled);  
   
 QListWidgetItem *updateButton = new QListWidgetItem(contentsWidget);  
 updateButton->setIcon(QIcon(“:/images/update.png”));  
 updateButton->setText(tr(“Update”));  
 updateButton->setTextAlignment(Qt::AlignHCenter);  
 updateButton->setFlags(Qt::ItemIsSelectable | Qt::ItemIsEnabled);  
   
 QListWidgetItem *queryButton = new QListWidgetItem(contentsWidget);  
 queryButton->setIcon(QIcon(“:/images/query.png”));  
 queryButton->setText(tr(“Query”));  
 queryButton->setTextAlignment(Qt::AlignHCenter);  
 queryButton->setFlags(Qt::ItemIsSelectable | Qt::ItemIsEnabled);  