QTreeWidgetItem Class

QTreeWidgetItemクラスは、QTreeWidget コンビニエンスクラスで使用するアイテムを提供します。詳細...

ヘッダー #include <QTreeWidgetItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets

パブリックな型

enum ChildIndicatorPolicy { ShowIndicator, DontShowIndicator, DontShowIndicatorWhenChildless }
enum ItemType { Type, UserType }

パブリック関数

QTreeWidgetItem(int type = Type)
QTreeWidgetItem(QTreeWidget *parent, int type = Type)
QTreeWidgetItem(QTreeWidgetItem *parent, int type = Type)
QTreeWidgetItem(const QStringList &strings, int type = Type)
QTreeWidgetItem(QTreeWidget *parent, QTreeWidgetItem *preceding, int type = Type)
QTreeWidgetItem(QTreeWidget *parent, const QStringList &strings, int type = Type)
QTreeWidgetItem(QTreeWidgetItem *parent, QTreeWidgetItem *preceding, int type = Type)
QTreeWidgetItem(QTreeWidgetItem *parent, const QStringList &strings, int type = Type)
QTreeWidgetItem(const QTreeWidgetItem &other)
virtual ~QTreeWidgetItem()
void addChild(QTreeWidgetItem *child)
void addChildren(const QList<QTreeWidgetItem *> &children)
QBrush background(int column) const
Qt::CheckState checkState(int column) const
QTreeWidgetItem *child(int index) const
int childCount() const
QTreeWidgetItem::ChildIndicatorPolicy childIndicatorPolicy() const
virtual QTreeWidgetItem *clone() const
int columnCount() const
virtual QVariant data(int column, int role) const
Qt::ItemFlags flags() const
QFont font(int column) const
QBrush foreground(int column) const
QIcon icon(int column) const
int indexOfChild(QTreeWidgetItem *child) const
void insertChild(int index, QTreeWidgetItem *child)
void insertChildren(int index, const QList<QTreeWidgetItem *> &children)
bool isDisabled() const
bool isExpanded() const
bool isFirstColumnSpanned() const
bool isHidden() const
bool isSelected() const
QTreeWidgetItem *parent() const
virtual void read(QDataStream &in)
void removeChild(QTreeWidgetItem *child)
void setBackground(int column, const QBrush &brush)
void setCheckState(int column, Qt::CheckState state)
void setChildIndicatorPolicy(QTreeWidgetItem::ChildIndicatorPolicy policy)
virtual void setData(int column, int role, const QVariant &value)
void setDisabled(bool disabled)
void setExpanded(bool expand)
void setFirstColumnSpanned(bool span)
void setFlags(Qt::ItemFlags flags)
void setFont(int column, const QFont &font)
void setForeground(int column, const QBrush &brush)
void setHidden(bool hide)
void setIcon(int column, const QIcon &icon)
void setSelected(bool select)
void setSizeHint(int column, const QSize &size)
void setStatusTip(int column, const QString &statusTip)
void setText(int column, const QString &text)
(since 6.4) void setTextAlignment(int column, Qt::Alignment alignment)
void setToolTip(int column, const QString &toolTip)
void setWhatsThis(int column, const QString &whatsThis)
QSize sizeHint(int column) const
void sortChildren(int column, Qt::SortOrder order)
QString statusTip(int column) const
QTreeWidgetItem *takeChild(int index)
QList<QTreeWidgetItem *> takeChildren()
QString text(int column) const
int textAlignment(int column) const
QString toolTip(int column) const
QTreeWidget *treeWidget() const
int type() const
QString whatsThis(int column) const
virtual void write(QDataStream &out) const
virtual bool operator<(const QTreeWidgetItem &other) const
QTreeWidgetItem &operator=(const QTreeWidgetItem &other)

保護された関数

QDataStream &operator<<(QDataStream &out, const QTreeWidgetItem &item)
QDataStream &operator>>(QDataStream &in, QTreeWidgetItem &item)

詳細説明

ツリーウィジェットアイテムは、ツリーウィジェットの情報の行を保持するために使用されます。行には通常いくつかの列データが含まれ、各列にはテキストラベルとアイコンを含めることができます。

QTreeWidgetItem クラスは、Qt 3 の QListViewItem クラスに代わる便利なクラスです。これは、QTreeWidget クラスで使用するアイテムを提供します。

アイテムは通常、QTreeWidget (トップレベルのアイテムの場合)またはQTreeWidgetItem(ツリーの下位レベルのアイテムの場合)のいずれかを親として構築されます。例えば、以下のコードでは、世界の都市を表すトップレベルのアイテムを作成し、子アイテムとしてオスロのエントリを追加しています:

    QTreeWidgetItem *cities = new QTreeWidgetItem(treeWidget);
    cities->setText(0, tr("Cities"));
    QTreeWidgetItem *osloItem = new QTreeWidgetItem(cities);
    osloItem->setText(0, tr("Oslo"));
    osloItem->setText(1, tr("Yes"));

項目を作成するときに、後に続く項目を指定することで、特定の順序で項目を追加することができます:

    QTreeWidgetItem *planets = new QTreeWidgetItem(treeWidget, cities);
    planets->setText(0, tr("Planets"));

アイテムの各列は、setBackground() 関数で設定される独自の背景ブラシを持つことができます。現在の背景ブラシはbackground() で確認できます。各列のテキスト・ラベルは、独自のフォントとブラシでレンダリングできます。これらはsetFont() とsetForeground() 関数で指定し、font() とforeground() で読み込む。

トップレベル項目とツリーの下層にある項目の主な違いは、トップレベル項目にはparent() がないことです。この情報はアイテムの違いを見分けるために使用でき、ツリーからアイテムを挿入したり削除したりする際に知っておくと便利です。アイテムの子は、takeChild() で削除でき、insertChild() 関数で子リストの指定されたインデックスに挿入できます。

デフォルトでは、アイテムは有効で、選択可能で、チェック可能で、ドラッグ・アンド・ドロップ操作のソースにすることができます。各項目のフラグは、適切な値を指定してsetFlags() を呼び出すことで変更できます (Qt::ItemFlags を参照)。チェック可能な項目は、setCheckState() 関数でチェックしたり外したりできます。対応するcheckState() 関数は、その項目が現在チェックされているかどうかを示します。

サブクラス化

カスタム項目を提供するためにQTreeWidgetItemをサブクラス化する場合、標準項目と区別できるように、それらのために新しい型を定義することが可能です。この機能を必要とするサブクラスのコンストラクタは、UserType 以上の新しい型の値でベースクラスのコンストラクタを呼び出す必要があります。

QTreeWidget,QTreeWidgetItemIterator,モデル/ビュー・プログラミング,QListWidgetItem,QTableWidgetItemも参照

メンバ型のドキュメント

enum QTreeWidgetItem::ChildIndicatorPolicy

定数説明
QTreeWidgetItem::ShowIndicator0このアイテムは、子供がいない場合でも、展開と折りたたみのコントロールが表示されます。
QTreeWidgetItem::DontShowIndicator1展開と折りたたみのコントロールは、たとえ子供がいても表示されません。ノードが強制的に開かれている場合、ユーザーはアイテムを展開または折りたたむことができません。
QTreeWidgetItem::DontShowIndicatorWhenChildless2展開と折りたたみのコントロールは、アイテムに子がある場合に表示されます。

enum QTreeWidgetItem::ItemType

この列挙型は、ツリーウィジェットの項目を記述するために使用される型を記述します。

定数説明
QTreeWidgetItem::Type0ツリーウィジェットアイテムのデフォルトタイプ。
QTreeWidgetItem::UserType1000カスタムタイプの最小値。UserType 以下の値は Qt によって予約されています。

QTreeWidgetItem のサブクラスで新しいユーザータイプを定義して、カスタムアイテムが特別に扱われるようにすることができます。

type()も参照してください

メンバ関数のドキュメント

[explicit] QTreeWidgetItem::QTreeWidgetItem(int type = Type)

指定されたtype のツリーウィジェットアイテムを構築する。アイテムはツリーウィジェットに挿入する必要があります。

type()も参照してください

[explicit] QTreeWidgetItem::QTreeWidgetItem(QTreeWidget *parent, int type = Type)

指定されたtype のツリーウィジェットアイテムを構築し、指定されたparent のアイテムに追加します。

type()も参照

[explicit] QTreeWidgetItem::QTreeWidgetItem(QTreeWidgetItem *parent, int type = Type)

ツリーウィジェットアイテムを構築し、与えられたparent に追加します。

type()も参照してください

[explicit] QTreeWidgetItem::QTreeWidgetItem(const QStringList &strings, int type = Type)

指定されたtype のツリーウィジェットアイテムを構築する。アイテムはツリーウィジェットに挿入する必要があります。指定されたstrings のリストは、アイテムの各列のアイテムテキストとして設定されます。

type()も参照してください

QTreeWidgetItem::QTreeWidgetItem(QTreeWidget *parent, QTreeWidgetItem *preceding, int type = Type)

指定されたtype のツリーウィジェットアイテムを構築し、preceding アイテムの後に指定されたparent に挿入する。

type()も参照してください

QTreeWidgetItem::QTreeWidgetItem(QTreeWidget *parent, const QStringList &strings, int type = Type)

指定されたtype のツリーウィジェットアイテムを構築し、指定されたparent のアイテムに追加します。指定されたstrings のリストは、アイテムの各列のアイテムテキストとして設定されます。

type()も参照してください

QTreeWidgetItem::QTreeWidgetItem(QTreeWidgetItem *parent, QTreeWidgetItem *preceding, int type = Type)

preceding 子アイテムの後にparent に挿入される、指定されたtype のツリーウィジェットアイテムを構築する。

type()も参照してください

QTreeWidgetItem::QTreeWidgetItem(QTreeWidgetItem *parent, const QStringList &strings, int type = Type)

ツリーウィジェットアイテムを構築し、与えられたparent に追加します。与えられたstrings のリストは、アイテムの各カラムのアイテムテキストとして設定されます。

type()も参照してください

QTreeWidgetItem::QTreeWidgetItem(const QTreeWidgetItem &other)

other type() と () はコピーされないことに注意。treeWidget

この関数は、clone() を再実装する場合に便利である。

data() およびflags()も参照

[virtual noexcept] QTreeWidgetItem::~QTreeWidgetItem()

このツリーウィジェットアイテムを破棄します。

アイテムは、それが追加されたQTreeWidgets から削除されます。これにより、いつでも安全にアイテムを削除することができます。

void QTreeWidgetItem::addChild(QTreeWidgetItem *child)

child の項目を子のリストに追加する。

insertChild() およびtakeChild()も参照

void QTreeWidgetItem::addChildren(const QList<QTreeWidgetItem *> &children)

指定されたchildren のリストをアイテムに追加します。

insertChildren() およびtakeChildren()も参照

QBrush QTreeWidgetItem::background(int column) const

指定されたcolumn の背景のレンダリングに使用されたブラシを返します。

setBackground() およびforeground()も参照

Qt::CheckState QTreeWidgetItem::checkState(int column) const

与えられたcolumn のラベルのチェック状態を返す。

setCheckState() およびQt::CheckStateも参照

QTreeWidgetItem *QTreeWidgetItem::child(int index) const

アイテムの子リストの指定されたindex にあるアイテムを返します。

parent()も参照

int QTreeWidgetItem::childCount() const

子アイテムの数を返します。

QTreeWidgetItem::ChildIndicatorPolicy QTreeWidgetItem::childIndicatorPolicy() const

アイテムインジケータポリシーを返します。このポリシーは、ツリーブランチの展開/折りたたみインジケータを表示するタイミングを決定します。

setChildIndicatorPolicy()も参照してください

[virtual] QTreeWidgetItem *QTreeWidgetItem::clone() const

アイテムとその子のディープコピーを作成します。

int QTreeWidgetItem::columnCount() const

項目の列数を返します。

[virtual] QVariant QTreeWidgetItem::data(int column, int role) const

アイテムのcolumnrole の値を返します。

setData()も参照してください

[protected] void QTreeWidgetItem::emitDataChanged()

このアイテムに関連付けられたモデルが、このアイテムに対してdataChanged() シグナルを発するようにする。

通常、この関数を呼び出す必要があるのは、QTreeWidgetItem をサブクラス化し、data() やsetData() を再実装した場合のみです。

setData()も参照してください

Qt::ItemFlags QTreeWidgetItem::flags() const

アイテムの説明に使用されるフラグを返します。これらによって、アイテムをチェック、編集、選択できるかどうかが決まります。

flags のデフォルト値はQt::ItemIsSelectable |Qt::ItemIsUserCheckable |Qt::ItemIsEnabled |Qt::ItemIsDragEnabled |Qt::ItemIsDropEnabled です。

setFlags()も参照してください

QFont QTreeWidgetItem::font(int column) const

指定されたcolumn のテキストをレンダリングするために使われたフォントを返します。

setFont()も参照

QBrush QTreeWidgetItem::foreground(int column) const

指定されたcolumn の前景(テキストなど)のレンダリングに使用されるブラシを返します。デフォルト構成のブラシを設定すると、ビューはスタイルからデフォルトの色を使用するようになります。

setForeground() およびbackground()も参照して ください。

QIcon QTreeWidgetItem::icon(int column) const

指定されたcolumn に表示されているアイコンを返す。

setIcon() およびiconSizeも参照のこと

int QTreeWidgetItem::indexOfChild(QTreeWidgetItem *child) const

指定されたchild の子アイテムのインデックスを返します。

void QTreeWidgetItem::insertChild(int index, QTreeWidgetItem *child)

子のリストのindexchild の項目を挿入します。

もしその子がすでに他の場所に挿入されていれば、再度挿入されることはない。

void QTreeWidgetItem::insertChildren(int index, const QList<QTreeWidgetItem *> &children)

与えられたchildren のリストを、index にあるアイテムの子のリストに挿入します。

すでにどこかに挿入されている子は挿入されません。

bool QTreeWidgetItem::isDisabled() const

アイテムが無効な場合はtrue を返し、そうでない場合はfalse を返す。

setFlags()も参照

bool QTreeWidgetItem::isExpanded() const

項目が展開されていればtrue を返し、そうでなければfalse を返す。

setExpanded()も参照

bool QTreeWidgetItem::isFirstColumnSpanned() const

項目が行のすべての列にまたがっている場合はtrue を返し、そうでない場合はfalse を返す。

setFirstColumnSpanned()も参照のこと

bool QTreeWidgetItem::isHidden() const

アイテムが非表示の場合はtrue を返し、そうでない場合はfalse を返す。

setHidden()も参照

bool QTreeWidgetItem::isSelected() const

項目が選択されていればtrue を返し、そうでなければfalse を返す。

setSelected()も参照

QTreeWidgetItem *QTreeWidgetItem::parent() const

アイテムの親を返します。

child()も参照してください

[virtual] void QTreeWidgetItem::read(QDataStream &in)

ストリームin から項目を読み込む。これは、データを1つのアイテムにのみ読み込みます。

write()も参照のこと

void QTreeWidgetItem::removeChild(QTreeWidgetItem *child)

child で指定された項目を削除します。削除された項目は削除されません。

void QTreeWidgetItem::setBackground(int column, const QBrush &brush)

与えられたcolumn のラベルの背景ブラシを、指定されたbrush に設定します。デフォルトのブラシを設定すると、ビューはスタイルからデフォルトの色を使用するようになります。

注意: Qt スタイルシートがsetBackground() と同じウィジェットで使用されている場合、設定が衝突するとスタイルシートが優先されます。

background() およびsetForeground()も参照してください

void QTreeWidgetItem::setCheckState(int column, Qt::CheckState state)

指定されたcolumn チェック状態のアイテムをstate に設定します。

checkState()も参照

void QTreeWidgetItem::setChildIndicatorPolicy(QTreeWidgetItem::ChildIndicatorPolicy policy)

アイテム インジケータpolicy を設定します。このポリシーは、ツリー分岐の展開/折りたたみインジケータを表示するタイミングを決定します。既定値はDontShowIndicatorWhenChildless です。

childIndicatorPolicy()も参照してください

[virtual] void QTreeWidgetItem::setData(int column, int role, const QVariant &value)

アイテムのcolumnrole の値を、指定されたvalue に設定する。

role は、value で指定されたデータの型を表し、Qt::ItemDataRole enum で定義されます。

注意: デフォルトの実装では、Qt::EditRoleQt::DisplayRole は同じデータを指すものとして扱われます。

data()も参照してください

void QTreeWidgetItem::setDisabled(bool disabled)

disabled が true ならばその項目を無効にし、そうでなければ有効にする。

isDisabled() およびsetFlags()も参照

void QTreeWidgetItem::setExpanded(bool expand)

expand が true ならアイテムを展開し、そうでなければアイテムを折りたたむ。

警告 この関数を呼び出す前に、QTreeWidgetItemQTreeWidget に追加しなければならない。

isExpanded()も参照

void QTreeWidgetItem::setFirstColumnSpanned(bool span)

span が true の場合は、最初のセクションをすべてのカラムにまたがるように設定します。そうでない場合は、すべての項目のセクションが表示されます。

isFirstColumnSpanned()も参照

void QTreeWidgetItem::setFlags(Qt::ItemFlags flags)

アイテムのフラグをflags に設定する。これらのフラグによって、項目を選択または変更できるかどうかが決まります。これはアイテムを無効にするためによく使われます。

flags()も参照

void QTreeWidgetItem::setFont(int column, const QFont &font)

与えられたcolumn のテキスト表示に使用されるフォントを、与えられたfont に設定します。

font(),setText(),setForeground()も参照

void QTreeWidgetItem::setForeground(int column, const QBrush &brush)

与えられたcolumn のラベルの前景ブラシを、指定されたbrush に設定する。

foreground() およびsetBackground()も参照

void QTreeWidgetItem::setHidden(bool hide)

hide が true ならアイテムを非表示にし、そうでなければアイテムを表示する。

注意: アイテムが現在ビューにない場合、この関数の呼び出しは何の効果もない。特に、アイテムに対してsetHidden(true) を呼び出してからビューに追加すると、アイテムが表示されます。

isHidden()も参照

void QTreeWidgetItem::setIcon(int column, const QIcon &icon)

与えられたcolumn に表示するアイコンをicon に設定する。

icon(),setText(),iconSizeも参照のこと

void QTreeWidgetItem::setSelected(bool select)

アイテムの選択状態をselect に設定する。

isSelected()も参照

void QTreeWidgetItem::setSizeHint(int column, const QSize &size)

与えられたcolumn のツリーアイテムのサイズヒントをsize に設定する。サイズヒントが設定されていないか、size が無効な場合、アイテムデリゲートはアイテムデータに基づいてサイズヒントを計算します。

sizeHint()も参照してください

void QTreeWidgetItem::setStatusTip(int column, const QString &statusTip)

与えられたcolumn のステータスチップを、与えられたstatusTip に設定する。 この機能を動作させるには、QTreeWidget マウストラッキングが有効になっている必要がある。

statusTip()、setToolTip()、setWhatsThis()も参照

void QTreeWidgetItem::setText(int column, const QString &text)

与えられたcolumn に表示されるテキストを、与えられたtext に設定する。

text(),setFont(),setForeground()も参照

[since 6.4] void QTreeWidgetItem::setTextAlignment(int column, Qt::Alignment alignment)

与えられたcolumn のラベルのテキストアライメントを、指定されたalignment に設定します。

この関数は Qt 6.4 で導入されました。

textAlignment()も参照してください

void QTreeWidgetItem::setToolTip(int column, const QString &toolTip)

与えられたcolumn のツールチップをtoolTip に設定する。

toolTip(),setStatusTip(),setWhatsThis()も参照

void QTreeWidgetItem::setWhatsThis(int column, const QString &whatsThis)

指定されたcolumn の "What's This?" ヘルプをwhatsThis に設定する。

whatsThis(),setStatusTip(),setToolTip()も参照

QSize QTreeWidgetItem::sizeHint(int column) const

指定されたcolumn (QSize を参照) のツリーアイテムに設定されたサイズヒントを返します。

setSizeHint()も参照してください

void QTreeWidgetItem::sortChildren(int column, Qt::SortOrder order)

与えられたorder を使って、与えられたcolumn の値でアイテムの子をソートする。

注意: この関数は、アイテムがQTreeWidget に関連付けられていない場合は何もしません。

QString QTreeWidgetItem::statusTip(int column) const

与えられたcolumn の内容のステータスチップを返す。

setStatusTip()も参照

QTreeWidgetItem *QTreeWidgetItem::takeChild(int index)

index にあるアイテムを削除して返す。そうでなければ 0 を返す。

QList<QTreeWidgetItem *> QTreeWidgetItem::takeChildren()

そうでなければ空のリストを返します。

QString QTreeWidgetItem::text(int column) const

指定されたcolumn のテキストを返す。

setText()も参照

int QTreeWidgetItem::textAlignment(int column) const

与えられたcolumn のラベルのテキスト配置を返す。

注意: この関数は歴史的な理由から int を返します。Qt 7 ではQt::Alignment を返すように修正されます。

setTextAlignment() およびQt::Alignmentも参照してください

QString QTreeWidgetItem::toolTip(int column) const

与えられたcolumn のツールチップを返します。

setToolTip()も参照

QTreeWidget *QTreeWidgetItem::treeWidget() const

アイテムを含むツリーウィジェットを返します。

int QTreeWidgetItem::type() const

QTreeWidgetItem コンストラクタに渡された型を返します。

QString QTreeWidgetItem::whatsThis(int column) const

与えられたcolumn の内容に関する "What's This?" ヘルプを返す。

setWhatsThis()も参照

[virtual] void QTreeWidgetItem::write(QDataStream &out) const

アイテムをストリームout に書き込む。これは、1つの項目のデータのみを書き込みます。

read()も参照のこと

[virtual] bool QTreeWidgetItem::operator<(const QTreeWidgetItem &other) const

項目のテキストがother 項目のテキストより小さい場合はtrue を返し、そうでない場合はfalse を返す。

QTreeWidgetItem &QTreeWidgetItem::operator=(const QTreeWidgetItem &other)

other のデータとフラグをこの項目に割り当てる。type() とtreeWidget() はコピーされないことに注意。

この関数は、clone() を再実装するときに便利である。

data() およびflags()も参照

関連する非会員

QDataStream &operator<<(QDataStream &out, const QTreeWidgetItem &item)

ツリー・ウィジェット項目item をストリームout に書き込む。

この演算子はQTreeWidgetItem::write() を使用します。

Qt データ型のシリアライズも参照してください

QDataStream &operator>>(QDataStream &in, QTreeWidgetItem &item)

ストリームin からツリー・ウィジェット・アイテムをitem に読み込む。

この演算子はQTreeWidgetItem::read() を使用します。

Qt データ型のシリアライズも参照してください

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