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.
| Constante | Valor |
|---|---|
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 |
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.