En esta página

QTreeWidgetItemIterator Class

La clase QTreeWidgetItemIterator proporciona una forma de iterar sobre los elementos de una instancia QTreeWidget. Más...

Cabecera: #include <QTreeWidgetItemIterator>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets

Tipos Públicos

enum IteratorFlag { All, Hidden, NotHidden, Selected, Unselected, …, UserFlag }
flags IteratorFlags

Funciones Públicas

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)

Descripción Detallada

El iterador recorrerá los elementos en un orden pre-ordenado, visitando el nodo padre antes de continuar con los nodos hijos.

Por ejemplo, el siguiente código ejemplifica cada elemento de un árbol, comparando el texto de la primera columna con una cadena de búsqueda especificada por el usuario:

QTreeWidgetItemIterator it(treeWidget);
while (*it) {
    if ((*it)->text(0) == itemText)
        (*it)->setSelected(true);
    ++it;
}

También es posible filtrar ciertos tipos de nodos pasando flags al constructor de QTreeWidgetItemIterator.

Ver también QTreeWidget, Model/View Programming, y QTreeWidgetItem.

Documentación de tipos de miembros

enum QTreeWidgetItemIterator::IteratorFlag
flags QTreeWidgetItemIterator::IteratorFlags

Estas banderas pueden pasarse a un constructor QTreeWidgetItemIterator (OR-ed together if more than one is used), de modo que el iterador sólo iterará sobre elementos que coincidan con las banderas dadas.

ConstanteValor
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

El tipo IteratorFlags es un typedef para QFlags<IteratorFlag>. Almacena una combinación OR de valores IteratorFlag.

Documentación de las funciones miembro

[explicit] QTreeWidgetItemIterator::QTreeWidgetItemIterator(QTreeWidget *widget, QTreeWidgetItemIterator::IteratorFlags flags = All)

Construye un iterador para el widget dado que utiliza el flags especificado para determinar qué elementos se encuentran durante la iteración. El iterador se establece para apuntar al primer elemento de nivel superior contenido en el widget, o al siguiente elemento coincidente si el elemento de nivel superior no coincide con las banderas.

Véase también QTreeWidgetItemIterator::IteratorFlag.

[explicit] QTreeWidgetItemIterator::QTreeWidgetItemIterator(QTreeWidgetItem *item, QTreeWidgetItemIterator::IteratorFlags flags = All)

Construye un iterador para el item dado que utiliza el flags especificado para determinar qué elementos se encuentran durante la iteración. El iterador se establece para apuntar a item, o al siguiente elemento coincidente si item no coincide con las banderas.

Véase también QTreeWidgetItemIterator::IteratorFlag.

QTreeWidgetItemIterator::QTreeWidgetItemIterator(const QTreeWidgetItemIterator &it)

Construye un iterador para el mismo QTreeWidget que it. El elemento actual del iterador se establece para que apunte al elemento actual de it.

[noexcept] QTreeWidgetItemIterator::~QTreeWidgetItemIterator()

Destruye el iterador.

QTreeWidgetItem *QTreeWidgetItemIterator::operator*() const

Operador de desreferencia. Devuelve un puntero al elemento actual.

QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator++()

El operador de prefijo ++ (++it) avanza el iterador al siguiente elemento coincidente y devuelve una referencia al iterador resultante. Establece el puntero actual a nullptr si el elemento actual es el último elemento coincidente.

const QTreeWidgetItemIterator QTreeWidgetItemIterator::operator++(int)

El operador postfijo ++ (it++) avanza el iterador al siguiente elemento coincidente y devuelve un iterador al elemento previamente actual.

QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator+=(int n)

Hace que el iterador avance por n elementos coincidentes. (Si n es negativo, el iterador va hacia atrás).

Si el elemento actual está más allá del último elemento, el puntero del elemento actual se establece en nullptr. Devuelve el iterador resultante.

QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator--()

El operador de prefijo -- (--it) avanza el iterador al elemento coincidente anterior y devuelve una referencia al iterador resultante. Establece el puntero actual a nullptr si el elemento actual es el primer elemento coincidente.

const QTreeWidgetItemIterator QTreeWidgetItemIterator::operator--(int)

El operador postfijo - (it-) convierte en actual el elemento coincidente anterior y devuelve un iterador al elemento previamente actual.

QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator-=(int n)

Hace que el iterador retroceda por n elementos coincidentes. (Si n es negativo, el iterador va hacia adelante).

Si el elemento actual está por delante del último elemento, el puntero del elemento actual se establece en nullptr. Devuelve el iterador resultante.

QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator=(const QTreeWidgetItemIterator &it)

Asignación. Hace una copia de it y devuelve una referencia a su iterador.

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