QListWidgetItem Class

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

成员函数文档

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

用给定的parent 构建一个指定type 的空 list widget 项目。如果未指定parent ，则需要使用QListWidget::insertItem() 将项目插入到列表 widget 中。

此构造函数将项目插入传递给构造函数的父节点模型中。如果模型是排序的，那么插入的行为将是不确定的，因为模型将调用'<' 运算符方法来处理项目，而此时项目尚未构建。为了避免出现不确定的行为，我们建议不要指定父代，而使用QListWidget::insertItem() 。

另请参见 type()。

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

使用给定的text 和parent 构建一个指定type 的空 list widget 项目。如果未指定父对象，则需要使用QListWidget::insertItem() 将项目插入到一个 list widget 中。

该构造函数会将项目插入传递给构造函数的父节点模型中。如果模型是排序的，那么插入的行为将是不确定的，因为模型将调用'<' 运算符方法来处理项目，而此时项目尚未构建。为了避免出现不确定的行为，我们建议不要指定父代，而使用QListWidget::insertItem() 。

另请参见 type()。

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

使用给定的icon 、text 和parent 构建一个指定type 的空 list widget 项目。如果未指定父对象，则需要使用QListWidget::insertItem() 将该项目插入到一个 list widget 中。

该构造函数会将项目插入传递给构造函数的父节点模型中。如果模型是排序的，那么插入的行为将是不确定的，因为模型将调用'<' 运算符方法来处理项目，而此时项目尚未构建。为了避免出现不确定的行为，我们建议不要指定父代，而使用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

返回包含项目的列表 widget。

[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 为 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 mouseTracking 才能使用此功能。

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

void QListWidgetItem::setText(const QString &text)

将列表 widget 项的文本设置为给定的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()。