PySide6.QtWidgets.QTreeWidgetItemIterator¶

class QTreeWidgetItemIterator¶

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

概要¶

方法¶

def __init__()
def __iter__()
def __next__()
def __iadd__()
def __isub__()
def value()

注意

本文档可能包含从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来过滤掉某些类型的节点。

另请参阅

QTreeWidget 模型/视图编程 QTreeWidgetItem

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

常量	描述
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 – QTreeWidget
flags – IteratorFlag 的组合

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

另请参阅

IteratorFlag

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

Parameters:

项目 – QTreeWidgetItem
flags – IteratorFlag 的组合

为给定的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