QTreeWidgetItemIterator Class
La classe `QTreeWidgetItemIterator` permet de parcourir les éléments d'une instance de ` QTreeWidget `. En savoir plus...
| 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 selon un ordre de traversée pré-ordre, visitant ainsi le nœud parent avant de passer aux nœuds enfants.
Par exemple, le code suivant parcourt chaque élément d'une arborescence, en comparant le texte de la première colonne à 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 transmettant des « flags » au constructeur de `QTreeWidgetItemIterator`.
Voir également « QTreeWidget », «Programmation Modèle/Vue» et « QTreeWidgetItem ».
Documentation sur les types de membres
enum QTreeWidgetItemIterator::IteratorFlag
flags QTreeWidgetItemIterator::IteratorFlags
Ces indicateurs peuvent être transmis au constructeur d’un itérateur QTreeWidgetItemIterator (en les combinant par opération OR si plusieurs sont utilisés), de sorte que l’itérateur ne parcoure que les éléments correspondant aux indicateurs spécifié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)
Crée un itérateur pour l'widget donné qui utilise l'flags spécifié pour déterminer quels éléments sont trouvés au cours de l'itération. L'itérateur est configuré pour pointer vers le premier élément de niveau supérieur contenu dans le widget, ou vers l'élément correspondant suivant si l'élément de niveau supérieur ne correspond pas aux indicateurs.
Voir également QTreeWidgetItemIterator::IteratorFlag.
[explicit] QTreeWidgetItemIterator::QTreeWidgetItemIterator(QTreeWidgetItem *item, QTreeWidgetItemIterator::IteratorFlags flags = All)
Crée un itérateur pour l'item donné qui utilise l'flags spécifié pour déterminer quels éléments sont trouvés au cours de l'itération. L'itérateur est configuré pour pointer vers item, ou vers l'élément correspondant suivant si item ne correspond pas aux drapeaux.
Voir également QTreeWidgetItemIterator::IteratorFlag.
QTreeWidgetItemIterator::QTreeWidgetItemIterator(const QTreeWidgetItemIterator &it)
Crée un itérateur pour la même QTreeWidget que it. L'élément actuel de l'itérateur est défini de manière à pointer vers 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 vers l'élément actuel.
QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator++()
L'opérateur préfixe « ++ » (++it) fait avancer l'itérateur vers l'élément suivant correspondant et renvoie une référence à l'itérateur résultant. Il définit le pointeur courant sur « nullptr » si l'élément actuel est le dernier élément correspondant.
const QTreeWidgetItemIterator QTreeWidgetItemIterator::operator++(int)
L'opérateur postfixe ++ (it++) fait avancer l'itérateur vers l'élément suivant correspondant et renvoie un itérateur vers l'élément qui était précédemment sélectionné.
QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator+=(int n)
Fait avancer l'itérateur de n éléments correspondants. (Si n est négatif, l'itérateur recule.)
Si l'élément actuel se trouve au-delà du dernier élément, le pointeur vers l'élément actuel est défini sur nullptr. Renvoie l'itérateur résultant.
QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator--()
L'opérateur préfixe « -- » (--it) fait avancer l'itérateur vers l'élément correspondant précédent et renvoie une référence à l'itérateur obtenu. Il définit le pointeur courant sur « nullptr » si l'élément actuel est le premier élément correspondant.
const QTreeWidgetItemIterator QTreeWidgetItemIterator::operator--(int)
L'opérateur postfixe « it » désigne l'élément correspondant précédent comme élément actuel et renvoie un itérateur vers l'élément qui était auparavant l'élément actuel.
QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator-=(int n)
Fait reculer l'itérateur de n éléments correspondants. (Si n est négatif, l'itérateur avance.)
Si l’élément actuel se trouve avant le dernier élément, le pointeur vers l’élément actuel est défini sur nullptr. Renvoie l’itérateur résultant.
QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator=(const QTreeWidgetItemIterator &it)
Affectation. Crée 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.