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)

項目がトライステートであり、ユーザによって制御されるかどうかを設定します。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() を再実装するときに便利です。