Класс 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, IteratorFlags flags = All)

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

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

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

Создаёт итератор для заданного item, который использует указанные flags для определения элементов, которые будут найдены во время итерации. Итератор устанавливается на 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 и возвращает ссылку на его итератор.