Класс QTreeWidgetItemIterator

Класс 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(QTreeWidgetItem *item, QTreeWidgetItemIterator::IteratorFlags flags = Все)

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

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

QTreeWidgetItemIterator::QTreeWidgetItemIterator(QTreeWidget *widget, QTreeWidgetItemIterator::IteratorFlags flags = Все)

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

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

QTreeWidgetItemIterator::QTreeWidgetItemIterator(const QTreeWidgetItemIterator &it)

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

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

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

QTreeWidgetItemIterator::~QTreeWidgetItemIterator()

Уничтожает итератор.

QTreeWidgetItem *QTreeWidgetItemIterator::operator*() const

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

QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator++()

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

const QTreeWidgetItemIterator QTreeWidgetItemIterator::operator++(int)

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

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

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

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

QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator--()

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

const QTreeWidgetItemIterator QTreeWidgetItemIterator::operator--(int)

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

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

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

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