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) |
保護された関数
void | emitDataChanged() |
関連する非メンバー
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::ShowIndicator | 0 | このアイテムは、子供がいない場合でも、展開と折りたたみのコントロールが表示されます。 |
QTreeWidgetItem::DontShowIndicator | 1 | 展開と折りたたみのコントロールは、たとえ子供がいても表示されません。ノードが強制的に開かれている場合、ユーザーはアイテムを展開または折りたたむことができません。 |
QTreeWidgetItem::DontShowIndicatorWhenChildless | 2 | 展開と折りたたみのコントロールは、アイテムに子がある場合に表示されます。 |
enum QTreeWidgetItem::ItemType
この列挙型は、ツリーウィジェットの項目を記述するために使用される型を記述します。
定数 | 値 | 説明 |
---|---|---|
QTreeWidgetItem::Type | 0 | ツリーウィジェットアイテムのデフォルトタイプ。 |
QTreeWidgetItem::UserType | 1000 | カスタムタイプの最小値。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() を再実装する場合に便利である。
[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
アイテムのcolumn とrole の値を返します。
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 に表示されているアイコンを返す。
int QTreeWidgetItem::indexOfChild(QTreeWidgetItem *child) const
指定されたchild の子アイテムのインデックスを返します。
void QTreeWidgetItem::insertChild(int index, QTreeWidgetItem *child)
子のリストのindex にchild の項目を挿入します。
もしその子がすでに他の場所に挿入されていれば、再度挿入されることはない。
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)
アイテムのcolumn とrole の値を、指定されたvalue に設定する。
role は、value で指定されたデータの型を表し、Qt::ItemDataRole enum で定義されます。
注意: デフォルトの実装では、Qt::EditRole とQt::DisplayRole は同じデータを指すものとして扱われます。
data()も参照してください 。
void QTreeWidgetItem::setDisabled(bool disabled)
disabled が true ならばその項目を無効にし、そうでなければ有効にする。
isDisabled() およびsetFlags()も参照 。
void QTreeWidgetItem::setExpanded(bool expand)
expand が true ならアイテムを展開し、そうでなければアイテムを折りたたむ。
警告 この関数を呼び出す前に、QTreeWidgetItem をQTreeWidget に追加しなければならない。
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() を再実装するときに便利である。
関連する非会員
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.