Qt入门－列表框QListWidget类

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

 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 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

 #ifndef __WINDOW_H__
 #define __WINDOW_H__

 #include
 #include
 #include
 #include
 #include
 #include
 #include
 #include
 #include


 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

 #include
 #include
 #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的项可以是带图片的显示，示例：

 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);

如图：