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