Sur cette page

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.

ConstanteValeur
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

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.