一、描述
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)
将列表项的工具提示设置为工具提示指定的文本。