QListWidgetItem 类

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

成员函数文档

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

使用指定的type和给定的parent构建一个空的列表小部件项目。如果没有指定parent，则项目需要使用QListWidget::insertItem()插入到列表小部件中。

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

也请参阅类型()。

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

使用指定的type和给定的text和parent构建一个空的列表小部件项目。

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

也请参阅类型()。

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

使用指定的type和给定的icon，text和parent构建一个空的列表小部件项目。

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

也请参阅类型()。

QListWidgetItem::QListWidgetItem(const QListWidgetItem &other)

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

此函数在重写clone() 时很有用。

也请参阅数据() 和 标志。

[虚拟 noexcept] QListWidgetItem::~QListWidgetItem()

销毁列表项。

QBrush QListWidgetItem::背景() const

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

另请参阅 设置背景() 和 前景。

Qt::CheckState QListWidgetItem::检查状态() const

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

另请参阅 设置检查状态() 和 标志。

[虚拟] QListWidgetItem *QListWidgetItem::clone() const

创建项的确切副本。

[虚拟] QVariant QListWidgetItem::数据(int role) const

返回给定 role 的项数据。如果需要额外角色或特定角色的特殊行为，则重新实现此函数。

另请参阅 Qt::ItemDataRole 和 设置数据。

Qt::ItemFlags QListWidgetItem::标志() const

返回此项的项标志（见 Qt::ItemFlags）。

另请参阅 设置标志()。

QFont QListWidgetItem::字体() const

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

另请参阅 设置字体。

QBrush QListWidgetItem::前景() const

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

另请参阅 设置前景 和 背景。

QIcon QListWidgetItem::图标() const

返回列表项的图标。

另请参阅 设置图标 和 图标大小。

bool QListWidgetItem::isHidden() const

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

另请参阅 设置隐藏。

bool QListWidgetItem::isSelected() const

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

另请参阅 设置选中。

QListWidget *QListWidgetItem::列表部件() const

返回包含项的列表部件。

[虚拟] void QListWidgetItem::read(QDataStream &in)

从流 in 中读取项。

另请参阅 write().

void QListWidgetItem::setBackground(const QBrush &brush)

将列表项的背景画刷设置为指定的 brush。设置默认constructed画刷将使视图使用风格的默认颜色。

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

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

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

另请参阅 checkState().

[虚拟] 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。设置默认constructed画刷将使视图使用风格的默认颜色。

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

void QListWidgetItem::setHidden(bool hide)

如果 hide 为 true，则隐藏项；否则显示项。

另请参阅 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》鼠标跟踪需要启用此功能。

另请参阅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中引入的。

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

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

另请参阅：Qt::Alignment。

QString QListWidgetItem::toolTip() const

返回列表项的工具提示。

另请参阅：setToolTip()，statusTip和whatsThis。

int QListWidgetItem::type() const

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

QString QListWidgetItem::whatsThis() const

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

另请参阅：setWhatsThis()，statusTip和toolTip。

[虚函数] void QListWidgetItem::write(QDataStream &out) const

将项写入流out。

另请参阅：read。

[虚函数] bool QListWidgetItem::operator<(const QListWidgetItem &other) const

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

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

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

此函数在重写clone() 时很有用。

也请参阅数据() 和 标志。