QStandardItem Class

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

QStandardItem::QStandardItem()

アイテムを構築する。

[explicit] QStandardItem::QStandardItem(const QString &text)

与えられたtext でアイテムを構築する。

QStandardItem::QStandardItem(const QIcon &icon, const QString &text)

与えられたicon とtext でアイテムを構築する。

[explicit] QStandardItem::QStandardItem(int rows, int columns = 1)

rows 行、columns 列の子アイテムを持つアイテムを構築します。

[protected] QStandardItem::QStandardItem(const QStandardItem &other)

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

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

[virtual noexcept] QStandardItem::~QStandardItem()

アイテムを破壊する。これにより、アイテムの子も破壊される。

QString QStandardItem::accessibleDescription() const

アイテムのアクセシブルな説明を返します。

アクセシブルな説明は、支援技術 (すなわち、従来の対話手段を使用できないユーザー) によって使用されます。

setAccessibleDescription() およびaccessibleText()も参照 。

QString QStandardItem::accessibleText() const

アイテムのアクセシブルテキストを返します。

アクセシブル・テキストは、支援技術（すなわち、従来の対話手段を使用できないユーザー）により使用されます。

setAccessibleText() およびaccessibleDescription()も参照して ください。

void QStandardItem::appendColumn(const QList<QStandardItem *> &items)

items を含む列を追加する。必要であれば、行数はitems のサイズまで増やされる。

insertColumn()も参照のこと 。

void QStandardItem::appendRow(const QList<QStandardItem *> &items)

items を含む行を追加する。必要であれば、列数はitems のサイズまで増加される。

insertRow()も参照のこと 。

void QStandardItem::appendRow(QStandardItem *item)

これはオーバーロードされた関数である。

item を含む行を追加します。

リストや、列が1つしかないツリーを作成するとき、この関数は、新しい項目を1つ追加する便利な方法を提供します。

void QStandardItem::appendRows(const QList<QStandardItem *> &items)

items を含む行を追加する。列数は変更されない。

insertRow()も参照のこと 。

QBrush QStandardItem::background() const

アイテムの背景のレンダリングに使用したブラシを返します。

foreground() およびsetBackground()も参照 ください。

Qt::CheckState QStandardItem::checkState() const

アイテムのチェック状態を返します。

setCheckState() およびisCheckable()も参照 ください。

QStandardItem *QStandardItem::child(int row, int column = 0) const

(row,column) に子アイテムが設定されている場合はそれを返し、そうでない場合はnullptr を返す。

setChild()、takeChild() およびparent()も参照 。

void QStandardItem::clearData()

以前に設定されたすべてのロールのデータを削除します。

data() およびsetData()も参照してください 。

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

この項目のコピーを返します。アイテムの子はコピーされません。

QStandardItem をサブクラス化する場合は、この関数を再実装してQStandardItemModel にファクトリを提供し、それを使用してオンデマンドで新しいアイテムを作成することができます。

QStandardItemModel::setItemPrototype() およびoperator=()も参照してください 。

int QStandardItem::column() const

親テーブルの子テーブルでアイテムが存在するカラムを返すか、アイテムに親がない場合は -1 を返します。

row() およびparent()も参照 。

int QStandardItem::columnCount() const

項目が持つ子項目の列の数を返します。

setColumnCount() およびrowCount()も参照 ください。

[virtual] QVariant QStandardItem::data(int role = Qt::UserRole + 1) const

指定されたrole に対するアイテムのデータ、またはロールのデータがない場合は無効なQVariant を返します。

この関数を再実装する場合、その再実装では、扱っていないロールの基本実装を呼び出す必要があります。そうでない場合、flags()、isCheckable()、isEditable()などを呼び出してフラグを取得しても動作しません。

setData()も参照 。

[protected] void QStandardItem::emitDataChanged()

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

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

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

Qt::ItemFlags QStandardItem::flags() const

アイテムのアイテムフラグを返します。

アイテムフラグによって、ユーザーがアイテムをどのように操作できるかが決まります。

デフォルトでは、アイテムは有効、編集可能、選択可能、チェック可能で、ドラッグ＆ドロップ操作のソースとしてもドロップターゲットとしても使用できます。

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

QFont QStandardItem::font() const

アイテムのテキストのレンダリングに使用されたフォントを返します。

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

QBrush QStandardItem::foreground() const

アイテムの前景（テキストなど）のレンダリングに使用したブラシを返します。

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

bool QStandardItem::hasChildren() const

このアイテムに子がある場合はtrue を返し、そうでない場合はfalse を返す。

rowCount(),columnCount(),child()も参照 。

QIcon QStandardItem::icon() const

アイテムのアイコンを返します。

setIcon() およびiconSizeも参照 。

QModelIndex QStandardItem::index() const

このアイテムに関連付けられているQModelIndex を返します。

QModelIndex ベースの API (QAbstractItemView など) でアイテムの機能を呼び出す必要がある場合、この関数を呼び出して、モデル内のアイテムの位置に対応するインデックスを取得することができます。

アイテムがモデルに関連付けられていない場合、無効なQModelIndex が返されます。

model() およびQStandardItemModel::itemFromIndex()も参照してください 。

void QStandardItem::insertColumn(int column, const QList<QStandardItem *> &items)

items を含む列をcolumn に挿入する。必要に応じて、行数はitems のサイズまで増加される。

insertColumns() およびinsertRow()も参照のこと 。

void QStandardItem::insertColumns(int column, int count)

子項目のcount 列をcolumn 列に挿入する。

insertColumn() およびinsertRows()も参照 。

void QStandardItem::insertRow(int row, const QList<QStandardItem *> &items)

items を含む行をrow に挿入する。必要であれば、列数はitems のサイズまで増加される。

insertRows() およびinsertColumn()も参照のこと 。

void QStandardItem::insertRow(int row, QStandardItem *item)

これはオーバーロードされた関数である。

item を含む行をrow に挿入する。

リストや1つの列しかないツリーを作成するとき、この関数は1つの新しい項目を挿入する便利な方法を提供します。

void QStandardItem::insertRows(int row, const QList<QStandardItem *> &items)

row にitems を挿入する。カラム数は変更されない。

insertRow() およびinsertColumn()も参照のこと 。

void QStandardItem::insertRows(int row, int count)

row 行にcount 行の子項目を挿入する。

insertRow() およびinsertColumns()も参照 。

bool QStandardItem::isAutoTristate() const

アイテムがトライステートであり、QTreeWidget によって制御されているかどうかを返します。

デフォルト値は false です。

setAutoTristate()、isCheckable() およびcheckState()も参照 。

bool QStandardItem::isCheckable() const

項目がユーザーチェック可能かどうかを返します。

デフォルト値は false です。

setCheckable()、checkState()、isUserTristate() およびisAutoTristate()も参照 。

bool QStandardItem::isDragEnabled() const

項目がドラッグ可能かどうかを返します。ドラッグ可能なアイテムは、ユーザがドラッグすることができます。

デフォルト値は true です。

アイテムをドラッグするには、ビューでドラッグが有効になっている必要があることに注意してください;QAbstractItemView::dragEnabled を参照してください。

setDragEnabled(),isDropEnabled(),flags()も参照してください 。

bool QStandardItem::isDropEnabled() const

アイテムがドロップ可能かどうかを返します。アイテムがドロップ可能な場合、ドロップターゲットとして使用することができます。

デフォルト値は true です。

setDropEnabled(),isDragEnabled(),flags()も参照 。

bool QStandardItem::isEditable() const

アイテムがユーザによって編集可能かどうかを返します。

アイテムが編集可能な場合（有効な場合）、ユーザはビューの編集トリガのいずれかを呼び出すことでアイテムを編集することができます;QAbstractItemView::editTriggers を参照してください。

デフォルト値はtrueです。

setEditable() およびflags()も参照してください 。

bool QStandardItem::isEnabled() const

項目が有効かどうかを返します。

アイテムが有効な場合、ユーザはそのアイテムと対話することができる。可能な対話のタイプは、isEditable() やisSelectable() などの他の項目フラグによって指定されます。

デフォルト値はtrueです。

setEnabled() およびflags()も参照して ください。

bool QStandardItem::isSelectable() const

項目がユーザーによって選択可能かどうかを返します。

デフォルト値は true。

setSelectable() およびflags()も参照 。

bool QStandardItem::isUserTristate() const

つまり、アイテムが3つの別々の状態でチェック可能で、ユーザーが3つの状態すべてを循環させることができるかどうかを返します。

デフォルト値は false です。

setUserTristate()、isCheckable() およびcheckState()も参照 ください。

QStandardItemModel *QStandardItem::model() const

このアイテムが属するQStandardItemModel を返す。

アイテムがモデルに属する他のアイテムの子でない場合、この関数はnullptr を返します。

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

[virtual, since 6.0] void QStandardItem::multiData(QModelRoleDataSpan roleDataSpan) const

roleDataSpan スパンをこの項目のデータで埋めます。

デフォルトの実装では、スパン内の各ロールに対してdata() を呼び出すだけです。

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

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

QStandardItem *QStandardItem::parent() const

アイテムの親アイテムを返し、アイテムに親がない場合はnullptr を返します。

child() およびQStandardItemModel::invisibleRootItem()も参照して ください。

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

ストリームin からアイテムを読み込む。項目のデータとフラグだけが読み込まれ、子項目は読み込まれません。

write()も参照 。

void QStandardItem::removeColumn(int column)

与えられたcolumn を削除する。その列にあった項目は削除されます。

takeColumn()、removeColumns() およびremoveRow()も参照 。

void QStandardItem::removeColumns(int column, int count)

カラムcolumn のcount カラムを削除する。これらのカラムにあった項目は削除されます。

removeColumn() およびremoveRows()も参照 。

void QStandardItem::removeRow(int row)

与えられたrow を削除する。その行にあった項目が削除されます。

takeRow()、removeRows() およびremoveColumn()も参照してください 。

void QStandardItem::removeRows(int row, int count)

row 行のcount 行を削除する。これらの行にあった項目は削除されます。

removeRow() およびremoveColumn()も参照 。

int QStandardItem::row() const

項目が親の子テーブルにある行を返すか、項目が親を持たない場合は -1 を返します。

column() およびparent()も参照 。

int QStandardItem::rowCount() const

項目が持つ子項目の行数を返します。

setRowCount() およびcolumnCount()も参照 ください。

void QStandardItem::setAccessibleDescription(const QString &accessibleDescription)

アイテムのアクセス可能な説明を、accessibleDescription で指定された文字列に設定します。

アクセシブルな説明は、支援技術 (すなわち、従来の対話手段を使用できないユーザー) によって使用されます。

accessibleDescription() およびsetAccessibleText()も参照 。

void QStandardItem::setAccessibleText(const QString &accessibleText)

アイテムのアクセシブル・テキストをaccessibleText で指定された文字列に設定します。

アクセシブル・テキストは、支援技術（すなわち、従来の対話手段を使用できないユーザー）により使用されます。

accessibleText() およびsetAccessibleDescription()も参照して ください。

void QStandardItem::setAutoTristate(bool tristate)

tristate がtrue である場合、そのアイテムが三状態であり、QTreeWidget によって制御されていることを決定する。これにより、QTreeWidget の親アイテムの状態を自動的に管理できるようになります (すべての子がチェックされている場合は checked、すべての子がチェックされていない場合は unchecked、一部の子だけがチェックされている場合は partially checked)。

isAutoTristate()、setCheckable()、setCheckState()も参照 。

void QStandardItem::setBackground(const QBrush &brush)

アイテムの背景ブラシを指定されたbrush に設定します。

background() およびsetForeground()も参照 。

void QStandardItem::setCheckState(Qt::CheckState state)

アイテムのチェック状態をstate に設定する。

checkState() およびsetCheckable()も参照 。

void QStandardItem::setCheckable(bool checkable)

アイテムがユーザーチェック可能かどうかを設定します。checkable が true の場合、アイテムはユーザがチェックできます。そうでない場合、ユーザはアイテムをチェックできません。

そうでない場合、ユーザはアイテムをチェックできません。アイテムデリゲートは、アイテムのテキストの横にチェックボックスを持つチェック可能なアイテムをレンダリングします。

isCheckable(),setCheckState(),setUserTristate(),setAutoTristate()も参照してください 。

void QStandardItem::setChild(int row, int column, QStandardItem *item)

(row,column) の子アイテムをitem に設定します。 このアイテム（親アイテム）はitem の所有権を持ちます。 必要に応じて、行数と列数がアイテムに合わせて増やされます。

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

void QStandardItem::setChild(int row, QStandardItem *item)

これはオーバーロードされた関数である。

row の子をitem に設定します。

void QStandardItem::setColumnCount(int columns)

子項目の列の数をcolumns に設定する。これがcolumnCount() より小さい場合、不要な列のデータは破棄される。

columnCount() およびsetRowCount()も参照して ください。

[virtual] void QStandardItem::setData(const QVariant &value, int role = Qt::UserRole + 1)

指定されたrole の項目データを、指定されたvalue に設定する。

QStandardItem をサブクラス化してこの関数を再実装する場合、その再実装は次のようにします：

• setData() の基本実装を呼び出さない場合は、emitDataChanged() を呼び出します。これにより、モデルを使用するビューなどに変更が通知されるようになります。
• そうしないと、setFlags()、setCheckable()、setEditable() などを呼び出してフラグを設定しても動作しません。

Qt::ItemDataRole 、data （）、setFlags （）も参照 。

void QStandardItem::setDragEnabled(bool dragEnabled)

アイテムがドラッグ可能かどうかを設定します。dragEnabled が true の場合、ユーザーはアイテムをドラッグできます。そうでない場合、ユーザーはアイテムをドラッグできません。

アイテムのドラッグがビューで有効になっていることを確認する必要もあることに注意してください;QAbstractItemView::dragEnabled を参照してください。

isDragEnabled(),setDropEnabled(),setFlags()も参照してください 。

void QStandardItem::setDropEnabled(bool dropEnabled)

アイテムがドロップ可能かどうかを設定する。dropEnabled が true の場合、アイテムはドロップターゲットとして使用できます。

また、ビューでドロップが有効になっていることを確認する必要があることに注意してください;QWidget::acceptDrops() を参照してください; そして、モデルが必要なドロップアクションをサポートしていることを確認してください;QAbstractItemModel::supportedDropActions() を参照してください。

isDropEnabled(),setDragEnabled(),setFlags()も参照して ください。

void QStandardItem::setEditable(bool editable)

アイテムが編集可能かどうかを設定します。editable が true の場合、ユーザーはアイテムを編集することができます。そうでない場合、ユーザーはアイテムを編集することができません。

そうでない場合、ユーザはアイテムを編集できません。ユーザがビューのアイテムをどのように編集できるかは、ビューの編集トリガによって決定されます;QAbstractItemView::editTriggers を参照してください。

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

void QStandardItem::setEnabled(bool enabled)

アイテムが有効かどうかを設定する。enabled が true の場合、そのアイテムは有効であり、ユーザーはそのアイテムを操作できる。enabled が false の場合、ユーザーはそのアイテムを操作できない。

このフラグは、他の項目フラグよりも優先されます。例えば、項目が有効でない場合、Qt::ItemIsSelectable フラグが設定されていても、ユーザはその項目を選択できません。

isEnabled()、Qt::ItemIsEnabled 、setFlags()も参照のこと 。

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

アイテムのアイテムフラグをflags に設定します。

アイテムフラグは、ユーザがアイテムをどのように操作できるかを決定します。これは、アイテムを無効にするためによく使われます。

flags() およびsetData()も参照して ください。

void QStandardItem::setFont(const QFont &font)

アイテムのテキスト表示に使用するフォントを、指定されたfont に設定します。

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

void QStandardItem::setForeground(const QBrush &brush)

アイテムの前景（テキストなど）を表示するブラシを、指定されたbrush に設定します。

foreground(),setBackground(),setFont()も参照 。

void QStandardItem::setIcon(const QIcon &icon)

アイテムのアイコンをicon に設定する。

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

void QStandardItem::setRowCount(int rows)

子項目の行数をrows に設定する。これがrowCount() より小さい場合、不要な行のデータは破棄される。

rowCount() およびsetColumnCount()も参照して ください。

void QStandardItem::setSelectable(bool selectable)

項目が選択可能かどうかを設定する。selectable が true の場合、ユーザーはその項目を選択することができ、そうでない場合、ユーザーはその項目を選択することはできません。

これらのビュー・プロパティを操作することで、選択の動作やモードを制御することができます。QAbstractItemView::selectionMode およびQAbstractItemView::selectionBehavior を参照してください。

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

void QStandardItem::setSizeHint(const QSize &size)

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

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

void QStandardItem::setStatusTip(const QString &statusTip)

アイテムのステータスチップをstatusTip で指定された文字列に設定する。

statusTip(),setToolTip(),setWhatsThis()も参照 。

void QStandardItem::setText(const QString &text)

アイテムのテキストを指定されたtext に設定します。

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

void QStandardItem::setTextAlignment(Qt::Alignment alignment)

アイテムのテキストのアライメントを指定されたalignment に設定します。

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

void QStandardItem::setToolTip(const QString &toolTip)

アイテムのツールチップをtoolTip で指定された文字列に設定する。

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

void QStandardItem::setUserTristate(bool tristate)

アイテムが3ステートで、ユーザーによってコントロールされるかどうかを設定する。もしtristate が真なら、ユーザーは3つの別々の状態を循環させることができる。そうでなければ、アイテムは2つの状態でチェック可能である。(この場合、アイテムがチェック可能である必要があることに注意してください。isCheckable() を参照してください)

isUserTristate()、setCheckable()、setCheckState()も参照 。

void QStandardItem::setWhatsThis(const QString &whatsThis)

アイテムの "What's This?" ヘルプをwhatsThis で指定された文字列に設定します。

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

QSize QStandardItem::sizeHint() const

アイテムに設定されているサイズヒントを返すか、サイズヒントが設定されていない場合は無効なQSize を返す。

サイズヒントが設定されていない場合、アイテムデリゲートはアイテムデータに基づいてサイズヒントを計算します。

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

void QStandardItem::sortChildren(int column, Qt::SortOrder order = Qt::AscendingOrder)

与えられたorder を使って、与えられたcolumn の値で項目の子をソートする。

operator<()も参照 。

QString QStandardItem::statusTip() const

アイテムのステータス情報を返します。

setStatusTip()、toolTip() およびwhatsThis()も参照 。

QStandardItem *QStandardItem::takeChild(int row, int column = 0)

(row,column) にある子項目を削除せずに取り除き、その項目へのポインタを返します。指定された位置に子がない場合、この関数はnullptr を返す。

この関数は、takeRow() やtakeColumn() とは異なり、子テーブルの次元には影響しないことに注意。

child()、takeRow()、takeColumn()も参照 。

QList<QStandardItem *> QStandardItem::takeColumn(int column)

列の項目を削除せずにcolumn を削除し、削除された項目へのポインタのリストを返す。設定されていない列の項目については、リスト内の対応するポインタはnullptr になります。

removeColumn()、insertColumn()、takeRow()も参照 。

QList<QStandardItem *> QStandardItem::takeRow(int row)

行の項目を削除せずにrow を削除し、削除された項目へのポインタのリストを返す。設定されていない行の項目については、リスト内の対応するポインタはnullptr になります。

removeRow()、insertRow()、takeColumn()も参照 。

QString QStandardItem::text() const

アイテムのテキストを返します。これは、ビューでユーザーに表示されるテキストです。

setText()も参照ください 。

Qt::Alignment QStandardItem::textAlignment() const

アイテムのテキストのアライメントを返します。

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

QString QStandardItem::toolTip() const

アイテムのツールチップを返します。

setToolTip(),statusTip(),whatsThis()も参照 。

[virtual] int QStandardItem::type() const

この項目の型を返します。この型は、カスタム・アイテムをベース・クラスと区別するために使用されます。QStandardItem をサブクラス化する場合は、この関数を再実装して、UserType 以上の新しい値を返す必要があります。

QStandardItem::Typeも参照してください 。

QString QStandardItem::whatsThis() const

アイテムの "What's This?" ヘルプを返します。

setWhatsThis(),toolTip(),statusTip()も参照 。

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

アイテムをストリームout に書き込む。項目のデータとフラグのみが書き込まれ、子項目は書き込まれません。

read()も参照 。

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

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

デフォルトの実装では、アイテムがモデルに属している場合は、アイテムのソート・ロールのデータ (QStandardItemModel::sortRole を参照) を使用して比較を実行します。そうでない場合は、アイテムのQt::DisplayRole (text()) のデータを使用して比較を実行します。

sortChildren() とQStandardItemModel::sort() は、アイテムをソートするときにこの関数を使用します。カスタムソートが必要な場合は、QStandardItem をサブクラス化し、この関数を再実装してください。

[protected] QStandardItem &QStandardItem::operator=(const QStandardItem &other)

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

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