[TOC] ## QListWidget 常见函数 ``` // 添加item void QListWidget::​addItem(QListWidgetItem * item) void QListWidget::​addItem(const QString & label) void QListWidget::​addItems(const QStringList & labels) void QListWidget::​insertItem(int row, QListWidgetItem * item) //插入条目到第 row 行 void QListWidget::​insertItem(int row, const QString & label) //插入字符串到第 row 行 void QListWidget::​insertItems(int row, const QStringList & labels) //插入多个字符串到从 row 行开始的多个行 // 访问 QListWidgetItem * QListWidget::​item(int row) const int QListWidget::​row(const QListWidgetItem * item) const // 条目对象指针，反查当前行号 // 当前选中条目的操作 QListWidgetItem * QListWidget::​currentItem() const //当前选中 条目,不存在,返回null int QListWidget::​currentRow() const //当前选中的行号,不存在返回-1 //设置条目为选中状态 void QListWidget::​setCurrentItem(QListWidgetItem * item) //设置当前选中条目为 item void QListWidget::​setCurrentItem(QListWidgetItem * item, QItemSelectionModel::SelectionFlags command) void QListWidget::​setCurrentRow(int row, QItemSelectionModel::SelectionFlags command)//设置当前选中行为 row void QListWidget::​setCurrentItem(QListWidgetItem * item, QItemSelectionModel::SelectionFlags command) // 条目查找 QList<QListWidgetItem *> QListWidget::​findItems(const QString & text, Qt::MatchFlags flags) const // 排序 bool isSortingEnabled() const void setSortingEnabled(bool enable) // 自动按照字典序排序 //条数 int QListWidget::count() const // 删除 QListWidgetItem * QListWidget::​takeItem(int row) void QListWidget::​clear() // 清空 // 条目显示和运行时条目编辑 // 如果要按照特殊的子控件来显示字符串，比如用 QLabel 对象显示条目数据，可以用如下函 数 void QListWidget::​setItemWidget(QListWidgetItem * item, QWidget * widget) void QListWidget::​removeItemWidget(QListWidgetItem * item) //移除 ``` ## QListWidgetItem 常用函数 ``` QListWidgetItem(QListWidget * parent = 0, int type = Type) QListWidgetItem(const QString & text, QListWidget * parent = 0, int type = Type) QListWidgetItem(const QIcon & icon, const QString & text, QListWidget * parent = 0, int type = Type) void setSelected(bool select); //选中 // 设置复选框 void setCheckState(Qt::CheckState state) ``` ## 实例 ``` ui->setupUi(this); //构造列表控件的条目 for(int i=0; i<5; i++) { QListWidgetItem *itemL = new QListWidgetItem( ui->listWidget ); itemL->setText( tr("listItem %1").arg(i) ); } ```