QTreeWidgetItem Class

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"));

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

[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 のツリーウィジェット項目を作成し、それを指定されたparent 内のpreceding 項目の後に挿入します。

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

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

指定されたtype に基づくツリーウィジェット項目を作成し、それを指定されたparent 内の項目に追加します。指定されたstrings のリストは、その項目の各列の項目テキストとして設定されます。

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

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

指定されたtype のツリーウィジェット項目を作成し、それをparent 内のpreceding の子項目の後に挿入します。

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()

このツリーウィジェットの項目を削除します。

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

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 に表示されるアイコンを返します。

setIcon() およびiconSizeも参照してください 。

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` から項目を読み込みます。これは、データを単一の項目にのみ読み込みます。

write()も参照してください 。

void QTreeWidgetItem::removeChild(QTreeWidgetItem *child)

child で指定されたアイテムを削除します。削除されたアイテムは、ファイルシステムから削除されることはありません。

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

指定されたcolumn 内のラベルの背景ブラシを、指定されたbrush に設定します。デフォルトのコンストラクタで生成されたブラシを設定すると、ビューはスタイルのデフォルト色を使用するようになります。

関連項目： 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 列挙型によって定義されます。

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

void QTreeWidgetItem::setDisabled(bool disabled)

disabled が true の場合は、その項目を無効にします。それ以外の場合は、その項目を有効にします。

isDisabled() およびsetFlags()も参照してください 。

void QTreeWidgetItem::setExpanded(bool expand)

expand が true の場合は項目を展開し、そうでない場合は項目を折りたたみます。

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の場合はアイテムを非表示にし、そうでない場合はアイテムを表示します。

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 の値に基づいて、そのアイテムの子要素をソートします。

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 内のラベルのテキスト配置を返します。

関連項目: ` 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 の内容に関する「これは何？」ヘルプを返します。

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()も参照してください 。