이 페이지에서

QTreeWidgetItemIterator Class

QTreeWidgetItemIterator 클래스는 QTreeWidget 인스턴스의 항목을 순회하는 방법을 제공합니다. 더 보기...

헤더: #include <QTreeWidgetItemIterator>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets

공개 유형

enum IteratorFlag { All, Hidden, NotHidden, Selected, Unselected, …, UserFlag }
flags IteratorFlags

공개 함수

QTreeWidgetItemIterator(QTreeWidget *widget, QTreeWidgetItemIterator::IteratorFlags flags = All)
QTreeWidgetItemIterator(QTreeWidgetItem *item, QTreeWidgetItemIterator::IteratorFlags flags = All)
QTreeWidgetItemIterator(const QTreeWidgetItemIterator &it)
~QTreeWidgetItemIterator()
QTreeWidgetItem *operator*() const
QTreeWidgetItemIterator &operator++()
const QTreeWidgetItemIterator operator++(int)
QTreeWidgetItemIterator &operator+=(int n)
QTreeWidgetItemIterator &operator--()
const QTreeWidgetItemIterator operator--(int)
QTreeWidgetItemIterator &operator-=(int n)
QTreeWidgetItemIterator &operator=(const QTreeWidgetItemIterator &it)

상세 설명

이테레이터는 선순회 순서로 항목을 순회하므로, 자식 노드로 넘어가기 전에 부모 노드를 먼저 방문합니다.

예를 들어, 다음 코드 예제는 트리의 각 항목을 순회하며 첫 번째 열의 텍스트를 사용자가 지정한 검색 문자열과 비교합니다.

QTreeWidgetItemIterator it(treeWidget);
while (*it) {
    if ((*it)->text(0) == itemText)
        (*it)->setSelected(true);
    ++it;
}

또한 QTreeWidgetItemIterator의 생성자에 특정 flags 를 전달하여 특정 유형의 노드를 필터링할 수도 있습니다.

QTreeWidget, 모델/뷰 프로그래밍 및 QTreeWidgetItem도 참조하십시오 .

멤버 유형 문서

enum QTreeWidgetItemIterator::IteratorFlag
flags QTreeWidgetItemIterator::IteratorFlags

이러한 플래그는 ` QTreeWidgetItemIterator ` 생성자에 전달할 수 있으며(여러 개를 사용하는 경우 OR 연산으로 결합됨), 이를 통해 이터레이터는 지정된 플래그에 해당하는 항목만 순회하게 됩니다.

상수값
QTreeWidgetItemIterator::All0x00000000
QTreeWidgetItemIterator::Hidden0x00000001
QTreeWidgetItemIterator::NotHidden0x00000002
QTreeWidgetItemIterator::Selected0x00000004
QTreeWidgetItemIterator::Unselected0x00000008
QTreeWidgetItemIterator::Selectable0x00000010
QTreeWidgetItemIterator::NotSelectable0x00000020
QTreeWidgetItemIterator::DragEnabled0x00000040
QTreeWidgetItemIterator::DragDisabled0x00000080
QTreeWidgetItemIterator::DropEnabled0x00000100
QTreeWidgetItemIterator::DropDisabled0x00000200
QTreeWidgetItemIterator::HasChildren0x00000400
QTreeWidgetItemIterator::NoChildren0x00000800
QTreeWidgetItemIterator::Checked0x00001000
QTreeWidgetItemIterator::NotChecked0x00002000
QTreeWidgetItemIterator::Enabled0x00004000
QTreeWidgetItemIterator::Disabled0x00008000
QTreeWidgetItemIterator::Editable0x00010000
QTreeWidgetItemIterator::NotEditable0x00020000
QTreeWidgetItemIterator::UserFlag0x01000000

IteratorFlags 유형은 QFlags<IteratorFlag>에 대한 typedef입니다. 이 유형은 IteratorFlag 값들의 OR 조합을 저장합니다.

멤버 함수 문서

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

주어진 ` widget `에 대해, 지정된 ` flags `를 사용하여 반복 과정에서 어떤 항목이 발견되는지 결정하는 반복자를 생성합니다. 이 반복자는 위젯에 포함된 첫 번째 최상위 항목을 가리키도록 설정되며, 최상위 항목이 플래그와 일치하지 않는 경우에는 다음으로 일치하는 항목을 가리키도록 설정됩니다.

QTreeWidgetItemIterator::IteratorFlag도 참조하십시오 .

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

주어진 ` item `에 대해, 지정된 ` flags `를 사용하여 반복 과정에서 어떤 항목이 발견되는지 결정하는 반복자를 생성합니다. 이 반복자는 ` item`을 가리키도록 설정되며, ` item `가 `flags`와 일치하지 않는 경우에는 다음으로 일치하는 항목을 가리키도록 설정됩니다.

QTreeWidgetItemIterator::IteratorFlag도 참조하십시오 .

QTreeWidgetItemIterator::QTreeWidgetItemIterator(const QTreeWidgetItemIterator &it)

it 와 동일한 QTreeWidget 에 대한 이터레이터를 생성합니다. 현재 이터레이터 항목은 it 의 현재 항목을 가리키도록 설정됩니다.

[noexcept] 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)

postfix – 연산자(it–)는 바로 앞에 오는 일치 항목을 현재 항목으로 지정하고, 이전에 현재 항목이었던 항목에 대한 반복자를 반환합니다.

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

n 만큼 항목을 일치시키며 이터레이터를 뒤로 이동시킵니다. (n이 음수인 경우, 이터레이터는 앞으로 이동합니다.)

현재 항목이 마지막 항목보다 앞쪽에 있는 경우, 현재 항목 포인터를 nullptr 로 설정합니다. 결과 이터레이터를 반환합니다.

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

할당. ` it `의 복사본을 생성하고, 해당 반복자에 대한 참조를 반환합니다.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.