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

#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

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

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

如图：