Класс QTreeWidgetItemIterator

Класс QTreeWidgetItemIterator предоставляет способ итерирования по элементам в экземпляре QTreeWidget. Подробнее...

• Список всех членов, включая унаследованные

Публичные типы

Публичные функции

Подробное описание

Класс QTreeWidgetItemIterator предоставляет способ итерирования по элементам в экземпляре QTreeWidget.

Итератор будет обходить элементы в порядке обхода в ширину, посещая родительский узел перед продолжением к дочерним узлам.

Например, следующий код обрабатывает каждый элемент в дереве, проверяя текст в первом столбце на соответствие заданной строке поиска:

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

Также можно отфильтровать определённые типы узлов, передавая соответствующие флаги в конструктор QTreeWidgetItemIterator.

См. также QTreeWidget, Модельно-Представление программирование и QTreeWidgetItem.

Документация по типам членов

перечисление QTreeWidgetItemIterator::IteratorFlagфлаги QTreeWidgetItemIterator::IteratorFlags

Эти флаги могут быть переданы в конструктор QTreeWidgetItemIterator (если нужно несколько, их нужно объединить по битовому ИЛИ), чтобы итератор обрабатывал только элементы, соответствующие данным флагам.

Тип IteratorFlags является типом-синонимом для QFlags<IteratorFlag>. Он хранит битовое объединение значений IteratorFlag.

Документация по функциям-членам

QTreeWidgetItemIterator::QTreeWidgetItemIterator(const QTreeWidgetItemIterator &it)

Создаёт итератор для того же QTreeWidget, что и it. Текущий элемент итератора устанавливается на текущий элемент it.

QTreeWidgetItemIterator::QTreeWidgetItemIterator(QTreeWidget *widget, QTreeWidgetItemIterator::IteratorFlags flags)

Создаёт итератор для данного widget, который использует указанные флаги для определения, какие элементы будут найдены во время итерирования. Итератор устанавливается на первый элемент верхнего уровня, содержащийся в виджете, или на следующий соответствующий элемент, если элемент верхнего уровня не соответствует флагам.

См. также QTreeWidgetItemIterator::IteratorFlag.

QTreeWidgetItemIterator::QTreeWidgetItemIterator(QTreeWidgetItem *item, QTreeWidgetItemIterator::IteratorFlags flags)

Создаёт итератор для данного item, который использует указанные флаги для определения, какие элементы будут найдены во время итерирования. Итератор устанавливается на item, или на следующий соответствующий элемент, если item не соответствует флагам.

См. также QTreeWidgetItemIterator::IteratorFlag.

QTreeWidgetItemIterator::~QTreeWidgetItemIterator()

Удаляет итератор.

QTreeWidgetItem *QTreeWidgetItemIterator::operator*() const

Оператор разыменования. Возвращает указатель на текущий элемент.

QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator++()

Префиксный оператор ++ (++it) перемещает итератор к следующему соответствующему элементу и возвращает ссылку на полученный итератор. Устанавливает текущий указатель в 0, если текущий элемент является последним соответствующим элементом.

const QTreeWidgetItemIterator QTreeWidgetItemIterator::operator++(int)

Постфиксный оператор ++ (it++) перемещает итератор к следующему соответствующему элементу и возвращает итератор на предыдущий текущий элемент.

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

Перемещает итератор вперёд на n соответствующих элементов. (Если n отрицательно, итератор перемещается назад.)

Если текущий элемент выходит за пределы последнего элемента, указатель на текущий элемент устанавливается в 0. Возвращает полученный итератор.

QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator--()

Префиксный оператор -- ( --it) перемещает итератор к предыдущему совпадающему элементу и возвращает ссылку на полученный итератор. Устанавливает текущий указатель в 0, если текущий элемент является первым совпадающим элементом.

const QTreeWidgetItemIterator QTreeWidgetItemIterator::operator--(int)

Постфиксный оператор -- (it--) делает предыдущий совпадающий элемент текущим и возвращает итератор на ранее текущий элемент.

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

Перемещает итератор назад на n совпадающих элементов. (Если n отрицательно, итератор перемещается вперед.)

Если текущий элемент находится перед последним элементом, указатель текущего элемента устанавливается в 0. Возвращает полученный итератор.

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

Присваивание. Создает копию it и возвращает ссылку на его итератор.