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);
如图: