QTreeWidgetItem 类

    QTreeWidgetItem *cities = new QTreeWidgetItem(treeWidget);
    cities->setText(0, tr("Cities"));
    QTreeWidgetItem *osloItem = new QTreeWidgetItem(cities);
    osloItem->setText(0, tr("Oslo"));
    osloItem->setText(1, tr("Yes"));

    QTreeWidgetItem *planets = new QTreeWidgetItem(treeWidget, cities);
    planets->setText(0, tr("Planets"));

成员函数文档

[显式] QTreeWidgetItem::QTreeWidgetItem(int type = Type)

构造一个指定 类型 的树小部件项。项目必须插入到树小部件中。

另请参阅type()。

[显式] QTreeWidgetItem::QTreeWidgetItem(const QStringList &strings, int type = Type)

构造一个指定 类型 的树小部件项。项目必须插入到树小部件中。给定的字符串列表将设置为一项中每个列的项文本。

另请参阅type()。

[显式] QTreeWidgetItem::QTreeWidgetItem(QTreeWidget *parent, int type = Type)

构造一个指定 类型 的树小部件项，并将其追加到给定的 父 中的项。

另请参阅type()。

QTreeWidgetItem::QTreeWidgetItem(QTreeWidget *parent, const QStringList &strings, int type = Type)

构造一个指定 类型 的树小部件项，并将其追加到给定的 父 中的项目。给定的字符串列表将设置为项目文本，供每个列使用。

另请参阅type()。

QTreeWidgetItem::QTreeWidgetItem(QTreeWidget *parent, QTreeWidgetItem *preceding, int type = Type)

构造一个指定 类型 的树小部件项，并将其插入到给定的 父 中，紧随指定 前一个项目 之后。

另请参阅type()。

[显式] QTreeWidgetItem::QTreeWidgetItem(QTreeWidgetItem *parent, int type = Type)

构造一个树小部件项并将其追加到给定的 父。

另请参阅type()。

QTreeWidgetItem::QTreeWidgetItem(QTreeWidgetItem *parent, const QStringList &strings, int type = Type)

构建一个树形小部件项并将其添加到指定的 父元素。给定的字符串列表将被设置为项文本，每个列。

另请参阅type()。

QTreeWidgetItem::QTreeWidgetItem(QTreeWidgetItem *parent, QTreeWidgetItem *preceding, int type = Type)

构建一个指定 类型 的树形小部件项，并将其插入到 父元素 中 先前 子元素之后。

另请参阅type()。

QTreeWidgetItem::QTreeWidgetItem(const QTreeWidgetItem &other)

构建 其他 的副本。注意，类型() 和 treeWidget() 不会被复制。

此函数在重新实现 clone() 时非常有用。

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

[虚函数 noexcept] QTreeWidgetItem::~QTreeWidgetItem()

销毁此树形小部件项。

项将被从其已添加到的所有 QTreeWidget 中移除。这使得在任何时候删除项都安全。

void QTreeWidgetItem::addChild(QTreeWidgetItem *child)

将 子元素 添加到子元素列表中。

另请参阅insertChild() 和 takeChild().

void QTreeWidgetItem::addChildren(const QList<QTreeWidgetItem *> &children)

将给定的 子元素 列表添加到项中。

另请参阅insertChildren() 和 takeChildren().

QBrush QTreeWidgetItem::background(int column) const

返回用于渲染指定 列 背景 的画刷。

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

Qt::CheckState QTreeWidgetItem::checkState(int column) const

返回给定 列 中标签的复选状态。

另请参阅setCheckState() 和 Qt::CheckState.

QTreeWidgetItem *QTreeWidgetItem::child(int index) const

返回在项的子元素列表中给定 索引 的项。

另请参阅parent().

int QTreeWidgetItem::childCount() const

返回子项的数量。

QTreeWidgetItem::ChildIndicatorPolicy QTreeWidgetItem::childIndicatorPolicy() const

返回项指示策略。此策略决定了何时显示树分支展开/折叠指示器。

另请参阅setChildIndicatorPolicy().

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

创建项及其子项的深度副本。

int QTreeWidgetItem::columnCount() const

返回项中的列数。

[virtual] QVariant QTreeWidgetItem::data(int column, int role) const

返回项的列和角色的值。

另请参阅setData。

[protected] void QTreeWidgetItem::emitDataChanged()

导致与该项关联的模型对此项发出一个dataChanged()信号。

通常，您只需要在此项为QTreeWidgetItem派生类时重新实现data()和/或setData()。

另请参阅setData。

Qt::ItemFlags QTreeWidgetItem::flags() const

返回描述项的标记。这决定了项是否可以选中、编辑和选择。

标记的默认值为Qt::ItemIsSelectable | Qt::ItemIsUserCheckable | Qt::ItemIsEnabled | Qt::ItemIsDragEnabled | Qt::ItemIsDropEnabled。

另请参阅setFlags。

QFont QTreeWidgetItem::font(int column) const

返回用于渲染指定列中文本的字体。

另请参阅setFont。

QBrush QTreeWidgetItem::foreground(int column) const

返回用于渲染指定列的前景（例如文本）的画笔。设置一个默认构造的画笔将让视图使用默认颜色。

另请参阅setForeground()和background。

QIcon QTreeWidgetItem::icon(int column) const

返回在指定列中显示的图标。

另请参阅setIcon()和iconSize。

int QTreeWidgetItem::indexOfChild(QTreeWidgetItem *child) const

返回给定child在项的子项列表中的索引。

void QTreeWidgetItem::insertChild(int index, QTreeWidgetItem *child)

在子项列表中将 子项 插入到下标 index 处。

如果子项已经被插入到其他地方，则不会再次插入。

void QTreeWidgetItem::insertChildren(int index, const QList<QTreeWidgetItem *> &children)

将给定的子项列表插入到项的子项列表中的下标 index 处。

已经在其他位置插入的子项不会再次插入。

bool QTreeWidgetItem::isDisabled() const

如果项被禁用，则返回 true；否则返回 false。

另请参阅setFlags。

bool QTreeWidgetItem::isExpanded() const

如果项被展开，则返回 true，否则返回 false。

另请参阅setExpanded。

bool QTreeWidgetItem::isFirstColumnSpanned() const

如果项跨越了行中的所有列，则返回 true；否则返回 false。

另请参阅setFirstColumnSpanned。

bool QTreeWidgetItem::isHidden() const

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

另请参阅setHidden。

bool QTreeWidgetItem::isSelected() const

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

另请参阅setSelected。

QTreeWidgetItem *QTreeWidgetItem::parent() const

返回项的父项。

另请参阅child。

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

从流 in 中读取项。此操作只读取单个项的数据。

另请参阅write。

void QTreeWidgetItem::removeChild(QTreeWidgetItem *child)

移除由 child 指示的给定项。移除的项不会被删除。

void QTreeWidgetItem::setBackground(int column, const QBrush &brush)

将给定列的标签的背景画笔设置为指定的 brush。设置默认构造的画笔将让视图使用样式中的默认颜色。

另请参阅background() 和 setForeground。

void QTreeWidgetItem::setCheckState(int column, Qt::CheckState state)

将给定列中的项的复选框状态设置为指定的状态。

另请参阅checkState。

void QTreeWidgetItem::setChildIndicatorPolicy(QTreeWidgetItem::ChildIndicatorPolicy policy)

设置项指示器策略。此策略决定了树分支展开/折叠指示器何时显示。默认值是DontShowIndicatorWhenChildless。

另请参阅childIndicatorPolicy。

[虚拟] void QTreeWidgetItem::setData(int column, int role, const QVariant &value)

将给定列和角色的值设置项为指定的值。

role描述了value指定的数据类型，由Qt::ItemDataRole枚举定义。

另请参阅data。

void QTreeWidgetItem::setDisabled(bool disabled)

如果disabled为真，则禁用项；否则启用项。

另请参阅isDisabled和setFlags。

void QTreeWidgetItem::setExpanded(bool expand)

如果expand为真，则展开项；否则折叠项。

另请参阅isExpanded。

void QTreeWidgetItem::setFirstColumnSpanned(bool span)

如果span为真，则将第一部分设置为跨所有列；否则显示所有项部分。

另请参阅isFirstColumnSpanned。

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

将项的标志设置为给定的flags。这些确定是否可以选择或修改项。这通常用于禁用项。

另请参阅flags。

void QTreeWidgetItem::setFont(int column, const QFont &font)

将用于显示给定列文本的字体设置为指定的字体。

另请参阅font，setText和setForeground。

void QTreeWidgetItem::setForeground(int column, const QBrush &brush)

将给定列中标签的前景笔刷设置为指定的笔刷。

另请参阅 foreground() 和 setBackground。

void QTreeWidgetItem::setHidden(bool hide)

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

另请参阅 isHidden。

void QTreeWidgetItem::setIcon(int column, const QIcon &icon)

将给定列中显示的图标设置为指定的 icon。

另请参阅 icon，setText 和 iconSize。

void QTreeWidgetItem::setSelected(bool select)

将项目的选择状态设置为 select。

另请参阅 isSelected。

void QTreeWidgetItem::setSizeHint(int column, const QSize &size)

将给定列中树项的大小提示设置为指定的 size。如果没有设置大小提示或 size 无效，则项代理将根据项数据计算大小提示。

另请参阅 sizeHint。

void QTreeWidgetItem::setStatusTip(int column, const QString &statusTip)

将给定列的状态提示设置为指定的 statusTip。若要使用此功能，QTreeWidget 的鼠标跟踪必须启用。

另请参阅 statusTip，setToolTip 和 setWhatsThis。

void QTreeWidgetItem::setText(int column, const QString &text)

将给定列中显示的文本设置为指定的 text。

另请参阅 text，setFont 和 setForeground。

[since 6.4] void QTreeWidgetItem::setTextAlignment(int column, Qt::Alignment alignment)

将给定列中标签的文本对齐设置为指定的 alignment。

此函数自 Qt 6.4 起引入。

void QTreeWidgetItem::setToolTip(int column, const QString &toolTip)

为指定的 列 设置工具提示为 toolTip。

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

void QTreeWidgetItem::setWhatsThis(int column, const QString &whatsThis)

将指定 列 的 "这是什么？" 帮助设置为 whatsThis。

另请参阅 whatsThis，setStatusTip 和 setToolTip。

QSize QTreeWidgetItem::sizeHint(int column) const

返回在指定 列 中为树项设置的尺寸提示（参见 QSize）。

另请参阅 setSizeHint。

void QTreeWidgetItem::sortChildren(int column, Qt::SortOrder order)

使用给定的 order 和 列 中的值对项的子项进行排序。

QString QTreeWidgetItem::statusTip(int column) const

返回指定 列 的内容的状态提示。

另请参阅 setStatusTip。

QTreeWidgetItem *QTreeWidgetItem::takeChild(int index)

删除索引为 index 的项并返回它，否则返回 0。

QList<QTreeWidgetItem *> QTreeWidgetItem::takeChildren()

删除子项列表并返回它，否则返回空列表。

QString QTreeWidgetItem::text(int column) const

返回指定 列 中的文本。

另请参阅 setText。

int QTreeWidgetItem::textAlignment(int column) const

返回给定 列 中标签的文字对齐方式。

另请参阅 Qt::Alignment。

QString QTreeWidgetItem::toolTip(int column) const

返回指定 列 的工具提示。

另请参阅 setToolTip。

QTreeWidget *QTreeWidgetItem::treeWidget() const

返回包含项的树形控件。

int QTreeWidgetItem::type() const

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

QString QTreeWidgetItem::whatsThis(int column) const

返回给定列内容的"这是什么?"帮助信息。

另请参阅setWhatsThis().

[虚拟] void QTreeWidgetItem::write(QDataStream &out) const

将项目写入流out。这仅写入来自单个项目的数据。

另请参阅read().

[虚拟] bool QTreeWidgetItem::operator<(const QTreeWidgetItem &other) const

如果项目的文本小于其他项目的文本，则返回true，否则返回false。

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

将其他的数据和标志分配给此项目。请注意，type()和treeWidget()不会复制。

此函数在重新实现 clone() 时非常有用。

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