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-ed together)。

定数
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)

指定された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.