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

См. также 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. Возвращает полученную итератор.