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::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.