QListWidgetItem Class

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

成员函数文档

[explicit] QListWidgetItem::QListWidgetItem(QListWidget *parent = nullptr, int type = Type)

使用给定的parent ，基于指定的type 构建一个空的列表控件项。如果未指定parent ，则需要通过QListWidget::insertItem()将该项插入到列表控件中。

此构造函数将该项插入到传递给构造函数的父对象的模型中。如果模型已按顺序排序，则插入行为将无法确定，因为模型会调用该项的'<' 操作符方法，而此时该项尚未构建完成。为避免这种无法确定的行为，我们建议不要指定父对象，而是使用QListWidget::insertItem()。

另请参阅 type()。

[explicit] QListWidgetItem::QListWidgetItem(const QString &text, QListWidget *parent = nullptr, int type = Type)

根据指定的type ，并使用给定的text 和parent ，构建一个空的列表控件项。如果未指定父控件，则需要通过QListWidget::insertItem()将该项插入到列表控件中。

此构造函数将该项插入到传递给构造函数的父对象的模型中。如果模型已排序，则插入行为将无法确定，因为模型会调用该项的'<' 运算符方法，而此时该项尚未构建完成。为避免这种无法确定的行为，建议不要指定父对象，而改用QListWidget::insertItem()。

另请参阅 type()。

[explicit] QListWidgetItem::QListWidgetItem(const QIcon &icon, const QString &text, QListWidget *parent = nullptr, int type = Type)

根据指定的type ，使用给定的icon 、text 和parent 构建一个空的列表控件项。如果未指定父控件，则需要通过QListWidget::insertItem()将该项插入到列表控件中。

该构造函数将该项插入到传递给构造函数的父项的模型中。如果模型已排序，则插入行为将无法确定，因为模型会调用该项的'<' 运算符方法，而此时该项尚未构建完成。为避免这种无法确定的行为，我们建议不要指定父项，而是使用QListWidget::insertItem()。

另请参阅 type()。

QListWidgetItem::QListWidgetItem(const QListWidgetItem &other)

构建other 的副本。请注意，type()和listWidget()不会被复制。

在重写clone() 时，此函数非常有用。

另请参阅 data() 和flags()。

[virtual noexcept] QListWidgetItem::~QListWidgetItem()

删除该列表项。

QBrush QListWidgetItem::background() const

返回用于显示列表项背景的画笔。

另请参阅 setBackground() 和foreground()。

Qt::CheckState QListWidgetItem::checkState() const

返回列表项的选中状态（参见Qt::CheckState ）。

另请参阅 setCheckState() 和flags()。

[virtual] QListWidgetItem *QListWidgetItem::clone() const

创建该项目的精确副本。

[virtual] QVariant QListWidgetItem::data(int role) const

返回给定role 对应项的数据。若需要额外角色或针对特定角色实现特殊行为，请重写此函数。

另请参阅 Qt::ItemDataRole 和setData()。

Qt::ItemFlags QListWidgetItem::flags() const

返回该项目的标志（参见Qt::ItemFlags ）。

另请参阅 setFlags()。

QFont QListWidgetItem::font() const

返回用于显示此列表项文本的字体。

另请参阅 setFont()。

QBrush QListWidgetItem::foreground() const

返回用于显示列表项的前景（例如文本）的画笔。

另请参阅 setForeground() 和background()。

QIcon QListWidgetItem::icon() const

返回列表项的图标。

另请参阅 setIcon() 和iconSize 。

bool QListWidgetItem::isHidden() const

如果该项被隐藏，则返回true ；否则返回false 。

另请参阅 setHidden()。

bool QListWidgetItem::isSelected() const

如果该项目被选中，则返回true ；否则返回false 。

另请参阅 setSelected()。

QListWidget *QListWidgetItem::listWidget() const

返回包含该项目的列表控件。

[virtual] void QListWidgetItem::read(QDataStream &in)

从流in 中读取项目。

另请参阅 write()。

void QListWidgetItem::setBackground(const QBrush &brush)

将列表项的背景画笔设置为给定的brush 。设置一个通过默认构造器构造的画笔将使视图使用样式中的默认颜色。

另请参阅 background() 和setForeground()。

void QListWidgetItem::setCheckState(Qt::CheckState state)

将列表项的选中状态设置为state 。

另请参阅 checkState()。

[virtual] void QListWidgetItem::setData(int role, const QVariant &value)

将指定role 的数据设置为给定的value 。如果需要为某些角色添加额外角色或实现特殊行为，请重写此函数。

另请参阅 Qt::ItemDataRole 和data()。

void QListWidgetItem::setFlags(Qt::ItemFlags flags)

将列表项的标记设置为flags 。

另请参阅 flags() 和Qt::ItemFlags 。

void QListWidgetItem::setFont(const QFont &font)

将绘制该项时使用的字体设置为指定的font 。

另请参阅 font()。

void QListWidgetItem::setForeground(const QBrush &brush)

将列表项的前景画笔设置为指定的brush 。设置一个通过默认构造函数构造的画笔，将使视图使用样式中的默认颜色。

另请参阅 foreground() 和setBackground()。

void QListWidgetItem::setHidden(bool hide)

如果 `hide ` 为真，则隐藏该项目；否则显示该项目。

另请参阅 isHidden()。

void QListWidgetItem::setIcon(const QIcon &icon)

将列表项的图标设置为给定的icon 。

另请参阅 icon()、text() 和iconSize 。

void QListWidgetItem::setSelected(bool select)

将该项的选中状态设置为select 。

另请参阅 isSelected()。

void QListWidgetItem::setSizeHint(const QSize &size)

将列表项的大小提示设置为size 。如果未设置大小提示，或者size 无效，则项委托将根据项数据计算大小提示。

另请参阅 sizeHint()。

void QListWidgetItem::setStatusTip(const QString &statusTip)

将列表项的状态提示设置为由statusTip 指定的文本。QListWidget 需启用 mouseTracking 功能，此功能才能正常工作。

另请参阅 statusTip()、setToolTip()、setWhatsThis() 以及QWidget::setMouseTracking()。

void QListWidgetItem::setText(const QString &text)

将列表控件项的文本设置为给定的text 。

另请参阅 text()。

[since 6.4] void QListWidgetItem::setTextAlignment(Qt::Alignment alignment)

将列表项的文本对齐方式设置为alignment 。

该函数于 Qt 6.4 中引入。

另请参阅 textAlignment()。

void QListWidgetItem::setToolTip(const QString &toolTip)

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

另请参阅 toolTip()、setStatusTip() 和setWhatsThis()。

void QListWidgetItem::setWhatsThis(const QString &whatsThis)

将列表项的“这是什么？”帮助设置为whatsThis 中指定的文本。

另请参阅 whatsThis()、setStatusTip() 和setToolTip()。

QSize QListWidgetItem::sizeHint() const

返回为列表项设置的大小提示。

另请参阅 setSizeHint()。

QString QListWidgetItem::statusTip() const

返回列表项的状态提示。

另请参阅 setStatusTip()。

QString QListWidgetItem::text() const

返回列表项的文本。

另请参阅 setText()。

int QListWidgetItem::textAlignment() const

返回列表项的文本对齐方式。

另请参阅 setTextAlignment() 和Qt::Alignment 。

QString QListWidgetItem::toolTip() const

返回列表项的工具提示。

另请参阅 setToolTip()、statusTip() 和whatsThis()。

int QListWidgetItem::type() const

返回传递给QListWidgetItem 构造函数的类型。

QString QListWidgetItem::whatsThis() const

返回列表项的“这是什么？”帮助文本。

另请参阅 setWhatsThis()、statusTip()、以及toolTip()。

[virtual] void QListWidgetItem::write(QDataStream &out) const

将该项写入流out 。

另请参阅 read()。

[virtual] bool QListWidgetItem::operator<(const QListWidgetItem &other) const

如果该项的文本小于other 项的文本，则返回true ；否则返回false 。

QListWidgetItem &QListWidgetItem::operator=(const QListWidgetItem &other)

将other 的数据和标志赋值给此项。请注意，type()和listWidget()不会被复制。

在重写clone() 时，此函数非常有用。

另请参阅 data() 和flags()。