目录
1.概述
2.QListWidget 类常用的属性和方法
3.QListWidget列表框的信号和槽
4.QListWidget 类常用操作示例
4.1 初始化列表
4.2 插入项
4.3 删除当前项和清空列表
4.4 遍历并选择项
4.5 QListWidgetItem常用信号
5.QListWidget 类简单应用
1.概述
- Qt 中用于项 (Item ）处理的组件有两类，一类是 ItemViews ，包括 QListView 、 QTreeView 、 QTableView、QColumnView等；另一类是ItemWidgets,包括QListWidget、QTreeWidget和 QTableWidget。
- ItemViews基于模型／视图（ModelAfiew）结构，视图（View）与模型数据（ModelData）关 联实现数据的显示和编辑。
- ItemWidgets是直接将数据存储在每一个项里，例如，QListWidget的每一行是一个项， QTreeWidget 的每个节点是一个项， QTableWidget 的每一个单元格是一个项。一个项存储了文字、 文字的格式、自定义数据等。
- 使用 Qt 框架开发 GUI 程序，如果需要以列表的方法展示数据，可以优先考虑用 QListWidget 类实现。
2.QListWidget 类常用的属性和方法
表 1 QListWidget常用属性和方法
3.QListWidget列表框的信号和槽
表 2 QListWidget信号和槽函数
4.QListWidget 类常用操作示例
4.1 初始化列表
列表框里一行是一个项，是一个QListWidgetItem类型的对象，向列表框添加一个项，就需要 创建一个QListWidgetItem类型的实例aItem，然后设置 aItem 的一些属性，再用QListWidget:： Addltem()函数将该 aItem 添加到列表框里。
QListWidgetItem有许多函数方法，可以设置项的很多属性，如设置文字、图标、选中状态， 还可以设置flags。
void MainWindow::on_actListIni_triggered()
{ //初始化项QListWidgetItem *aItem; //每一行是一个QListWidgetItemQIcon aIcon;aIcon.addFile(":/images/icons/check2.ico"); //设置ICON的图标bool chk=ui->chkBoxListEditable->isChecked();//是否可编辑ui->listWidget->clear(); //清除项for (int i=0; i<10; i++){QString str=QString::asprintf("Item %d",i);aItem=new QListWidgetItem(); //新建一个项aItem->setText(str); //设置文字标签aItem->setIcon(aIcon);//设置图标aItem->setCheckState(Qt::Checked); //设置为选中状态if (chk) //可编辑, 设置flagsaItem->setFlags(Qt::ItemIsSelectable | Qt::ItemIsEditable |Qt::ItemIsUserCheckable |Qt::ItemIsEnabled);else//不可编辑, 设置flagsaItem->setFlags(Qt::ItemIsSelectable |Qt::ItemIsUserCheckable |Qt::ItemIsEnabled);ui->listWidget->addItem(aItem); //增加一个项}
}4.2 插入项
插入项使用QListWidget的insertltem(introw，QListWidgetItem*item)函数，在某一行row的前
面插入一个QListWidgetItem对象item，也需要先创建这个item，并设置好其属性。
void MainWindow::on_actListInsert_triggered()
{ //插入一个项
// QListWidgetItem *aItem;QIcon aIcon;aIcon.addFile(":/images/icons/check2.ico"); //图标bool chk=ui->chkBoxListEditable->isChecked(); //是否可比那几QListWidgetItem* aItem=new QListWidgetItem("New Inserted Item"); //创建一个项aItem->setIcon(aIcon);//设置图标aItem->setCheckState(Qt::Checked); //设置为checkedif (chk) //设置标记aItem->setFlags(Qt::ItemIsSelectable | Qt::ItemIsEditable |Qt::ItemIsUserCheckable |Qt::ItemIsEnabled);elseaItem->setFlags(Qt::ItemIsSelectable |Qt::ItemIsUserCheckable |Qt::ItemIsEnabled);ui->listWidget->insertItem(ui->listWidget->currentRow(),aItem); //在当前行的上方插入一个项
}4.3 删除当前项和清空列表
takeltem()函数只是移除一个项，并不删除项对象，所以还需要用delete从内存中删除它。 要清空列表框的所有项，只需调用QListWidget::clear()函数即可。
void MainWindow::on_actListDelete_triggered()
{ //删除当前项int row=ui->listWidget->currentRow();//当前行QListWidgetItem* aItem=ui->listWidget->takeItem(row); //移除指定行的项，但不deletedelete aItem; //需要手工删除对象
}4.4 遍历并选择项
函数QListWidget1tem:：setCheckState(Qt::CheckStatestate）设置列表项的复选状态，枚举类型 Qt::CheckState有3种取值。
- Qt::Unchecked，不被选中。
- Qt::PartiallyChecked，部分选中。在目录树中的节点可能出现这种状态，比如其子节点没
- 有全部被勾选时。
- Qt::Checked,被选中。
void MainWindow::on_actSelALL_triggered()
{ //项全选int cnt=ui->listWidget->count();//项个数for (int i=0; i<cnt; i++){QListWidgetItem *aItem=ui->listWidget->item(i);//获取一个项aItem->setCheckState(Qt::Checked);//设置为选中}
}4.5 QListWidgetItem常用信号
void MainWindow::on_listWidget_currentItemChanged(QListWidgetItem *current, QListWidgetItem *previous)
{ //listWidget当前选中项发生变化QString str;if (current != NULL) //需要检测变量指针是否为空{if (previous==NULL) //需要检测变量指针是否为空str="当前："+current->text();elsestr="前一项："+previous->text()+"; 当前项："+current->text();ui->editCutItemText->setText(str);}
}5.QListWidget 类简单应用
#include <QtGui/QApplication>
#include <QWidget>
#include <QLabel>
#include <QListWidget>
#include <QHBoxLayout>
#include <QIcon>int main(int argc, char *argv[])
{QApplication a(argc, argv);QLabel *label = new QLabel;label->setFixedWidth(100);QListWidget *listWidget = new QListWidget;listWidget->addItem(new QListWidgetItem(QIcon(QObject::tr("images/china.png")), QObject::tr("China")));listWidget->addItem(new QListWidgetItem(QIcon(QObject::tr("images/hk.png")), QObject::tr("Hong Kong")));listWidget->addItem(new QListWidgetItem(QIcon(QObject::tr("images/macau.png")), QObject::tr("Macau")));QHBoxLayout *mainlayout = new QHBoxLayout;mainlayout->addWidget(listWidget);mainlayout->addWidget(label);QObject::connect(listWidget, SIGNAL(currentTextChanged(QString)), label, SLOT(setText(QString)));QWidget *widget = new QWidget;widget->setLayout(mainlayout);widget->setWindowTitle(QObject::tr("QListWidget Demo"));widget->show();return a.exec();
}
