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.
| Konstante | Wert |
|---|---|
QTreeWidgetItemIterator::All | 0x00000000 |
QTreeWidgetItemIterator::Hidden | 0x00000001 |
QTreeWidgetItemIterator::NotHidden | 0x00000002 |
QTreeWidgetItemIterator::Selected | 0x00000004 |
QTreeWidgetItemIterator::Unselected | 0x00000008 |
QTreeWidgetItemIterator::Selectable | 0x00000010 |
QTreeWidgetItemIterator::NotSelectable | 0x00000020 |
QTreeWidgetItemIterator::DragEnabled | 0x00000040 |
QTreeWidgetItemIterator::DragDisabled | 0x00000080 |
QTreeWidgetItemIterator::DropEnabled | 0x00000100 |
QTreeWidgetItemIterator::DropDisabled | 0x00000200 |
QTreeWidgetItemIterator::HasChildren | 0x00000400 |
QTreeWidgetItemIterator::NoChildren | 0x00000800 |
QTreeWidgetItemIterator::Checked | 0x00001000 |
QTreeWidgetItemIterator::NotChecked | 0x00002000 |
QTreeWidgetItemIterator::Enabled | 0x00004000 |
QTreeWidgetItemIterator::Disabled | 0x00008000 |
QTreeWidgetItemIterator::Editable | 0x00010000 |
QTreeWidgetItemIterator::NotEditable | 0x00020000 |
QTreeWidgetItemIterator::UserFlag | 0x01000000 |
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.