QListWidget 类

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

成员函数文档

[显式] QListWidget::QListWidget(QWidget *parent = nullptr)

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

[虚拟 noexcept] QListWidget::~QListWidget()

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

void QListWidget::addItem(const QString &label)

在列表小部件的末尾插入带文本 label 的项目。

void QListWidget::addItem(QListWidgetItem *item)

在列表小部件的末尾插入 item。

另请参阅 insertItem().

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

另请参阅 supportedDropActions().

void QListWidget::editItem(QListWidgetItem *item)

如果可编辑，开始编辑条目。

[重写虚拟受保护] bool QListWidget::event(QEvent *e)

重新实现了: QListView::event(QEvent *e).

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

使用给定的标志查找与文本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)

在列表小部件的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().

[信号] void QListWidget::itemActivated(QListWidgetItem *item)

当item被激活时，会发出此信号。当用户单击或双击该项时，该项将被激活，这取决于系统配置。当用户按下激活键（在Windows和X11上这是返回键，在Mac OS X上这是Command+O）时，也会被激活。

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

返回coords为p的项的指针。坐标相对于列表小部件的可视窗口。

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

这是一个重载函数。

返回coords为(x，y)的项的指针。坐标相对于列表小部件的可视窗口。

[信号] void QListWidget::itemChanged(QListWidgetItem *item)

当item的数据更改时，会发出此信号。

[信号] void QListWidget::itemClicked(QListWidgetItem *item)

当在组件中的项上单击鼠标按钮时，会发出带有指定item的此信号。

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

[信号] void QListWidget::itemDoubleClicked(QListWidgetItem *item)

当在组件中的项上双击鼠标按钮时，会发出带有指定item的此信号。

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

[信号] void QListWidget::itemEntered(QListWidgetItem *item)

当鼠标光标进入一个项时，会发出此信号。该项item是被进入的项。此信号仅在打开鼠标跟踪或当鼠标光标移动到项内时按下鼠标按钮时发出。

另请参阅QWidget::setMouseTracking。

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

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

[信号] void QListWidget::itemPressed(QListWidgetItem *item)

当在组件中的项上按下鼠标按钮时，会发出带有指定item的此信号。

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

[信号] 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 创建的，则列表为空。

[虚受保护] QMimeData *QListWidget::mimeData(const QList<QListWidgetItem *> &items) const

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

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

[虚受保护] 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)

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

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

设置在给定的item中显示的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对列表控件中的所有项目进行排序。

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

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

另请参阅 Qt::DropActions.

QListWidgetItem *QListWidget::takeItem(int row)

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

从列表视图中移除的项目将由 Qt 管理并需要手动删除。

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

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

返回占据在 item 的视口上的矩形。