QTreeWidgetItemIterator Class

Die Klasse QTreeWidgetItemIterator bietet eine Möglichkeit, über die Elemente in einer QTreeWidget Instanz zu iterieren. Mehr...

Kopfzeile: #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)

Detaillierte Beschreibung

Der Iterator durchläuft die Elemente in einer vorher festgelegten Reihenfolge, d.h. er besucht den übergeordneten Knoten , bevor er zu den untergeordneten Knoten übergeht.

Im folgenden Beispiel wird jedes Element in einem Baum durchlaufen, wobei der Text in der ersten Spalte mit einer benutzerdefinierten Suchzeichenfolge verglichen wird:

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

Es ist auch möglich, bestimmte Knotentypen herauszufiltern, indem bestimmte flags an den Konstruktor von QTreeWidgetItemIterator übergeben werden.

Siehe auch QTreeWidget, Model/View Programmierung, und QTreeWidgetItem.

Dokumentation der Mitgliedstypen

enum QTreeWidgetItemIterator::IteratorFlag
flags QTreeWidgetItemIterator::IteratorFlags

Diese Flags können an einen QTreeWidgetItemIterator Konstruktor übergeben werden (ODER-verknüpft, wenn mehr als einer verwendet wird), so dass der Iterator nur über Elemente iteriert, 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)

Konstruiert einen Iterator für das angegebene widget, der die angegebene flags verwendet, um zu bestimmen, welche Elemente während der Iteration gefunden werden. Der Iterator wird so gesetzt, dass er auf das erste Element der obersten Ebene zeigt, das im Widget enthalten ist, oder auf das nächste passende Element, wenn das Element der obersten Ebene nicht mit den Flags übereinstimmt.

Siehe auch QTreeWidgetItemIterator::IteratorFlag.

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

Konstruiert einen Iterator für die angegebene item, der die angegebene flags verwendet, um zu bestimmen, 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, wenn item nicht mit den Flags übereinstimmt.

Siehe auch QTreeWidgetItemIterator::IteratorFlag.

QTreeWidgetItemIterator::QTreeWidgetItemIterator(const QTreeWidgetItemIterator &it)

Konstruiert einen Iterator für dieselbe QTreeWidget wie it. Das aktuelle Iterator-Element wird so eingestellt, dass es auf das aktuelle Element von it zeigt.

[noexcept] QTreeWidgetItemIterator::~QTreeWidgetItemIterator()

Zerstört den Iterator.

QTreeWidgetItem *QTreeWidgetItemIterator::operator*() const

Dereferenz-Operator. Gibt einen Zeiger auf das aktuelle Element zurück.

QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator++()

Der Präfix-Operator ++ (++it) setzt den Iterator auf das nächste übereinstimmende Element und gibt einen Verweis auf den resultierenden Iterator zurück. Setzt den aktuellen Zeiger auf nullptr, wenn das aktuelle Element das letzte passende Element ist.

const QTreeWidgetItemIterator QTreeWidgetItemIterator::operator++(int)

Der Postfix-Operator ++ (it++) verschiebt den Iterator zum nächsten passenden Element und gibt einen Iterator zum zuvor aktuellen Element zurück.

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

Bringt den Iterator zum Vorwärtsgehen, indem er n übereinstimmende Elemente auflistet. (Wenn n negativ ist, geht der Iterator rückwärts.)

Wenn das aktuelle Element hinter dem letzten Element liegt, wird der Zeiger auf das aktuelle Element auf nullptr gesetzt. Gibt den resultierenden Iterator zurück.

QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator--()

Der Präfix-Operator -- (--it) verschiebt den Iterator zum vorherigen passenden Element und gibt einen Verweis auf den resultierenden Iterator zurück. 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 aktuell und gibt einen Iterator zum zuvor aktuellen Element zurück.

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

Bringt den Iterator dazu, rückwärts zu gehen, indem er n übereinstimmende Elemente auflistet. (Wenn n negativ ist, geht der Iterator vorwärts.)

Wenn das aktuelle Element vor dem letzten Element liegt, 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.

© 2025 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.