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 列のみからなるリストやツリーを構築する際、この関数を使用すると、単一の新しい項目を簡単に追加することができます。

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)

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

insertColumns() およびinsertRow()も参照してください 。

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

count 列分の子項目を、column 列に挿入します。

insertColumn() およびinsertRows()も参照してください 。

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

row の位置に、items を含む行を挿入します。必要に応じて、列数はitems のサイズに合わせて増えます。

insertRows() およびinsertColumn()も参照してください 。

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

row の位置に、item を含む行を挿入します。

列が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 における親項目の状態を自動的に管理できるようになります（すべての子項目がチェックされている場合はチェックされ、すべての子項目がチェックされていない場合はチェックされず、一部の子項目のみがチェックされている場合は部分的にチェックされます）。

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)

この項目がトライステートであり、ユーザーによって制御されるかどうかを設定します。tristate が true の場合、ユーザーは 3 つの異なる状態を切り替えることができます。そうでない場合、この項目は 2 つの状態を持つチェックボックスとして機能します。（なお、これには項目がチェック可能であることも必要となります。isCheckable() を参照してください。）

isUserTristate()、setCheckable()、およびsetCheckState()も参照してください 。

void QStandardItem::setWhatsThis(const QString &whatsThis)

アイテムの「これは何？」ヘルプを、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

その項目の「これは何？」ヘルプを返します。

setWhatsThis()、toolTip()、およびstatusTip()も参照してください 。

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

アイテムをストリーム `out` に書き込みます。書き込まれるのはアイテムのデータとフラグのみであり、子アイテムは書き込まれません。

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

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

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

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

sortChildren() およびQStandardItemModel::sort() は、項目のソートを行う際にこの関数を使用します。独自のソートをしたい場合は、QStandardItem をサブクラス化し、この関数を再実装することができます。

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

other のデータとフラグをこの項目に割り当てます。なお、type() およびmodel() の値はコピーされません。

この関数は、clone() を再実装する際に役立ちます。