Auf dieser Seite

QTreeWidgetItemIterator Class

Die Klasse „QTreeWidgetItemIterator“ bietet eine Möglichkeit, die Elemente einer „ QTreeWidget “-Instanz zu durchlaufen. Mehr...

Header: #include <QTreeWidgetItemIterator>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets

Öffentliche Typen

enum IteratorFlag { All, Hidden, NotHidden, Selected, Unselected, …, UserFlag }
flags IteratorFlags

Öffentliche Funktionen

QTreeWidgetItemIterator(QTreeWidget *widget, QTreeWidgetItemIterator::IteratorFlags flags = All)
QTreeWidgetItemIterator(QTreeWidgetItem *item, QTreeWidgetItemIterator::IteratorFlags flags = All)
QTreeWidgetItemIterator(const QTreeWidgetItemIterator &it)
~QTreeWidgetItemIterator()
QTreeWidgetItem *operator*() const
QTreeWidgetItemIterator &operator++()
const QTreeWidgetItemIterator operator++(int)
QTreeWidgetItemIterator &operator+=(int n)
QTreeWidgetItemIterator &operator--()
const QTreeWidgetItemIterator operator--(int)
QTreeWidgetItemIterator &operator-=(int n)
QTreeWidgetItemIterator &operator=(const QTreeWidgetItemIterator &it)

Ausführliche Beschreibung

Der Iterator durchläuft die Elemente in der Reihenfolge einer Vorab-Traversierung und besucht somit den übergeordneten Knoten, bevor er zu den untergeordneten Knoten übergeht.

Die folgenden Code-Beispiele durchlaufen beispielsweise jedes Element in einem Baum und vergleichen den Text in der ersten Spalte mit einer benutzerdefinierten Suchzeichenfolge:

QTreeWidgetItemIterator it(treeWidget);
while (*it) {
    if ((*it)->text(0) == itemText)
        (*it)->setSelected(true);
    ++it;
}

Es ist außerdem möglich, bestimmte Knotentypen herauszufiltern, indem bestimmte „ flags “ an den Konstruktor von `QTreeWidgetItemIterator` übergeben werden.

Siehe auch „ QTreeWidget “, „Model/View-Programmierung“ und „ QTreeWidgetItem “.

Dokumentation zu Mitgliedstypen

enum QTreeWidgetItemIterator::IteratorFlag
flags QTreeWidgetItemIterator::IteratorFlags

Diese Flags können an einen Konstruktor von ` QTreeWidgetItemIterator ` übergeben werden (bei Verwendung mehrerer Flags mit „OR“ verknüpft), sodass der Iterator nur die Elemente durchläuft, die den angegebenen Flags entsprechen.

KonstanteWert
QTreeWidgetItemIterator::All0x00000000
QTreeWidgetItemIterator::Hidden0x00000001
QTreeWidgetItemIterator::NotHidden0x00000002
QTreeWidgetItemIterator::Selected0x00000004
QTreeWidgetItemIterator::Unselected0x00000008
QTreeWidgetItemIterator::Selectable0x00000010
QTreeWidgetItemIterator::NotSelectable0x00000020
QTreeWidgetItemIterator::DragEnabled0x00000040
QTreeWidgetItemIterator::DragDisabled0x00000080
QTreeWidgetItemIterator::DropEnabled0x00000100
QTreeWidgetItemIterator::DropDisabled0x00000200
QTreeWidgetItemIterator::HasChildren0x00000400
QTreeWidgetItemIterator::NoChildren0x00000800
QTreeWidgetItemIterator::Checked0x00001000
QTreeWidgetItemIterator::NotChecked0x00002000
QTreeWidgetItemIterator::Enabled0x00004000
QTreeWidgetItemIterator::Disabled0x00008000
QTreeWidgetItemIterator::Editable0x00010000
QTreeWidgetItemIterator::NotEditable0x00020000
QTreeWidgetItemIterator::UserFlag0x01000000

Der Typ `IteratorFlags` ist ein `typedef` für ` QFlags<IteratorFlag>`. Er speichert eine ODER-Kombination von `IteratorFlag`-Werten.

Dokumentation der Mitgliedsfunktionen

[explicit] QTreeWidgetItemIterator::QTreeWidgetItemIterator(QTreeWidget *widget, QTreeWidgetItemIterator::IteratorFlags flags = All)

Erstellt einen Iterator für das angegebene „ widget “, der anhand der angegebenen „ flags “ ermittelt, welche Elemente während der Iteration gefunden werden. Der Iterator wird so gesetzt, dass er auf das erste im Widget enthaltene Element der obersten Ebene zeigt – oder auf das nächste passende Element, falls das Element der obersten Ebene nicht den Flags entspricht.

Siehe auch „ QTreeWidgetItemIterator::IteratorFlag “.

[explicit] QTreeWidgetItemIterator::QTreeWidgetItemIterator(QTreeWidgetItem *item, QTreeWidgetItemIterator::IteratorFlags flags = All)

Erstellt einen Iterator für das angegebene ` item `, der anhand der angegebenen ` flags ` ermittelt, welche Elemente während der Iteration gefunden werden. Der Iterator wird so gesetzt, dass er auf ` item` zeigt – oder auf das nächste passende Element, falls ` item ` nicht mit den Flags übereinstimmt.

Siehe auch QTreeWidgetItemIterator::IteratorFlag.

QTreeWidgetItemIterator::QTreeWidgetItemIterator(const QTreeWidgetItemIterator &it)

Erstellt einen Iterator für denselben „ QTreeWidget “ wie „ it “. Das aktuelle Iterator-Element wird so gesetzt, dass es auf das aktuelle Element von „ it “ verweist.

[noexcept] QTreeWidgetItemIterator::~QTreeWidgetItemIterator()

Löscht den Iterator.

QTreeWidgetItem *QTreeWidgetItemIterator::operator*() const

Dereferenzierungsoperator. Gibt einen Zeiger auf das aktuelle Element zurück.

QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator++()

Der Präfix- ++ -Operator (++it) springt mit dem Iterator zum nächsten passenden Element und gibt eine Referenz auf den resultierenden Iterator zurück. Er setzt den aktuellen Zeiger auf nullptr, wenn das aktuelle Element das letzte passende Element ist.

const QTreeWidgetItemIterator QTreeWidgetItemIterator::operator++(int)

Der Postfix-Operator „++“ (it++) springt mit dem Iterator zum nächsten passenden Element und gibt einen Iterator auf das zuvor aktuelle Element zurück.

QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator+=(int n)

Bewegt den Iterator um n übereinstimmende Elemente vorwärts. (Ist n negativ, bewegt sich der Iterator rückwärts.)

Befindet sich das aktuelle Element jenseits des letzten Elements, wird der Zeiger auf das aktuelle Element auf ` nullptr` gesetzt. Gibt den resultierenden Iterator zurück.

QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator--()

Der Präfixoperator „ -- “ (--it) verschiebt den Iterator zum vorherigen passenden Element und gibt eine Referenz auf den resultierenden Iterator zurück. Er setzt den aktuellen Zeiger auf „ nullptr “, wenn das aktuelle Element das erste passende Element ist.

const QTreeWidgetItemIterator QTreeWidgetItemIterator::operator--(int)

Der Postfix-Operator (it–) macht das vorangehende übereinstimmende Element zum aktuellen Element und gibt einen Iterator auf das zuvor aktuelle Element zurück.

QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator-=(int n)

Lässt den Iterator um n übereinstimmende Elemente rückwärts springen. (Ist n negativ, springt der Iterator vorwärts.)

Befindet sich das aktuelle Element vor dem letzten Element, wird der Zeiger auf das aktuelle Element auf ` nullptr` gesetzt. Gibt den resultierenden Iterator zurück.

QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator=(const QTreeWidgetItemIterator &it)

Zuweisung. Erstellt eine Kopie von „ it “ und gibt einen Verweis auf dessen Iterator zurück.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.