Класс 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, который использует указанные flags для определения, какие элементы находятся во время итерирования. Итератор устанавливается в указатель на первый элемент верхнего уровня, содержащийся в виджете, или на следующий соответствующий элемент, если элемент верхнего уровня не соответствует флагам.

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

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

Создаёт итератор для данного 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 и возвращает ссылку на его итератор.