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;
    }

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)

与えられたwidget のイテレータを構築する。このイテレータは、指定されたflags を使用して、反復中にどの項目が見つかるかを決定する。イテレータは、ウィジェットに含まれる最初のトップレベル項目を指すように設定され、トップレベル項目がフラグに一致しない場合は、次に一致する項目を指すように設定されます。

QTreeWidgetItemIterator::IteratorFlagも参照してください

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

指定されたitem のイテレータを構築します。このイテレータは、指定されたflags を使用して、反復中にどの項目が見つかるかを決定します。イテレータは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)

postfix ++ 演算子 (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 のコピーを作成し、そのイテレータへの参照を返します。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。