En esta página

QTreeWidgetItemIterator Class

La clase `QTreeWidgetItemIterator` permite recorrer los elementos de una instancia de ` QTreeWidget `. Más información...

Encabezado: #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 orden de recorrido preordenado, visitando así el nodo padre antes de continuar con los nodos hijos.

Por ejemplo, el siguiente código enumera 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 determinados tipos de nodos pasando determinados « flags » al constructor de `QTreeWidgetItemIterator`.

Véase también « QTreeWidget », «Programación Modelo/Vista» y « QTreeWidgetItem ».

Documentación sobre los tipos de miembros

enum QTreeWidgetItemIterator::IteratorFlag
flags QTreeWidgetItemIterator::IteratorFlags

Estas opciones se pueden pasar al constructor de un QTreeWidgetItemIterator (combinadas mediante el operador OR si se utiliza más de una), de modo que el iterador solo recorra los elementos que coincidan con las opciones indicadas.

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 de QFlags<IteratorFlag>. Almacena una combinación OR de valores de IteratorFlag.

Documentación de las funciones miembro

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

Crea un iterador para el widget dado que utiliza el flags especificado para determinar qué elementos se encuentran durante la iteración. El iterador se configura para que apunte al primer elemento de nivel superior contenido en el widget, o al siguiente elemento que coincida si el elemento de nivel superior no cumple con los criterios de los indicadores.

Véase también QTreeWidgetItemIterator::IteratorFlag.

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

Crea un iterador para el objeto ` item ` dado que utiliza el objeto ` flags ` especificado para determinar qué elementos se encuentran durante la iteración. El iterador se configura para que apunte a ` item`, o al siguiente elemento que coincida si ` item ` no coincide con los indicadores.

Véase también QTreeWidgetItemIterator::IteratorFlag.

QTreeWidgetItemIterator::QTreeWidgetItemIterator(const QTreeWidgetItemIterator &it)

Crea un iterador para el mismo objeto « 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 « ++ » (++it) hace avanzar el iterador hasta el siguiente elemento que coincida y devuelve una referencia al iterador resultante. Establece el puntero actual en nullptr si el elemento actual es el último que coincide.

const QTreeWidgetItemIterator QTreeWidgetItemIterator::operator++(int)

El operador postfijo ++ (it++) hace avanzar el iterador hasta el siguiente elemento coincidente y devuelve un iterador al elemento que era el actual anteriormente.

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

Hace que el iterador avance n elementos coincidentes. (Si n es negativo, el iterador retrocede.)

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

QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator--()

El operador prefijo « -- » (--it) desplaza el iterador hasta el elemento coincidente anterior y devuelve una referencia al iterador resultante. Establece el puntero actual en « nullptr » si el elemento actual es el primero que coincide.

const QTreeWidgetItemIterator QTreeWidgetItemIterator::operator--(int)

El operador postfijo «–» (it–) convierte en elemento actual el elemento coincidente anterior y devuelve un iterador al elemento que era el actual anteriormente.

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

Hace que el iterador retroceda n elementos coincidentes. (Si n es negativo, el iterador avanza.)

Si el elemento actual se encuentra antes que el último elemento, el puntero del elemento actual se establece en nullptr. Devuelve el iterador resultante.

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

Asignación. Crea 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.