Qt：QListWidgetItem

0、说明

一个QListWidgetItem是QListWidget中的一项（一行）。

每个Item都可以持有多部分的信息，并将它们在适当时候展示出来。

在构造一个Item时指明它所在的List Widget，这个Item就会自动被插入到List中：

new QListWidgetItem(tr("Hazel"), listWidget);

也可以不指明List Widget，之后调用QListWidget::insertItem()手动插入List。

通常使用text()和icon()查看在List中展示一个Item的文本和图标，这两项是通过setText()和setIcon()进行设置的。文本属性是通过setFont()、setForeground()、setBackground()进行设置的。List中的Items通过setTextAlignment()进行对齐。工具提示（Tooltips）和状态提示（Status tips）通过setToolTip()、setStatusTip()进行设置。

默认情况下，Item是启用的、可选的、可检查的，并且可以进行拖放。

每个Item的标志可以通过调用setFlags()时传入合适的参数（参考Qt::ItemFlags）。

isHidden()函数可以判断Item是否被隐藏，为了隐藏一个Item，可以调用setHidden()。

1、模块和加载项

Header:	#include <QListWidgetItem>
qmake:	QT += widgets

2、构造

QListWidgetItem(QListWidgetItem other)	另一个Item的副本
QListWidgetItem(QIcon icon, QString text, QListWidget *parent = nullptr, int type = Type)	构造一个空Item，指定它显示的icon和text
QListWidgetItem(QString text, QListWidget *parent = nullptr, int type = Type)	构造一个空Item，指定它显示的text
QListWidgetItem(QListWidget *parent = nullptr, int type = Type)	构造一个空Item

 

3、静态字段

enum

ItemType { Type, UserType }

Item的类型

 

Constant	Value	Description
QListWidgetItem::Type	0	The default type for list widget items.
QListWidgetItem::UserType	1000	The minimum value for custom types. Values below UserType are reserved by Qt.

6、实例方法

返回值类型	方法	说明
QBrush	background()	Item的背景色
Qt::CheckState	checkState()	Check State
virtual QVariant	data(int role)	返回给定Role下的Item的数据
Qt::ItemFlags	flags()	Item的flag，Qt::ItemFlags
QFont	font()	显示的字体
QBrush	foreground()	字体颜色
QIcon	icon()	Icon
bool	isHidden()	该Item是否隐藏
bool	isSelected()	是否可选
QListWidget *	listWidget()	Item所在的QListWidget
void	setBackground(const QBrush &brush)	设置背景色
	setCheckState(Qt::CheckState state)	设置Check State
	setData(int role, const QVariant &value)	设置Item中的数据，为给定的Role设置给定的Value
	setFlags(Qt::ItemFlags flags)	设置Item flags
	setFont(const QFont &font)	设置字体
	setForeground(const QBrush &brush)	设置字体颜色
	setHidden(bool hide)	是否隐藏该Item
	setIcon(const QIcon &icon)	设置Icon
	setSelected(bool select)	设置是否可选
	setSizeHint(const QSize &size)	设置Item的size hint（没有用到过）
	setStatusTip(const QString &statusTip)	设置状态提示
	setText(const QString &text)	设置显示文本
	setTextAlignment(int alignment)	对齐
	setToolTip(const QString &toolTip)	设置工具提示
	setWhatsThis(const QString &whatsThis)	设置帮助
QSize	sizeHint()	返回Size Hint
QString	statusTip()	返回状态提示
QString	text()	返回显示文本
int	textAlignment()	返回文本对齐
QString	toolTip()	返回工具提示
int	type()	返回Item的Type
QString	whatsThis()	返回该Item的帮助