概述
QListWidget类提供了基于项目的列表小部件。

QListWidget是一个方便的类,类似于QListView提供的列表视图,但使用经典的基于项目的接口来添加和删除项目。QListWidget使用内部模型来管理列表中的每个QListWidgetItem。
对于更灵活的列表视图小部件,请使用具有标准模型的QListView类。
列表小部件的构造方式与其他小部件相同:
QListWidget *listWidget = new QListWidget(this);
列表小部件的selectionMode()确定列表中可以同时选择多少个项目,以及是否可以创建复杂的项目选择。可以使用setSelectionMode()函数进行设置。
有两种方法可以将项目添加到列表中:可以将它们构造为具有列表小部件作为父小部件,也可以构造为没有父小部件,稍后将其添加到列表中。如果在构造项目时已经存在列表小部件,则使用第一种方法更容易:
new QListWidgetItem(tr("Oak"), listWidget);
new QListWidgetItem(tr("Fir"), listWidget);
new QListWidgetItem(tr("Pine"), listWidget);
如果需要在特定位置将新项目插入列表中,则应该构造该项目时不带父小部件。然后应使用insertItem()函数将其放置在列表中。列表小部件将拥有该项目。
QListWidgetItem *newItem = new QListWidgetItem;
newItem->setText(itemText);
listWidget->insertItem(row, newItem);
对于多个项目,可以使用insertItems()。可以使用count()函数获取列表中的项目数。要从列表中删除项目,请使用takeItem()。
可以使用currentItem()找到列表中的当前项目,并使用setCurrentItem()来更改当前项目。用户还可以通过键盘导航或单击不同的项目来更改当前项目。当前项目更改时,会发出currentItemChanged()信号,其中包含新的当前项目和先前的项目。
常用函数
QListWidget的构造函数:
QListWidget(QWidget *parent = nullptr):构造一个QListWidget对象,父对象为parent。
枚举类型:
QListWidget::SelectionMode:用于指定列表项的选择模式,包括NoSelection、SingleSelection、MultiSelection、ExtendedSelection、ContiguousSelection。
常用函数包括但不限于:
void addItem(const QIcon &icon, const QString &text):向列表中添加一个带有图标和文本的项。void addItem(const QString &text):向列表中添加一个只有文本的项。void addItems(const QStringList &lab


214

被折叠的 条评论
为什么被折叠?



