PySide6.QtWidgets.QTreeWidgetItemIterator

class QTreeWidgetItemIterator

QTreeWidgetItemIterator 类提供了一种遍历 QTreeWidget 实例中项目的方法。更多

概要

方法

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题,您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

警告

本节包含从C++自动翻译到Python的代码片段,可能包含错误。

迭代器将以先序遍历的顺序遍历项目,因此在继续到子节点之前访问父节点。

例如,以下代码示例遍历树中的每个项目,检查第一列中的文本是否与用户指定的搜索字符串匹配:

it = QTreeWidgetItemIterator(treeWidget)
while it:
    if (it).text(0) == itemText:
        (it).setSelected(True)
    it += 1

也可以通过向QTreeWidgetItemIterator的构造函数传递某些flags来过滤掉某些类型的节点。

class IteratorFlag

(继承自 enum.Flag) 这些标志可以传递给 QTreeWidgetItemIterator 构造函数(如果使用多个标志,则可以将它们按位或运算),以便迭代器仅迭代与给定标志匹配的项。

常量

描述

QTreeWidgetItemIterator.All

QTreeWidgetItemIterator.Hidden

QTreeWidgetItemIterator.NotHidden

QTreeWidgetItemIterator.Selected

QTreeWidgetItemIterator.Unselected

QTreeWidgetItemIterator.Selectable

QTreeWidgetItemIterator.不可选择

QTreeWidgetItemIterator.DragEnabled

QTreeWidgetItemIterator.DragDisabled

QTreeWidgetItemIterator.DropEnabled

QTreeWidgetItemIterator.DropDisabled

QTreeWidgetItemIterator.HasChildren

QTreeWidgetItemIterator.NoChildren

QTreeWidgetItemIterator.Checked

QTreeWidgetItemIterator.NotChecked

QTreeWidgetItemIterator.Enabled

QTreeWidgetItemIterator.Disabled

QTreeWidgetItemIterator.Editable

QTreeWidgetItemIterator.不可编辑

QTreeWidgetItemIterator.UserFlag

__init__(it)
Parameters:

QTreeWidgetItemIterator

为与it相同的QTreeWidget构造一个迭代器。当前迭代器项设置为指向it的当前项。

__init__(widget[, flags=QTreeWidgetItemIterator.IteratorFlag.All])
Parameters:

为给定的widget构造一个迭代器,该迭代器使用指定的flags来确定在迭代过程中找到哪些项目。迭代器被设置为指向小部件中包含的第一个顶级项目,如果顶级项目与标志不匹配,则指向下一个匹配的项目。

另请参阅

IteratorFlag

__init__(item[, flags=QTreeWidgetItemIterator.IteratorFlag.All])
Parameters:

为给定的item构造一个迭代器,该迭代器使用指定的flags来确定在迭代过程中找到哪些项目。迭代器被设置为指向item,或者如果item不匹配标志,则指向下一个匹配的项目。

另请参阅

IteratorFlag

__iter__()
Return type:

对象

__next__()
Return type:

对象

__iadd__(n)
Parameters:

n – 整数

Return type:

QTreeWidgetItemIterator

使迭代器向前移动n个匹配项。(如果n为负数,则迭代器向后移动。)

如果当前项超出最后一项,当前项指针将设置为None。返回结果迭代器。

__isub__(n)
Parameters:

n – 整数

Return type:

QTreeWidgetItemIterator

使迭代器向后移动n个匹配项。(如果n为负数,则迭代器向前移动。)

如果当前项在最后一项之前,当前项指针被设置为None。返回结果迭代器。

value()
Return type:

QTreeWidgetItem