QListWidget Class

QListWidget *listWidget = new QListWidget(this);

new QListWidgetItem(tr("Oak"), listWidget);
new QListWidgetItem(tr("Fir"), listWidget);
new QListWidgetItem(tr("Pine"), listWidget);

QListWidgetItem *newItem = new QListWidgetItem;
newItem->setText(itemText);
listWidget->insertItem(row, newItem);

成员函数文档

[explicit] QListWidget::QListWidget(QWidget *parent = nullptr)

使用给定的parent 构造一个空的QListWidget。

[virtual noexcept] QListWidget::~QListWidget()

销毁列表控件及其所有项目。

void QListWidget::addItem(QListWidgetItem *item)

将item 插入到列表控件的末尾。

另请参阅 insertItem()。

void QListWidget::addItem(const QString &label)

在列表控件的末尾插入一个内容为“label ”的项目。

void QListWidget::addItems(const QStringList &labels)

在列表控件末尾插入包含文本“labels ”的项目。

另请参阅 insertItems()。

[slot] void QListWidget::clear()

删除视图中的所有项目和选中内容。

void QListWidget::closePersistentEditor(QListWidgetItem *item)

关闭指定item 的持久化编辑器。

另请参阅 openPersistentEditor() 和isPersistentEditorOpen()。

QListWidgetItem *QListWidget::currentItem() const

返回当前项目。

另请参阅 setCurrentItem()。

[signal] void QListWidget::currentItemChanged(QListWidgetItem *current, QListWidgetItem *previous)

每当当前项目发生变化时，都会触发此信号。

previous 是之前拥有焦点的项目；current 是新的当前项目。

[signal] void QListWidget::currentRowChanged(int currentRow)

每当当前项目发生变化时，都会发出此信号。

currentRow 表示当前项目的行号。如果没有当前项目，则currentRow 的值为-1。

[signal] void QListWidget::currentTextChanged(const QString &currentText)

每当当前项目发生变化时，都会触发此信号。

currentText 是当前项目的文本数据。如果不存在当前项目，则currentText 将无效。

[override virtual protected] void QListWidget::dropEvent(QDropEvent *event)

重写了：QListView::dropEvent(QDropEvent *event)。

[virtual protected] bool QListWidget::dropMimeData(int index, const QMimeData *data, Qt::DropAction action)

处理由外部拖放操作提供的data ，该操作以给定的action 结束于给定的index 中。如果模型能够处理data 和action ，则返回true ；否则返回false 。

另请参阅 supportedDropActions() 和supportedDragActions 。

void QListWidget::editItem(QListWidgetItem *item)

如果item 文件可编辑，则开始对其进行编辑。

[override virtual protected] bool QListWidget::event(QEvent *e)

重写了：QListView::event(QEvent *e)。

QList<QListWidgetItem *> QListWidget::findItems(const QString &text, Qt::MatchFlags flags) const

使用给定的flags ，查找文本内容与字符串text 匹配的项目。

QModelIndex QListWidget::indexFromItem(const QListWidgetItem *item) const

返回与给定的item 关联的QModelIndex 。

void QListWidget::insertItem(int row, QListWidgetItem *item)

将item 插入到列表中由row 指定的位置。

另请参阅 addItem()。

void QListWidget::insertItem(int row, const QString &label)

在列表控件中，将文本为“label ”的项目插入到由row 指定的位置。

另请参阅 addItem()。

void QListWidget::insertItems(int row, const QStringList &labels)

将labels 列表中的项目插入到该列表中，从给定的row 位置开始。

另请参阅 insertItem() 和addItem()。

bool QListWidget::isPersistentEditorOpen(QListWidgetItem *item) const

返回是否为项目item 打开了持久化编辑器。

另请参阅 openPersistentEditor() 和closePersistentEditor()。

QListWidgetItem *QListWidget::item(int row) const

如果列表中已设置了指定的row ，则返回该项；否则返回nullptr 。

另请参阅 row()。

[signal] void QListWidget::itemActivated(QListWidgetItem *item)

当item 被激活时，会发出此信号。item 在用户单击或双击该控件时被激活，具体取决于系统配置。此外，当用户按下激活键时，该控件也会被激活（在Windows和X11系统中，此键为Return 键；在Mac OS X系统中，此键为Command+O 键）。

QListWidgetItem *QListWidget::itemAt(const QPoint &p) const

返回指向坐标为p 处项的指针。该坐标相对于列表控件的viewport()方法。

QListWidgetItem *QListWidget::itemAt(int x, int y) const

返回位于坐标 (x,y) 处的项的指针。这些坐标是相对于列表控件的viewport() 函数的。

[signal] void QListWidget::itemChanged(QListWidgetItem *item)

每当item 的数据发生变化时，就会触发此信号。

[signal] void QListWidget::itemClicked(QListWidgetItem *item)

当在小部件中的某个项目上单击鼠标按钮时，会触发此信号，并传递指定的item 。

另请参阅 itemPressed() 和itemDoubleClicked()。

[signal] void QListWidget::itemDoubleClicked(QListWidgetItem *item)

当在小部件中的某个项目上双击鼠标按钮时，会发出此信号，并附带指定的item 。

另请参阅 itemClicked()和itemPressed()。

[signal] void QListWidget::itemEntered(QListWidgetItem *item)

当鼠标光标进入某个项目时，会触发此信号。item 即为被进入的项目。只有在启用了 mouseTracking 时，或者在移动至某个项目时按下了鼠标按钮，才会触发此信号。

另请参阅 QWidget::setMouseTracking()。

QListWidgetItem *QListWidget::itemFromIndex(const QModelIndex &index) const

返回与给定的index 关联的QListWidgetItem 的指针。

[signal] void QListWidget::itemPressed(QListWidgetItem *item)

当在小部件中的某个项目上按下鼠标按钮时，会发出此信号，并附带指定的item 。

另请参阅 itemClicked() 和itemDoubleClicked()。

[signal] void QListWidget::itemSelectionChanged()

每当选中内容发生变化时，都会发出此信号。

另请参阅 selectedItems()、QListWidgetItem::isSelected() 和currentItemChanged()。

QWidget *QListWidget::itemWidget(QListWidgetItem *item) const

返回在给定的item 中显示的小部件。

另请参阅 setItemWidget() 和removeItemWidget()。

QList<QListWidgetItem *> QListWidget::items(const QMimeData *data) const

返回一个包含指向data 对象中所含项的指针的列表。如果该对象并非由同一进程中的QListWidget 创建的，则该列表为空。

[virtual protected] QMimeData *QListWidget::mimeData(const QList<QListWidgetItem *> &items) const

返回一个包含指定items 的序列化描述的对象。用于描述项目的格式由mimeTypes()函数提供。

如果项目列表为空，则返回nullptr ，而不是序列化的空列表。

[virtual protected] QStringList QListWidget::mimeTypes() const

返回一个 MIME 类型列表，该列表可用于描述列表控件项的列表。

另请参阅 mimeData()。

void QListWidget::openPersistentEditor(QListWidgetItem *item)

打开指定item 的编辑器。编辑完成后，编辑器仍保持打开状态。

另请参阅 closePersistentEditor() 和isPersistentEditorOpen()。

void QListWidget::removeItemWidget(QListWidgetItem *item)

移除设置在指定item 上的控件。

若要彻底从列表中移除一个项目（行），请删除该项目或使用takeItem() 方法。

另请参阅 itemWidget() 和setItemWidget()。

int QListWidget::row(const QListWidgetItem *item) const

返回包含给定item 的行。

另请参阅 item()。

[slot] void QListWidget::scrollToItem(const QListWidgetItem *item, QAbstractItemView::ScrollHint hint = EnsureVisible)

如有必要，会滚动视图以确保item 处于可见状态。

hint 指定操作完成后item 应位于何处。

QList<QListWidgetItem *> QListWidget::selectedItems() const

返回列表控件中所有已选中项的列表。

void QListWidget::setCurrentItem(QListWidgetItem *item)

将当前项目设置为item 。

除非选择模式为NoSelection ，否则该项目也会被选中。

另请参阅 currentItem()。

void QListWidget::setCurrentItem(QListWidgetItem *item, QItemSelectionModel::SelectionFlags command)

使用给定的command ，将当前项设置为item 。

void QListWidget::setCurrentRow(int row, QItemSelectionModel::SelectionFlags command)

将当前行设置为给定的row ，并使用给定的command ，

另请参阅 currentRow()。

void QListWidget::setItemWidget(QListWidgetItem *item, QWidget *widget)

将widget 设置为在给定的item 中显示。

此函数仅应用于在列表控件项的位置显示静态内容。若要显示自定义动态内容或实现自定义编辑器控件，请改用QListView 并继承QStyledItemDelegate 类。

另请参阅 itemWidget()、removeItemWidget() 以及委托类。

[override virtual] void QListWidget::setSelectionModel(QItemSelectionModel *selectionModel)

重写了：QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel)。

void QListWidget::sortItems(Qt::SortOrder order = Qt::AscendingOrder)

根据指定的order 对列表控件中的所有项目进行排序。

[virtual protected] Qt::DropActions QListWidget::supportedDropActions() const

返回该视图支持的拖放操作。

另请参阅 Qt::DropActions 、supportedDragActions 以及dropMimeData()。

QListWidgetItem *QListWidget::takeItem(int row)

从列表控件中移除并返回指定row 中的项目；否则返回nullptr 。

从列表控件中移除的项目将不再由 Qt 管理，需要手动删除。

另请参阅 insertItem()和addItem()。

QRect QListWidget::visualItemRect(const QListWidgetItem *item) const

返回该项在视口内所占的矩形区域，坐标为item 。