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::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 がフラグにマッチしない場合は、次にマッチする項目を指すように設定されます。
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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。