Класс QTreeWidgetItemIterator

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

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

Типы public

Функции public

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

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

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

    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 = All)

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

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

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

Создаёт итератор для данного 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. Возвращает результирующий итератор.