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.
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)
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.