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::All | 0x00000000 |
QTreeWidgetItemIterator::Hidden | 0x00000001 |
QTreeWidgetItemIterator::NotHidden | 0x00000002 |
QTreeWidgetItemIterator::Selected | 0x00000004 |
QTreeWidgetItemIterator::Unselected | 0x00000008 |
QTreeWidgetItemIterator::Selectable | 0x00000010 |
QTreeWidgetItemIterator::NotSelectable | 0x00000020 |
QTreeWidgetItemIterator::DragEnabled | 0x00000040 |
QTreeWidgetItemIterator::DragDisabled | 0x00000080 |
QTreeWidgetItemIterator::DropEnabled | 0x00000100 |
QTreeWidgetItemIterator::DropDisabled | 0x00000200 |
QTreeWidgetItemIterator::HasChildren | 0x00000400 |
QTreeWidgetItemIterator::NoChildren | 0x00000800 |
QTreeWidgetItemIterator::Checked | 0x00001000 |
QTreeWidgetItemIterator::NotChecked | 0x00002000 |
QTreeWidgetItemIterator::Enabled | 0x00004000 |
QTreeWidgetItemIterator::Disabled | 0x00008000 |
QTreeWidgetItemIterator::Editable | 0x00010000 |
QTreeWidgetItemIterator::NotEditable | 0x00020000 |
QTreeWidgetItemIterator::UserFlag | 0x01000000 |
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.