QTreeWidgetItemIterator Class
QTreeWidgetItemIterator 클래스는 QTreeWidget 인스턴스의 항목을 반복하는 방법을 제공합니다. 더 보기...
Header: | #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; }
특정 flags 을 QTreeWidgetItemIterator의 생성자에 전달하여 특정 유형의 노드를 필터링할 수도 있습니다.
QTreeWidget, 모델/보기 프로그래밍 및 QTreeWidgetItem 을참조하세요 .
멤버 유형 문서
열거형 QTreeWidgetItemIterator::IteratorFlag
플래그 QTreeWidgetItemIterator::IteratorFlags
이 플래그는 QTreeWidgetItemIterator 생성자에 전달할 수 있으며 (두 개 이상 사용되면 함께 OR-ed), 이터레이터가 주어진 플래그와 일치하는 항목만 반복하도록 합니다.
상수 | 값 |
---|---|
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)
지정된 flags 을 사용하여 반복하는 동안 어떤 항목이 발견되는지 결정하는 지정된 widget 에 대한 이터레이터를 구축합니다. 이터레이터는 위젯에 포함된 첫 번째 최상위 항목을 가리키도록 설정되거나 최상위 항목이 플래그와 일치하지 않는 경우 다음으로 일치하는 항목을 가리키도록 설정됩니다.
QTreeWidgetItemIterator::IteratorFlag 를참조하세요 .
[explicit]
QTreeWidgetItemIterator::QTreeWidgetItemIterator(QTreeWidgetItem *item, QTreeWidgetItemIterator::IteratorFlags flags = All)
지정된 flags 을 사용하여 반복하는 동안 어떤 항목이 발견되는지 결정하는 지정된 item 에 대한 이터레이터를 구축합니다. 이터레이터는 item 또는 item 이 플래그와 일치하지 않는 경우 다음으로 일치하는 항목을 가리키도록 설정됩니다.
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)
후위 연산자(it-)는 앞의 일치하는 항목을 현재 항목으로 만들고 이전 현재 항목으로 반복자를 반환합니다.
QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator-=(int n)
반복기를 n 일치하는 항목만큼 뒤로 이동합니다. (n이 음수이면 반복기는 앞으로 이동합니다.)
현재 항목이 마지막 항목보다 앞에 있으면 현재 항목 포인터가 nullptr
로 설정됩니다. 결과 이터레이터를 반환합니다.
QTreeWidgetItemIterator &QTreeWidgetItemIterator::operator=(const QTreeWidgetItemIterator &it)
할당. it 의 복사본을 만들고 해당 이터레이터에 대한 참조를 반환합니다.
© 2025 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.