QTreeWidgetItem Class

    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"));

成员函数文档

[explicit] QTreeWidgetItem::QTreeWidgetItem(int type = Type)

构建一个指定type 的树状 widget 项目。该项目必须插入到树状 widget 中。

另请参阅 type().

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

构建一个指定type 的树状 widget 项目，并将其附加到给定parent 中的项目。

另请参阅 type() 。

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

构建一个树状 widget 项目并将其附加到给定的parent 中。

另请参阅 type() 。

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

构建一个指定type 的树状 widget 项目。项目必须插入到树状 widget 中。给定的strings 列表将被设置为项目中每一列的项目文本。

另请参见 type().

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

为指定的type 构建一个树形 widget 项，并将其插入到给定的parent 中的preceding 项之后。

另请参阅 type().

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

构建一个指定type 的树形 widget 项目，并将其附加到给定parent 中的项目。给定的strings 列表将被设置为项目中每一列的项目文本。

另请参阅 type()。

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

为指定的type 构建一个树形 widget 项目，该项目将插入到parent 的preceding 子项目之后。

另请参阅 type().

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

构建一个树形 widget 项目，并将其附加到给定的parent 中。给定的strings 列表将被设置为项目中每一列的项目文本。

另请参阅 type() 。

QTreeWidgetItem::QTreeWidgetItem(const QTreeWidgetItem &other)

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

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

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

[virtual noexcept] QTreeWidgetItem::~QTreeWidgetItem()

销毁此树部件项目。

该项目将从QTreeWidgets 中删除。这样就可以随时安全地删除项目。

void QTreeWidgetItem::addChild(QTreeWidgetItem *child)

将child 项目添加到子项目列表中。

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

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

将给定的children 列表添加到项目中。

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

QBrush QTreeWidgetItem::background(int column) const

返回用于渲染指定column 背景的笔刷。

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

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

返回给定column 中标签的校验状态。

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

QTreeWidgetItem *QTreeWidgetItem::child(int index) const

返回项目子代列表中位于给定index 处的项目。

另请参阅 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

返回项目column 和role 的值。

另请参阅 setData() 。

[protected] void QTreeWidgetItem::emitDataChanged()

使与此项目关联的模型发出此项目的dataChanged() 信号。

通常只有在子类化了QTreeWidgetItem 并重新实现了data() 和/或setData() 时才需要调用此函数。

另请参阅 setData()。

Qt::ItemFlags QTreeWidgetItem::flags() const

返回用于描述项目的标志。这些标志决定了是否可以检查、编辑和选择项目。

flags 的默认值是Qt::ItemIsSelectable |Qt::ItemIsUserCheckable |Qt::ItemIsEnabled |Qt::ItemIsDragEnabled |Qt::ItemIsDropEnabled 。

另请参阅 setFlags() 。

QFont QTreeWidgetItem::font(int column) const

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

另请参阅 setFont()。

QBrush QTreeWidgetItem::foreground(int column) const

返回用于渲染指定column 的前景（如文本）的笔刷。设置默认构建的笔刷将使视图使用样式中的默认颜色。

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

QIcon QTreeWidgetItem::icon(int column) const

返回指定column 中显示的图标。

另请参阅 setIcon() 和iconSize 。

int QTreeWidgetItem::indexOfChild(QTreeWidgetItem *child) const

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

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

在子代列表index 插入child 项目。

如果该子项目已插入其他地方，则不会再次插入。

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

将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()。

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

从数据流in 中读取项目。这只能将数据读入单个项目。

另请参阅 write() 。

void QTreeWidgetItem::removeChild(QTreeWidgetItem *child)

删除child 所指示的给定项目。删除的项目不会被删除。

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

将给定column 中标签的背景刷设置为指定的brush 。设置默认构建的刷子会让视图使用样式中的默认颜色。

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

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

将给定column 检查状态中的项目设置为state 。

另请参阅 checkState() 。

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

设置项目指示器policy 。该策略决定何时显示树枝展开/折叠指示符。默认值为DontShowIndicatorWhenChildless 。

另请参阅 childIndicatorPolicy() 。

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

将项目column 和role 的值设置为给定的value 。

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

另请参阅 data() 。

void QTreeWidgetItem::setDisabled(bool disabled)

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

另请参阅 isDisabled() 和setFlags()。

void QTreeWidgetItem::setExpanded(bool expand)

如果expand 为 true，则扩展项目，否则折叠项目。

另请参阅 isExpanded() 。

void QTreeWidgetItem::setFirstColumnSpanned(bool span)

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

另请参阅 isFirstColumnSpanned().

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

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

另请参阅 flags() 。

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

将column 中用于显示文本的字体设置为font 。

另请参阅 font()、setText() 和setForeground()。

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

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

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

void QTreeWidgetItem::setHidden(bool hide)

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

另请参阅 isHidden().

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

将在给定的column 中显示的图标设置为icon 。

另请参阅 icon(),setText() 和iconSize 。

void QTreeWidgetItem::setSelected(bool select)

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

另请参阅 isSelected() 。

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

在给定的column 中为树项设置大小提示，即size 。如果未设置尺寸提示或size 无效，则项目委托将根据项目数据计算尺寸提示。

另请参阅 sizeHint() 。

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

将给定column 的状态提示设置为给定的statusTip 。QTreeWidget 需要启用鼠标跟踪功能才能使用此功能。

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

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

将column 中要显示的文本设置为text 。

另请参阅 text()、setFont() 和setForeground()。

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

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

此函数在 Qt 6.4 中引入。

另请参阅 textAlignment().

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

将给定的column 的工具提示设置为toolTip 。

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

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

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

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

QSize QTreeWidgetItem::sizeHint(int column) const

返回给定column 中树项的尺寸提示集（参见QSize ）。

另请参阅 setSizeHint().

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

使用给定的order ，按给定的column 中的值对项目的子代排序。

QString QTreeWidgetItem::statusTip(int column) const

返回给定column 内容的状态提示。

另请参阅 setStatusTip() 。

QTreeWidgetItem *QTreeWidgetItem::takeChild(int index)

删除index 中的项目并返回，否则返回 0。

QList<QTreeWidgetItem *> QTreeWidgetItem::takeChildren()

移除子代列表并返回，否则返回空列表。

QString QTreeWidgetItem::text(int column) const

返回指定column 中的文本。

另请参阅 setText()。

int QTreeWidgetItem::textAlignment(int column) const

返回给定column 中标签的文本对齐方式。

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

QString QTreeWidgetItem::toolTip(int column) const

返回给定column 的工具提示。

另请参阅 setToolTip() 。

QTreeWidget *QTreeWidgetItem::treeWidget() const

返回包含项目的树状部件。

int QTreeWidgetItem::type() const

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

QString QTreeWidgetItem::whatsThis(int column) const

返回给定column 内容的 "这是什么？"帮助。

另请参阅 setWhatsThis()。

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

将项目写入数据流out 。这只会写入单个项目的数据。

另请参阅 read() 。

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

如果项目中的文字少于other 项目中的文字，则返回true ，否则返回false 。

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

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

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

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