Qt模型视图框架：QListWidgetItem

一、描述

QListWidgetItem 代表 QListWidget 中的单个项目。每个项目可以包含多条信息，并将适当地显示它们。

当继承 QListWidgetItem 以提供自定义项时，需要请确保在构造函数中使用等于或大于 UserType 的新类型值调用基类构造函数。

---

二、类型成员

1、enum QListWidgetItem::ItemType：此枚举描述用于描述列表小部件项的类型。

• Type：列表小部件项目的默认类型。
• UserType：自定义类型的最小值。 低于 UserType 的值由 Qt 保留。

---

三、成员函数

1、QBrush background() / void setBackground(const QBrush &brush)

背景画刷。

2、Qt::CheckState checkState() / void setCheckState(Qt::CheckState state)

选中状态。

enum Qt::CheckState

• Qt::Unchecked：该项未选中。
• Qt::PartiallyChecked：项目被部分选中。 如果检查了部分而非全部子项的情况。
• Qt::Checked：项目被选中。

3、QListWidgetItem * clone()

创建项目的副本。

4、QVariant data(int role) / void setData(int role, const QVariant &value)

角色的项目数据。如果需要额外的角色或某些角色的特殊行为，请重新实现此功能。

5、Qt::ItemFlags flags() / void setFlags(Qt::ItemFlags flags)

返回此项目的项目标志。

enum Qt::ItemFlag

• Qt::NoItemFlags：没有设置属性。
• Qt::ItemIsSelectable：可以选择的。
• Qt::ItemIsEditable：可以编辑的。
• Qt::ItemIsDragEnabled：可以拖动。
• Qt::ItemIsDropEnabled：可以放下。
• Qt::ItemIsUserCheckable：可以被用户选中或取消选中。
• Qt::ItemIsEnabled：用户可以与项目进行交互。
• Qt::ItemIsAutoTristate：项的状态取决于其子项的状态。这可以自动管理 QTreeWidget 中父项的状态（如果所有子项都被选中，则选中，如果所有子项都未选中，则取消选中，或者如果只选中一些子项，则部分选中）。
• Qt::ItemNeverHasChildren：该项目没有子项目。
• Qt::ItemIsUserTristate：可以在三个独立的状态之间循环。

6、QBrush foreground() / void setForeground(const QBrush &brush)

前景画刷。

7、void setIcon(const QIcon &icon) / QIcon icon()

图标。

8、void setHidden(bool hide) / bool isHidden() 

是否隐藏。

9、bool isSelected() / void setSelected(bool select)

是否选中。

10、QListWidget * listWidget()

所属的QListWidget。

11、void setStatusTip(const QString &statusTip)

将列表项的状态提示设置为 statusTip 指定的文本。需要启用 QListWidget setMouseTracking(true)才能使用此功能。

12、void setToolTip(const QString &toolTip)

将列表项的工具提示设置为工具提示指定的文本。