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()

销毁列表 widget 及其所有项目。

void QListWidget::addItem(QListWidgetItem *item)

在列表 widget 的末尾插入item 。

另请参阅 insertItem()。

void QListWidget::addItem(const QString &label)

在列表 widget 的末尾插入文本为label 的项目。

void QListWidget::addItems(const QStringList &labels)

在列表 widget 的末尾插入带有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 是当前项目的行。如果没有当前项目， 为-1。currentRow

[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 ，该操作在给定的index 中以给定的action 结束。如果data 和action 可由模型处理，则返回true ；否则返回false 。

另请参阅 supportedDropActions() 。

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)

在row 给定的列表位置插入item 。

另请参阅 addItem() 。

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

在列表 widget 中row 给定的位置插入文本为label 的项目。

另请参阅 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 坐标处的项目的指针。坐标是相对于 list widget 的viewport() 而定的。

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

这是一个重载函数。

返回指向坐标 (x,y) 处项目的指针。坐标是相对于 list widget 的viewport() 而定的。

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

只要item 的数据发生变化，就会发出该信号。

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

当鼠标按钮被点击到 widget 中的某个项目上时，该信号将以指定的item 发送。

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

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

当鼠标按钮被双击到 widget 中的某个项目上时，该信号将以指定的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)

当鼠标按键被按在 widget 中的某个项目上时，该信号将以指定的item 发送。

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

[signal] void QListWidget::itemSelectionChanged()

每当选择发生变化时，就会发出该信号。

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

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

返回在给定的item 中显示的 widget。

另请参阅 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

返回可用于描述 listwidget 项目列表的 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

返回列表 widget 中所有选中项的列表。

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)

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

另请参阅 currentRow() 。

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

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

该函数只能用于在列表 widget 项目中显示静态内容。如果要显示自定义动态内容或实现自定义编辑器部件，请使用QListView 和子类QStyledItemDelegate 。

另请参阅 itemWidget(),removeItemWidget() 和委托类。

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

重实现：QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel).

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

根据指定的order 对列表 widget 中的所有项目排序。

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

返回此视图支持的下拉操作。

另请参阅 Qt::DropActions 。

QListWidgetItem *QListWidget::takeItem(int row)

删除并返回列表 widget 中给定row 中的项目；否则返回nullptr 。

从列表 widget 中移除的项目不会由 Qt 管理，需要手动删除。

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

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

返回位于item 的项目在视口中占据的矩形区域。