QListWidget
最后更新于：2022-04-02 02:11:01
[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 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) );
}
```
';