Sur cette page

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.

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)

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.