QTreeWidgetItemIterator Class
La classe QTreeWidgetItemIterator permet d'itérer sur les éléments d'une instance QTreeWidget. Plus d'informations...
| En-tête : | #include <QTreeWidgetItemIterator> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
Types publics
| enum | IteratorFlag { All, Hidden, NotHidden, Selected, Unselected, …, UserFlag } |
| flags | IteratorFlags |
Fonctions publiques
| 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) |
Description détaillée
L'itérateur parcourt les éléments dans un ordre préétabli, en visitant le nœud parent avant de passer aux nœuds enfants.
Par exemple, le code suivant examine chaque élément d'un arbre, en vérifiant le texte de la première colonne par rapport à une chaîne de recherche spécifiée par l'utilisateur :
QTreeWidgetItemIterator it(treeWidget); while (*it) { if ((*it)->text(0) == itemText) (*it)->setSelected(true); ++it; }
Il est également possible de filtrer certains types de nœuds en passant certains flags au constructeur de QTreeWidgetItemIterator.
Voir également QTreeWidget, Model/View Programming, et QTreeWidgetItem.
Documentation sur les types de membres
enum QTreeWidgetItemIterator::IteratorFlag
flags QTreeWidgetItemIterator::IteratorFlags
Ces drapeaux peuvent être passés au constructeur de QTreeWidgetItemIterator (OU ensemble si plusieurs drapeaux sont utilisés), de sorte que l'itérateur n'itère que sur les éléments qui correspondent aux drapeaux donnés.
| Constante | Valeur |
|---|---|
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 |
Le type IteratorFlags est un typedef pour QFlags<IteratorFlag>. Il stocke une combinaison OU de valeurs IteratorFlag.
Documentation des fonctions membres
[explicit] QTreeWidgetItemIterator::QTreeWidgetItemIterator(QTreeWidget *widget, QTreeWidgetItemIterator::IteratorFlags flags = All)
Construit un itérateur pour le site widget donné, qui utilise le site flags spécifié pour déterminer quels éléments sont trouvés pendant l'itération. L'itérateur est défini pour pointer sur le premier élément de premier niveau contenu dans le widget, ou sur l'élément correspondant suivant si l'élément de premier niveau ne correspond pas aux drapeaux.
Voir aussi QTreeWidgetItemIterator::IteratorFlag.
[explicit] QTreeWidgetItemIterator::QTreeWidgetItemIterator(QTreeWidgetItem *item, QTreeWidgetItemIterator::IteratorFlags flags = All)
Construit un itérateur pour le site item donné qui utilise le site flags spécifié pour déterminer quels éléments sont trouvés pendant l'itération. L'itérateur pointe sur item, ou sur le prochain élément correspondant si item ne correspond pas aux drapeaux.
Voir aussi QTreeWidgetItemIterator::IteratorFlag.
QTreeWidgetItemIterator::QTreeWidgetItemIterator(const QTreeWidgetItemIterator &it)
Construit un itérateur pour le même QTreeWidget que it. L'élément actuel de l'itérateur est positionné sur l'élément actuel de it.
[noexcept] QTreeWidgetItemIterator::~QTreeWidgetItemIterator()
Détruit l'itérateur.
QTreeWidgetItem *QTreeWidgetItemIterator::operator*() const
Opérateur de déréférencement. Renvoie un pointeur sur l'élément courant.
QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator++()
L'opérateur préfixe ++ (++it) fait passer l'itérateur à l'élément correspondant suivant et renvoie une référence à l'itérateur résultant. Fixe le pointeur actuel à nullptr si l'élément actuel est le dernier élément correspondant.
const QTreeWidgetItemIterator QTreeWidgetItemIterator::operator++(int)
L'opérateur postfixe ++ (it++) fait passer l'itérateur à l'élément correspondant suivant et renvoie un itérateur à l'élément courant précédent.
QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator+=(int n)
Fait avancer l'itérateur en n les éléments correspondants. (Si n est négatif, l'itérateur revient en arrière).
Si l'élément courant se trouve après le dernier élément, le pointeur de l'élément courant est mis à nullptr. Renvoie l'itérateur résultant.
QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator--()
L'opérateur préfixe -- (--it) avance l'itérateur à l'élément correspondant précédent et renvoie une référence à l'itérateur résultant. Fixe le pointeur actuel à nullptr si l'élément actuel est le premier élément correspondant.
const QTreeWidgetItemIterator QTreeWidgetItemIterator::operator--(int)
L'opérateur postfixe - (it-) rend l'élément correspondant précédent courant et renvoie un itérateur à l'élément courant précédent.
QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator-=(int n)
Fait reculer l'itérateur en n les éléments correspondants. (Si n est négatif, l'itérateur avance.)
Si l'élément courant est en avance sur le dernier élément, le pointeur de l'élément courant est mis à nullptr. Renvoie l'itérateur résultant.
QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator=(const QTreeWidgetItemIterator &it)
Affectation. Fait une copie de it et renvoie une référence à son itérateur.
© 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.