QAbstractItemModel Class

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

[explicit] QAbstractItemModel::QAbstractItemModel(QObject *parent = nullptr)

指定されたparent を使用して、抽象アイテムモデルを構築します。

[virtual noexcept] QAbstractItemModel::~QAbstractItemModel()

抽象アイテムモデルを破棄します。

[protected] void QAbstractItemModel::beginInsertColumns(const QModelIndex &parent, int first, int last)

カラムの挿入処理を開始します。

サブクラスでinsertColumns()を再実装する場合、モデルの基盤となるデータストアにデータを挿入する前に、この関数を呼び出す必要があります。

parent のインデックスは、新しい列が挿入される親に対応します。first およびlast は、挿入後に新しい列が持つ列番号です。

	モデルのアイテムに挿入する列の範囲について、最初の列番号と最後の列番号を指定します。 たとえば、図に示すように、4番目の列の前に3つの列を挿入する場合、first は4、last は6となります： beginInsertColumns(parent, 4, 6); これにより、3つの新しい列が4、5、6番目の列として挿入されます。
	列を追加する場合は、最後の列の後に挿入します。 たとえば、図に示すように、既存の6つの列（5列目で終了）のコレクションに3つの列を追加する場合、first は6、last は8となります： beginInsertColumns(parent, 6, 8); これにより、2つの新しい列が6、7、8番目の列として追加されます。

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

[protected] void QAbstractItemModel::beginInsertRows(const QModelIndex &parent, int first, int last)

行の挿入操作を開始します。

サブクラスでinsertRows()を再実装する場合、モデルの基盤となるデータストアにデータを挿入する前に、この関数を呼び出す必要があります。

parent のインデックスは、新しい行が挿入される親行に対応します。first およびlast は、新しい行が挿入された後に割り当てられる行番号です。

	モデルの項目に挿入したい行の範囲について、最初の行番号と最後の行番号を指定します。 たとえば、図に示すように、行 2 の前に 3 行を挿入する場合、first は 2、last は 4 となります： beginInsertRows(parent, 2, 4); これにより、3つの新しい行が2行目、3行目、4行目として挿入されます。
	行を追加する場合は、最後の行の後に挿入します。 たとえば、図に示すように、既存の4行（3行目で終わる）のコレクションに2行を追加する場合、first は4、last は5となります： beginInsertRows(parent, 4, 5); これにより、2つの新しい行が4行目と5行目として追加されます。

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

[protected] bool QAbstractItemModel::beginMoveColumns(const QModelIndex &sourceParent, int sourceFirst, int sourceLast, const QModelIndex &destinationParent, int destinationChild)

列の移動処理を開始します。

サブクラスを再実装する際、このメソッドを使用することで、モデル内のエンティティの移動が簡略化されます。このメソッドは、モデル内の永続インデックスの移動を担当します。これがない場合、ユーザー自身がその処理を行う必要があります。beginMoveColumnsおよびendMoveColumns を使用することは、layoutAboutToBeChanged およびlayoutChanged をchangePersistentIndex と共に直接発行する代わりに利用できます。

sourceParent インデックスは、列が移動される親に対応します。sourceFirst とsourceLast は、移動される列の最初の列番号と最後の列番号です。destinationParent インデックスは、それらの列が移動される先の親に対応します。destinationChild は、列が移動される先の列です。つまり、sourceParent 内の列sourceFirst にあるインデックスは、destinationParent 内の列destinationChild となり、その後、sourceLast までの他のすべての列が続きます。

ただし、同じ親の下で列を下に移動する場合（sourceParent とdestinationParent が等しい場合）、それらの列はdestinationChild インデックスの前に配置されます。 つまり、列 0 と 1 を移動して列 1 と 2 にする場合は、destinationChild を 3 に設定する必要があります。この場合、ソース列i （sourceFirst とsourceLast の間に位置する）の新しいインデックスは(destinationChild-sourceLast-1+i) となります。

なお、sourceParent とdestinationParent が同じ場合、destinationChild がsourceFirst からsourceLast + 1 の範囲内に入らないようにする必要があります。また、列を自身の子または祖先へ移動しようとしないよう注意してください。いずれかの条件が真の場合、このメソッドはfalse を返します。その場合は、移動操作を中止する必要があります。

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

[protected] bool QAbstractItemModel::beginMoveRows(const QModelIndex &sourceParent, int sourceFirst, int sourceLast, const QModelIndex &destinationParent, int destinationChild)

行の移動操作を開始します。

サブクラスで再実装する場合、このメソッドを使用することで、モデル内のエンティティの移動が簡略化されます。このメソッドは、モデル内の永続インデックスの移動を担当します。これがないと、ユーザー自身がその処理を行う必要があります。beginMoveRows およびendMoveRows を使用することは、layoutAboutToBeChanged やlayoutChanged を、changePersistentIndex と共に直接発行する代わりに利用できます。

sourceParent のインデックスは、行が移動される元の親に対応します。sourceFirst とsourceLast は、移動対象となる行の先頭および末尾の行番号です。destinationParent のインデックスは、それらの行が移動される先の親に対応します。destinationChild は、行が移動される先の行です。つまり、sourceParent の行sourceFirst にあるインデックスは、destinationParent の行destinationChild となり、その後、sourceLast までの他のすべての行が続きます。

ただし、同じ親の下で行を下に移動する場合（sourceParent とdestinationParent が等しい場合）、行はdestinationChild のインデックスの前に配置されます。 つまり、行 0 と 1 を移動して行 1 と 2 にする場合は、destinationChild を 3 に設定する必要があります。この場合、ソース行i （sourceFirst とsourceLast の間に位置する）の新しいインデックスは(destinationChild-sourceLast-1+i) となります。

なお、sourceParent とdestinationParent が同じ場合、destinationChild がsourceFirst からsourceLast + 1 までの範囲内に含まれていないことを確認する必要があります。また、行を自身の子要素または祖先要素のいずれかに移動しようとしないことも確認する必要があります。いずれかの条件が真の場合、このメソッドはfalse を返します。その場合は、移動操作を中止する必要があります。

	モデル内で移動させたいソース親要素内の行の範囲について、最初の行番号と最後の行番号を指定します。また、その範囲を移動させる先の親要素内の行も指定します。 たとえば、図に示すように、ソースの2行目から4行目までの3行を移動する場合、sourceFirst は2、sourceLast は4となります。これらの行を宛先の2行目の上に移動するため、destinationChild は2となります。 beginMoveRows(sourceParent, 2, 4, destinationParent, 2); これにより、ソースの2行目、3行目、4行目が、宛先ではそれぞれ2、3、4行目になります。影響を受ける他の兄弟行も、それに応じて位置がずれます。
	別の親要素に行を追加するには、それらを最後の行の後に移動させます。 たとえば、図に示すように、3つの行を既存の6行（5行目で終了）のコレクションに移動する場合、destinationChild は6となります： beginMoveRows(sourceParent, 2, 4, destinationParent, 6); これにより、対象の行は6、7、8として、対象の親の末尾に移動します。
	同じ親要素内で行を移動させるには、移動先の行を指定します。 たとえば、図に示すように、1つの項目を行2から行0へ移動させる場合、sourceFirst およびsourceLast は2となり、destinationChild は0となります。 beginMoveRows(parent, 2, 2, parent, 0); 他の行がそれに応じてずれる可能性があることに注意してください。また、同じ親要素内でアイテムを移動する際は、無効な移動や何の効果もない移動を試みてはなりません。 上記の例では、移動前にアイテム2は行2にあるため、行2（すでにそこに存在する）や行3（行3は行3より上を意味するため、すでにそこに存在する）へ移動することはできません。
	同じ親要素内の行を移動させるには、移動先の行を指定してください。 たとえば、図に示すように、1つのアイテムを行2から行4へ移動させる場合、sourceFirst およびsourceLast は2、destinationChild は4となります。 beginMoveRows(parent, 2, 2, parent, 4); なお、他の行がそれに応じてずれる場合があることに注意してください。

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

[protected] void QAbstractItemModel::beginRemoveColumns(const QModelIndex &parent, int first, int last)

カラムの削除処理を開始します。

サブクラスでremoveColumns()を再実装する場合、モデルの基盤となるデータストアからデータを削除する前に、この関数を呼び出す必要があります。

parent のインデックスは、新しいカラムが削除される親に対応します。first およびlast は、削除される最初のカラムと最後のカラムのカラム番号です。

モデル内の項目から削除する列の範囲について、最初の列番号と最後の列番号を指定します。 たとえば、図に示すように、4 列目から 6 列目までの 3 列を削除する場合、first は 4、last は 6 となります。 beginRemoveColumns(parent, 4, 6);

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

[protected] void QAbstractItemModel::beginRemoveRows(const QModelIndex &parent, int first, int last)

行の削除処理を開始します。

サブクラスでremoveRows()を再実装する場合、モデルの基になるデータストアからデータを削除する前に、この関数を呼び出す必要があります。

parent のインデックスは、新しい行が削除される親に対応します。first およびlast は、削除される行の行番号です。

モデル内の項目から削除したい行の範囲について、最初の行番号と最後の行番号を指定します。 たとえば、図に示すように、2行目から3行目までの2行を削除する場合、first は2、last は3となります： beginRemoveRows(parent, 2, 3);

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

[protected] void QAbstractItemModel::beginResetModel()

モデルのリセット操作を開始します。

リセット操作を行うと、関連付けられているすべてのビューにおいて、モデルが現在の状態にリセットされます。

モデルがリセットされると、そのモデルから以前に報告されたデータはすべて無効となり、再度クエリを実行する必要があります。また、現在のアイテムおよび選択されているアイテムもすべて無効になります。

モデルのデータが大幅に変更された場合、基になるデータソースやその構造が変更されたことを他のコンポーネントに通知するために `dataChanged()` を発行するよりも、この関数を呼び出すほうが簡単な場合があります。

モデルまたはプロキシモデル内の内部データ構造をリセットする前に、この関数を呼び出す必要があります。

この関数は、modelAboutToBeReset() シグナルを発行します。

modelAboutToBeReset()、modelReset()、およびendResetModel()も参照してください 。

[virtual] QModelIndex QAbstractItemModel::buddy(const QModelIndex &index) const

index で表される項目のバディのモデルインデックスを返します。ユーザーが項目を編集しようとした際、ビューはこの関数を呼び出して、代わりにモデル内の別の項目を編集すべきかどうかを確認します。その後、ビューはバディ項目から返されたモデルインデックスを使用してデリゲートを構築します。

この関数のデフォルトの実装では、各アイテムがそれ自体のバディとなります。

[virtual] bool QAbstractItemModel::canDropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent) const

モデルがdata のドロップを受け入れられる場合、true を返します。このデフォルトの実装では、data にmimeTypes()のリストに少なくとも1つのフォーマットが含まれているか、およびaction がモデルのsupportedDropActions()に含まれているかのみを確認します。

data をrow 、column 、parent にaction を使用してドラッグ＆ドロップできるかどうかをテストしたい場合は、カスタムモデルでこの関数を再実装してください。そのテストが必要ない場合は、この関数を再実装する必要はありません。

dropMimeData() および「アイテムビューでのドラッグ＆ドロップの使用」も参照してください 。

[virtual invokable] bool QAbstractItemModel::canFetchMore(const QModelIndex &parent) const

parent に対してさらに利用可能なデータがある場合は `true ` を返し、そうでない場合は `false` を返します。

デフォルトの実装では、常に `false` を返します。

canFetchMore() がtrue を返す場合、fetchMore() 関数を呼び出す必要があります。これは、例えばQAbstractItemView の動作です。

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

[protected] void QAbstractItemModel::changePersistentIndex(const QModelIndex &from, const QModelIndex &to)

指定されたfrom モデルインデックスと一致するQPersistentModelIndex を、指定されたto モデルインデックスに変更します。

指定されたfrom モデルインデックスと一致する永続モデルインデックスが見つからなかった場合、変更は行われません。

persistentIndexList() およびchangePersistentIndexList()も参照してください 。

[protected] void QAbstractItemModel::changePersistentIndexList(const QModelIndexList &from, const QModelIndexList &to)

指定されたfrom モデルインデックスリスト内のインデックスと一致する{QPersistentModelIndex}を、指定されたto モデルインデックスリストに変更します。

指定されたfrom モデルインデックスリスト内のインデックスと一致する永続的なモデルインデックスが見つからない場合、何も変更されません。

persistentIndexList() およびchangePersistentIndex()も参照してください 。

bool QAbstractItemModel::checkIndex(const QModelIndex &index, QAbstractItemModel::CheckIndexOptions options = CheckIndexOption::NoOption) const

この関数は、index がこのモデルに対して有効なモデルインデックスであるかどうかを検証します。有効なモデルインデックスとは、無効なモデルインデックス、あるいは以下のすべての条件を満たす有効なモデルインデックスのいずれかです：

• そのインデックスのモデルがthis であること；
• インデックスの行番号が 0 以上であること；
• インデックスの行が、その親インデックスの行数よりも小さいこと；
• インデックスの列番号が 0 以上であること；
• インデックスの列数が、その親インデックスの列数未満であること。

引数 `options ` により、これらのチェック条件の一部が変更される場合があります。`options ` に `IndexIsValid` が含まれている場合、`index ` は有効なインデックスでなければなりません。これは、有効なインデックスを前提とする `data()` や `setData()` といった関数を再実装する際に役立ちます。

options にDoNotUseParent が含まれている場合、parent()を呼び出すはずのチェックは省略されます。これにより、parent()の再実装からこの関数を呼び出すことが可能になります（そうでなければ、無限再帰が発生し、クラッシュしてしまうためです）。

options にDoNotUseParent が含まれておらず、ParentIsInvalid が含まれている場合、追加のチェックが行われます。つまり、親インデックスが無効でないか確認されます。これは、リストやテーブルなどのフラットなモデルを実装する際に有用です。こうしたモデルでは、どのモデルインデックスも有効な親インデックスを持つべきではないからです。

この関数は、すべてのチェックが成功した場合は true を返し、そうでない場合は false を返します。これにより、Q_ASSERT やその他の同様のデバッグ機構でこの関数を使用することが可能になります。何らかのチェックに失敗した場合、qt.core.qabstractitemmodel.checkindex ロギングカテゴリに警告メッセージが出力され、その失敗のデバッグに役立つ情報が含まれます。

QModelIndexも参照してください 。

[virtual, since 6.0] bool QAbstractItemModel::clearItemData(const QModelIndex &index)

指定されたindex のすべてのロールに保存されているデータを削除します。成功した場合はtrue を返し、失敗した場合はfalse を返します。データの削除に成功した場合は、dataChanged()シグナルを発火させる必要があります。基底クラスの実装ではfalse

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

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

[pure virtual invokable] int QAbstractItemModel::columnCount(const QModelIndex &parent = QModelIndex()) const

指定されたparent の子要素の列数を返します。

ほとんどのサブクラスでは、列数はparent とは無関係です。

例：

int MyModel::columnCount(const QModelIndex &parent) const
{
    Q_UNUSED(parent);
    return 3;
}

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

[private signal] void QAbstractItemModel::columnsAboutToBeInserted(const QModelIndex &parent, int first, int last)

このシグナルは、列がモデルに挿入される直前に発火します。新しい項目は、指定されたparent 項目の下、first とlast の間（両端を含む）に配置されます。

関連項目： insertColumns() およびbeginInsertColumns()。

[private signal] void QAbstractItemModel::columnsAboutToBeMoved(const QModelIndex &sourceParent, int sourceStart, int sourceEnd, const QModelIndex &destinationParent, int destinationColumn)

このシグナルは、モデル内で列が移動される直前に発火します。移動対象となるのは、指定されたsourceParent 項目の下にある、sourceStart からsourceEnd までの範囲（両端を含む）にある項目です。これらは、列destinationColumn から始まるdestinationParent へ移動されます。

注：このシグナルに接続されたコンポーネントは、モデルの寸法変更に対応するためにこのシグナルを使用します。このシグナルはQAbstractItemModel の実装によってのみ発火され、サブクラスのコードから明示的に発火することはできません。

関連項目： beginMoveRows()。

[private signal] void QAbstractItemModel::columnsAboutToBeRemoved(const QModelIndex &parent, int first, int last)

このシグナルは、モデルからカラムが削除される直前に発火します。削除対象となるのは、指定されたparent 項目の下にある、first からlast までの範囲（両端を含む）の項目です。

関連項目： removeColumns() およびbeginRemoveColumns()。

[private signal] void QAbstractItemModel::columnsInserted(const QModelIndex &parent, int first, int last)

このシグナルは、モデルに列が挿入された後に発火します。新しい項目は、指定されたparent 項目の下にある、first からlast までの範囲（両端を含む）のものです。

関連項目： insertColumns() およびbeginInsertColumns()。

[private signal] void QAbstractItemModel::columnsMoved(const QModelIndex &sourceParent, int sourceStart, int sourceEnd, const QModelIndex &destinationParent, int destinationColumn)

このシグナルは、モデル内で列が移動された後に発火します。指定されたsourceParent 項目の下にある、sourceStart からsourceEnd までの項目（両端を含む）が、列destinationColumn から始まるdestinationParent へ移動されました。

注：このシグナルに接続されたコンポーネントは、モデルの寸法変更に対応するためにこれを使用します。このシグナルはQAbstractItemModel の実装によってのみ発火され、サブクラスのコードでは明示的に発火することはできません。

関連項目： beginMoveRows()。

[private signal] void QAbstractItemModel::columnsRemoved(const QModelIndex &parent, int first, int last)

このシグナルは、モデルからカラムが削除された後に発火します。削除されるのは、指定されたparent 項目の下にある、first からlast までの範囲（両端を含む）の項目です。

関連項目： removeColumns() およびbeginRemoveColumns()。

left （QVariant ）とright （QVariant ）を比較し、その順序をweak ordering として返します。

QVariant が文字列として比較される場合、locale-aware およびcase-sensitive の比較には、オプションのcollator オブジェクトが使用されます。コラターが指定されていない場合、文字列は文字の数値的な Unicode 値のみに基づいて比較されます。これは高速ですが、多くの場合、ユーザーがユーザーインターフェースに期待する動作とは異なります。

この関数は、QAbstractItemModel::sort() の実装に適しており、比較できないバリアント値（つまり、QVariant::compare がunordered を返すような場合）に対しても弱い順序付けを提供します。これにより、順序付け可能なデータを必要とするstd::sort やstd::stable_sort での使用が安全になります。

void Model::sort(int column, Qt::SortOrder sortOrder)
{
    // Model operates on a QList<QVariant> data
    std::sort(data.begin(), data.end(), [=](const QVariant &lhs, const Variant &rhs){
        const auto ordering = compareData(lhs, rhs);
        return sortOrder == Qt::AscendingOrder ? sortOrder < 0 : sortOrder > 0;
    });
}

left QVariant が文字列を保持している場合、オプションのcollator を使用して、バリアントas strings が比較されます。

そうでない場合、実装ではQVariant::compare() を使用してleft とright を比較しますが、これは部分順序しか提供できません。比較の結果がunordered となり、かつleft とright のmeta type が同じでない場合、この関数はバリアントを共通の型にconvert しようと試み、比較を再度行います。

それでもunordered の結果が返される場合は、両方のバリアントの文字列表現が比較されます。これにより、2つの空文字列が比較される可能性がありますが、これらは{Qt::weak_ordering::}{equivalent}です。

Invalid variants 有効な値を保持しているバリアントよりも常に大きいとみなされます。

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

関連項目： 3 項比較、sort()、QVariant::compare 、およびQSortFilterProxyModel 。

[protected] QModelIndex QAbstractItemModel::createIndex(int row, int column, const void *ptr = nullptr) const

指定されたrow およびcolumn に対して、内部ポインタptr を持つモデルインデックスを作成します。

QSortFilterProxyModel を使用する場合、そのインデックスには独自の内部ポインタがあります。モデル外からこの内部ポインタにアクセスすることは推奨されません。代わりに、data() 関数を使用してください。

この関数は、モデルのサブクラスがモデルインデックスを作成する際に使用しなければならない、一貫性のあるインターフェースを提供します。

[protected] QModelIndex QAbstractItemModel::createIndex(int row, int column, quintptr id) const

指定されたrow およびcolumn に対して、内部識別子id を持つモデルインデックスを作成します。

この関数は、モデルサブクラスがモデルインデックスを作成する際に使用しなければならない一貫性のあるインターフェースを提供します。

QModelIndex::internalId()も参照してください 。

[pure virtual invokable] QVariant QAbstractItemModel::data(const QModelIndex &index, int role = Qt::DisplayRole) const

index で指定されたrole の下に格納されているデータを、 が指す項目について返します。

関連項目: Qt::ItemDataRole 、setData()、およびheaderData()。

[signal] void QAbstractItemModel::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles = QList<int>())

このシグナルは、既存のアイテムのデータが変更されるたびに発火します。

アイテムが同じ親を持つ場合、影響を受けるのはtopLeft からbottomRight までの範囲のアイテムです（両端を含む）。アイテムが同じ親を持たない場合、動作は未定義となります。

setData() 関数を再実装する場合、このシグナルを明示的に発火させる必要があります。

オプションのroles 引数を使用すると、実際に変更されたデータロールを指定できます。roles引数が空のベクトルである場合、すべてのロールが変更されたものとみなされます。roles引数内の要素の順序は、何ら意味を持ちません。

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

[virtual] bool QAbstractItemModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent)

指定されたaction で終了したドラッグ＆ドロップ操作によって渡されたdata を処理します。

データとアクションがモデルによって処理された場合は `true ` を返し、そうでない場合は `false` を返します。

指定された `row`、`column `、および `parent ` は、操作が終了したモデル内の項目の位置を示します。正しい位置でアクションを完了させるのは、モデルの責任です。

たとえば、QTreeView 内の項目に対するドロップ操作では、新しい項目が、row 、column 、およびparent で指定された項目の子として挿入されるか、あるいはその項目の兄弟として挿入されることになります。

row およびcolumn が -1 の場合、ドロップされたデータはparent に直接ドロップされたものとみなされる。通常、これはデータをparent の子要素として追加することを意味する。row およびcolumn が 0 以上の場合、ドロップは指定されたparent 内の、指定されたrow およびcolumn の直前で発生したことを意味する。

mimeTypes() メンバーは、許容される MIME タイプのリストを取得するために呼び出されます。このデフォルトの実装は、単一のデフォルト MIME タイプを返すmimeTypes() のデフォルト実装を前提としています。カスタムモデルでmimeTypes() を再実装して複数の MIME タイプを返すようにした場合は、それらを利用するためにこの関数を再実装する必要があります。

supportedDropActions()、canDropMimeData()、および「アイテムビューでのドラッグ＆ドロップの使用」も参照してください 。

[protected] void QAbstractItemModel::endInsertColumns()

カラムの挿入処理を終了します。

サブクラスでinsertColumns()を再実装する場合、モデルの基盤となるデータストアにデータを挿入した後、この関数を呼び出す必要があります。

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

[protected] void QAbstractItemModel::endInsertRows()

行の挿入処理を終了します。

サブクラスでinsertRows()を再実装する場合、モデルの基盤となるデータストアにデータを挿入した後、この関数を呼び出す必要があります。

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

[protected] void QAbstractItemModel::endMoveColumns()

列の移動操作を終了します。

サブクラスを実装する際は、モデルの基盤となるデータストア内でデータの移動を行った後、この関数を呼び出す必要があります。

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

[protected] void QAbstractItemModel::endMoveRows()

行の移動操作を終了します。

サブクラスを実装する際は、モデルの基盤となるデータストア内でデータを移動した後、この関数を呼び出す必要があります。

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

[protected] void QAbstractItemModel::endRemoveColumns()

カラムの削除処理を終了します。

サブクラスでremoveColumns()を再実装する場合、モデルの基盤となるデータストアからデータを削除した後、この関数を呼び出す必要があります。

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

[protected] void QAbstractItemModel::endRemoveRows()

行の削除処理を終了します。

サブクラスでremoveRows()を再実装する場合、モデルの基になるデータストアからデータを削除した後、この関数を呼び出す必要があります。

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

[protected] void QAbstractItemModel::endResetModel()

モデルのリセット処理を実行します。

モデルまたはプロキシモデル内の内部データ構造をリセットした後は、この関数を呼び出す必要があります。

この関数は、modelReset() シグナルを発行します。

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

[virtual invokable] void QAbstractItemModel::fetchMore(const QModelIndex &parent)

parent インデックスで指定された親を持つアイテムについて、利用可能なデータをすべて取得します。

モデルを段階的に初期化する場合は、これを再実装してください。

デフォルトの実装では何も行いません。

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

[virtual invokable] Qt::ItemFlags QAbstractItemModel::flags(const QModelIndex &index) const

指定されたindex のアイテムフラグを返します。

基底クラスの実装では、アイテム（ItemIsEnabled ）を有効にし、選択可能にする（ItemIsSelectable ）フラグの組み合わせを返します。

「Qt::ItemFlags」も参照してください 。

[virtual invokable] bool QAbstractItemModel::hasChildren(const QModelIndex &parent = QModelIndex()) const

parent に子ノードが存在する場合、true を返します。そうでない場合は、false を返します。

子要素の数を調べるには、親要素に対して `rowCount()` を使用します。

なお、特定のインデックスに `Qt::ItemNeverHasChildren ` フラグが設定されている場合、このメソッドを使用してそのインデックスに `hasChildren` があると報告することは、未定義の挙動となります。

関連項目: parent() およびindex()。

[invokable] bool QAbstractItemModel::hasIndex(int row, int column, const QModelIndex &parent = QModelIndex()) const

モデルが、parent を指定したrow およびcolumn に対して有効なQModelIndex を返す場合は、true を返し、それ以外の場合はfalse を返します。

[virtual invokable] QVariant QAbstractItemModel::headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const

指定されたヘッダー内のrole およびsection に対応するデータを、指定されたorientation で返します。

水平方向のヘッダーの場合、セクション番号は列番号に対応します。同様に、垂直方向のヘッダーの場合、セクション番号は行番号に対応します。

Qt::ItemDataRole 、setHeaderData()、およびQHeaderViewも参照してください 。

[signal] void QAbstractItemModel::headerDataChanged(Qt::Orientation orientation, int first, int last)

このシグナルは、ヘッダーが変更されるたびに発火します。orientation は、水平ヘッダーが変更されたか、垂直ヘッダーが変更されたかを示します。ヘッダー内のfirst からlast までのセクションを更新する必要があります。

setHeaderData() 関数を再実装する際は、このシグナルを明示的に発火させる必要があります。

列数や行数を変更する場合は、このシグナルを発行する必要はなく、begin/end関数を使用してください（詳細については、QAbstractItemModel クラスの説明にあるサブクラス化に関するセクションを参照してください）。

headerData()、setHeaderData()、およびdataChanged()も参照してください 。

[pure virtual invokable] QModelIndex QAbstractItemModel::index(int row, int column, const QModelIndex &parent = QModelIndex()) const

指定されたrow 、column 、およびparent で指定されたモデル内の項目のインデックスを返します。

サブクラスでこの関数を再実装する場合は、createIndex() を呼び出して、他のコンポーネントがモデル内の項目を参照するために使用できるモデルインデックスを生成してください。

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

[invokable] bool QAbstractItemModel::insertColumn(int column, const QModelIndex &parent = QModelIndex())

指定された `column ` の前に、指定された `parent ` の子項目に 1 つの列を挿入します。

列が挿入された場合はtrue を返し、そうでない場合はfalse を返します。

関連項目: ` insertColumns()`、`insertRow()`、および `removeColumn()`。

[virtual invokable] bool QAbstractItemModel::insertColumns(int column, int count, const QModelIndex &parent = QModelIndex())

これをサポートするモデルでは、指定されたcolumn の前に、count という新しい列をモデルに挿入します。各新しい列の項目は、parent モデルインデックスで表される項目の子となります。

column が0の場合、列は既存の列の先頭に追加されます。

column がcolumnCount()の場合、列は既存の列の末尾に追加されます。

parent に子要素がない場合、count 個の列を持つ単一の行が挿入されます。

列の挿入に成功した場合はtrue を返し、そうでない場合はfalse を返します。

基底クラスの実装では何も行わず、false を返します。

独自のモデルを実装する場合、挿入をサポートしたいときはこの関数を再実装できます。あるいは、データを変更するための独自の API を提供することもできます。

関連項目: insertRows()、removeColumns()、beginInsertColumns()、およびendInsertColumns()。

[invokable] bool QAbstractItemModel::insertRow(int row, const QModelIndex &parent = QModelIndex())

指定された `row ` の前に、指定された `parent ` の子項目の中に 1 行を挿入します。

行が挿入された場合は `true ` を返し、そうでない場合は `false` を返します。

関連項目: insertRows(),insertColumn(),removeRow().

[virtual invokable] bool QAbstractItemModel::insertRows(int row, int count, const QModelIndex &parent = QModelIndex())

これをサポートするモデルでは、指定されたrow の前に、count 行をモデルに挿入します。新しい行の項目は、parent モデルインデックスで表される項目の子となります。

row が0の場合、行は親の既存の行の先頭に追加されます。

row がrowCount() の場合、行は親にある既存の行の末尾に追加されます。

parent に子がない場合、count 行を含む単一の列が挿入されます。

行の挿入に成功した場合はtrue を返し、失敗した場合はfalse を返します。

独自のモデルを実装する場合、挿入をサポートしたいときはこの関数を再実装できます。あるいは、データを変更するための独自の API を提供することもできます。いずれの場合も、モデルが変更されたことを他のコンポーネントに通知するために、beginInsertRows() およびendInsertRows() を呼び出す必要があります。

関連項目： insertColumns()、removeRows()、beginInsertRows()、およびendInsertRows()。

[virtual] QMap<int, QVariant> QAbstractItemModel::itemData(const QModelIndex &index) const

指定されたindex にあるアイテムについて、モデル内のすべての事前定義済みロールの値を含むマップを返します。

マップにカスタムロールを含めるなど、この関数のデフォルトの動作を拡張したい場合は、この関数を再実装してください。

setItemData()、Qt::ItemDataRole 、およびdata()も参照してください 。

[signal] void QAbstractItemModel::layoutAboutToBeChanged(const QList<QPersistentModelIndex> &parents = QList<QPersistentModelIndex>(), QAbstractItemModel::LayoutChangeHint hint = QAbstractItemModel::NoLayoutChangeHint)

このシグナルは、モデルのレイアウトが変更される直前に発せられます。このシグナルに接続されたコンポーネントは、これを利用してモデルのレイアウトの変更に対応します。

サブクラスは、layoutAboutToBeChanged() を発行した後、永続的なモデルインデックスを更新する必要があります。

オプションのparents パラメータは、モデルのレイアウトのどの部分が変更されるかについて、より具体的な通知を行うために使用されます。空のリストは、モデル全体のレイアウトの変更を示します。parents リスト内の要素の順序は重要ではありません。オプションのhint パラメータは、モデルの再レイアウト中に何が起きているかについてのヒントを与えるために使用されます。

layoutChanged() およびchangePersistentIndex()も参照してください 。

[signal] void QAbstractItemModel::layoutChanged(const QList<QPersistentModelIndex> &parents = QList<QPersistentModelIndex>(), QAbstractItemModel::LayoutChangeHint hint = QAbstractItemModel::NoLayoutChangeHint)

このシグナルは、モデルによって公開される項目のレイアウトが変更されたとき（たとえば、モデルがソートされたときなど）に発せられます。ビューがこのシグナルを受信したら、その変更を反映するように項目のレイアウトを更新する必要があります。

QAbstractItemModel またはQAbstractProxyModel をサブクラス化する際は、項目の順序を変更したり、ビューに公開するデータの構造を変更したりする前にlayoutAboutToBeChanged() を発行し、レイアウトの変更後には layoutChanged() を発行するようにしてください。

オプションのparents パラメータは、モデルのレイアウトのどの部分が変更されているかについて、より具体的な通知を行うために使用されます。空のリストは、モデル全体のレイアウトの変更を示します。parents リスト内の要素の順序は重要ではありません。オプションのhint パラメータは、モデルのレイアウトが再構成されている間に何が起こっているかについてのヒントを与えるために使用されます。

サブクラスは、`layoutChanged()` を発行する前に、永続的なモデルインデックスをすべて更新する必要があります。つまり、構造が変更された際には：

• emitlayoutAboutToBeChanged
• 変更されるQModelIndex を覚えておいてください
• 内部データを更新する
• changePersistentIndex()を呼び出す
• layoutChanged() を発行

layoutAboutToBeChanged()、dataChanged()、headerDataChanged()、modelReset()、およびchangePersistentIndex()も参照してください 。

[virtual invokable] QModelIndexList QAbstractItemModel::match(const QModelIndex &start, int role, const QVariant &value, int hits = 1, Qt::MatchFlags flags = Qt::MatchFlags(Qt::MatchStartsWith|Qt::MatchWrap)) const

start インデックスの列にある項目のうち、指定されたrole の下に格納されているデータが、指定されたvalue と一致するもののインデックスのリストを返します。検索の実行方法は、指定されたflags によって定義されます。返されるリストが空の場合もあります。 また、たとえばプロキシモデルが使用されている場合など、リスト内の結果の順序がモデル内の順序と一致しない場合がある点にも注意してください。結果の順序を信頼することはできません。

検索はstart のインデックスから開始され、一致するデータ項目の数がhits に等しくなるか、最後の行に到達するか、あるいは検索が再びstart に到達するまで続きます。これは、flags でMatchWrap が指定されているかどうかによって異なります。すべての一致する項目を検索したい場合は、hits = -1を使用してください。

デフォルトでは、この関数はすべての項目に対して、value で指定された検索語で始まる項目を探す、ループバック付きの文字列ベースの比較を行います。

[virtual] QMimeData *QAbstractItemModel::mimeData(const QModelIndexList &indexes) const

指定されたindexes のリストに対応する、シリアライズされたデータ項目を含むオブジェクトを返します。 エンコードされたデータを記述するために使用されるフォーマットは、mimeTypes() 関数から取得されます。このデフォルトの実装では、mimeTypes() のデフォルト実装によって返されるデフォルトの MIME タイプが使用されます。カスタムモデル内でmimeTypes() を再実装して、より多くの MIME タイプを返すようにした場合は、この関数を再実装してそれらを利用するようにしてください。

indexes のリストが空の場合、またはサポートされているMIMEタイプが存在しない場合、シリアライズされた空のリストではなく、nullptr が返されます。

mimeTypes() およびdropMimeData()も参照してください 。

[virtual] QStringList QAbstractItemModel::mimeTypes() const

許可されるMIMEタイプのリストを返します。デフォルトでは、組み込みのモデルおよびビューでは内部MIMEタイプ「application/x-qabstractitemmodeldatalist 」が使用されます。

カスタムモデルでドラッグ＆ドロップ機能を実装する際、デフォルトの内部 MIME タイプ以外の形式でデータを返す場合は、この関数を再実装して、独自の MIME タイプのリストを返すようにしてください。

カスタムモデルでこの関数を再実装する場合は、この関数を呼び出すメンバー関数である `mimeData()` および `dropMimeData()` も再実装する必要があります。

mimeData() およびdropMimeData()も参照してください 。

[private signal] void QAbstractItemModel::modelAboutToBeReset()

このシグナルは、beginResetModel() が呼び出された際、モデルの内部状態（例：永続化されたモデルインデックス）が無効化される前に発せられます。

関連項目： beginResetModel() およびmodelReset()。

[private signal] void QAbstractItemModel::modelReset()

このシグナルは、モデルの内部状態（例：永続化モデルのインデックス）が無効化された後、endResetModel() が呼び出された際に発火します。

モデルがリセットされた場合、それ以前にそのモデルから取得されたすべての情報は無効であるとみなすべきであることに注意してください。これには、rowCount()、columnCount()、flags()、およびdata()やroleNames()を通じて取得されたデータなどが含まれますが、これらに限定されません。

endResetModel() およびmodelAboutToBeReset()も参照してください 。

[invokable] bool QAbstractItemModel::moveColumn(const QModelIndex &sourceParent, int sourceColumn, const QModelIndex &destinationParent, int destinationChild)

これをサポートするモデルでは、`sourceColumn ` を `sourceParent ` から `destinationParent` 配下の `destinationChild ` に移動します。

列の移動に成功した場合は `true ` を返し、そうでない場合は `false` を返します。

moveColumns() およびmoveRow()も参照してください 。

[virtual invokable] bool QAbstractItemModel::moveColumns(const QModelIndex &sourceParent, int sourceColumn, int count, const QModelIndex &destinationParent, int destinationChild)

これをサポートするモデルにおいて、親sourceParent の下にあるcount の列のうち、指定されたsourceColumn で始まるものを、親destinationParent の下にあるdestinationChild の列へ移動します。

列の移動に成功した場合は `true ` を返し、失敗した場合は `false` を返します。

基底クラスの実装では何も行わず、false を返します。

独自のモデルを実装する場合、移動機能をサポートしたいときは、この関数を再実装できます。あるいは、データを変更するための独自のAPIを提供することもできます。

beginMoveColumns() およびendMoveColumns()も参照してください 。

[invokable] bool QAbstractItemModel::moveRow(const QModelIndex &sourceParent, int sourceRow, const QModelIndex &destinationParent, int destinationChild)

これをサポートするモデルでは、`sourceRow ` を `sourceParent ` から `destinationParent` 配下の `destinationChild ` に移動します。

行の移動に成功した場合は `true ` を返し、そうでない場合は `false` を返します。

moveRows() およびmoveColumn()も参照してください 。

[virtual invokable] bool QAbstractItemModel::moveRows(const QModelIndex &sourceParent, int sourceRow, int count, const QModelIndex &destinationParent, int destinationChild)

これをサポートするモデルにおいて、親ノード `sourceParent ` 配下の `sourceRow ` から始まる `count ` 行を、親ノード `destinationParent` 配下の `destinationChild ` 行へ移動します。

行の移動に成功した場合は `true ` を返し、失敗した場合は `false` を返します。

基底クラスの実装では何も行わず、false を返します。

独自のモデルを実装する場合、移動機能をサポートしたいときはこの関数を再実装できます。あるいは、データを変更するための独自の API を提供することもできます。

beginMoveRows() およびendMoveRows()も参照してください 。

[virtual, since 6.0] void QAbstractItemModel::multiData(const QModelIndex &index, QModelRoleDataSpan roleDataSpan) const

指定されたindex に対して、リクエストされたデータをroleDataSpan に設定します。

デフォルトの実装では、スパン内の各ロールに対して単にdata()を呼び出します。サブクラスでは、この関数を再実装して、ビューへより効率的にデータを提供することができます：

void MyModel::multiData(const QModelIndex &index, QModelRoleDataSpan roleDataSpan) const
{
    for (QModelRoleData &roleData : roleDataSpan) {
        int role = roleData.role();

        // ... obtain the data for index and role ...

        roleData.setData(result);
    }
}

上記のコードスニペットでは、index は呼び出し全体を通じて同じです。これは、index の情報を取得するために必要なデータ構造へのアクセスを、1回だけで済ませることができることを意味します（関連するコードをループの外側に持ち出すことで実現）。

QModelRoleData::setData() や、同様にQVariant::setValue() の使用は、QVariant を個別に構築して単純な代入演算子を使用するよりも推奨されます。これは、前者の方法ではQModelRoleData 内に格納されているQVariant オブジェクト用にすでに割り当てられたメモリを再利用できるのに対し、後者の方法では常に新しいバリアントを割り当て、古いものを破棄してしまうためです。

なお、ビューは以前の呼び出しで使用されたスパンを引数として multiData() を呼び出す可能性があり、そのためスパンにはすでにデータが含まれている場合があります。したがって、モデルが特定のロールに対するデータを返せない場合は、対応するQModelRoleData オブジェクト内のデータを必ずクリアする必要があります。 これは、QModelRoleData::clearData() を呼び出すか、同様にデフォルト構築されたQVariant を設定するなどして行うことができます。データをクリアしなかった場合、ビューは「古い」データが対応するロールで使用されるべきものであると誤解してしまいます。

最後に、コードの重複を避けるために、サブクラスは、要素が1つだけのスパンを指定することで、data()をmultiData()を用いて再実装することもできます：

QVariant MyModel::data(const QModelIndex &index, int role) const
{
    QModelRoleData roleData(role);
    multiData(index, roleData);
    return roleData.data();
}

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

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

[pure virtual invokable] QModelIndex QAbstractItemModel::parent(const QModelIndex &index) const

指定されたindex を持つモデル項目の親を返します。項目に親がない場合は、無効なQModelIndex が返されます。

ツリーデータ構造を公開するモデルで一般的に用いられる規約として、最初の列にある項目のみが子を持つというルールがあります。その場合、サブクラスでこの関数を再実装する際、返されるQModelIndex の列は0になります。

サブクラスでこの関数を再実装する際は、QModelIndex::parent() などのQModelIndex メンバ関数を呼び出さないよう注意してください。自身のモデルに属するインデックスが単に自身の実装を呼び出してしまい、無限再帰を引き起こす恐れがあるためです。

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

[protected] QModelIndexList QAbstractItemModel::persistentIndexList() const

モデルに永続インデックスとして保存されているインデックスのリストを返します。

[invokable] bool QAbstractItemModel::removeColumn(int column, const QModelIndex &parent = QModelIndex())

指定されたparent の子項目から、指定されたcolumn を削除します。

列が削除された場合はtrue を返し、そうでない場合はfalse を返します。

関連項目: removeColumns()、removeRow()、およびinsertColumn()。

[virtual invokable] bool QAbstractItemModel::removeColumns(int column, int count, const QModelIndex &parent = QModelIndex())

これをサポートするモデルにおいて、親parent の下にある、指定されたcolumn で始まるcount 列をモデルから削除します。

列が正常に削除された場合は `true ` を返し、そうでない場合は `false` を返します。

基底クラスの実装は何も行わず、false を返します。

独自のモデルを実装する場合、削除をサポートしたいときはこの関数を再実装できます。あるいは、データを変更するための独自のAPIを提供することもできます。

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

[invokable] bool QAbstractItemModel::removeRow(int row, const QModelIndex &parent = QModelIndex())

指定された `parent ` の子アイテムから、指定された `row ` を削除します。

行が削除された場合はtrue を返し、そうでない場合はfalse を返します。

これは、removeRows() を呼び出すための便宜的な関数です。QAbstractItemModel におけるremoveRows() の実装は、何もしません。

関連項目: removeRows()、removeColumn()、およびinsertRow()。

[virtual invokable] bool QAbstractItemModel::removeRows(int row, int count, const QModelIndex &parent = QModelIndex())

これをサポートするモデルにおいて、親parent の下にある、指定されたrow で始まるcount 行をモデルから削除します。

行の削除に成功した場合は `true ` を返し、失敗した場合は `false` を返します。

基底クラスの実装は何も行わず、false を返します。

独自のモデルを実装する場合、削除機能をサポートしたいときはこの関数を再実装できます。あるいは、データを変更するための独自のAPIを提供することも可能です。

removeRow()、removeColumns()、insertColumns()、beginRemoveRows()、およびendRemoveRows()も参照してください 。

[virtual protected slot] void QAbstractItemModel::resetInternalData()

このスロットは、モデルのリセット中にモデルの内部データがクリアされた直後に呼び出されます。

このスロットは、QSortFilterProxyModel のサブクラスなど、追加データを保持する具体的なプロキシモデルのサブクラスに利便性を提供するために用意されています。

class CustomDataProxy : public QSortFilterProxyModel
{
    Q_OBJECT
public:
    CustomDataProxy(QObject *parent)
      : QSortFilterProxyModel(parent)
    {
    }

    //...

    QVariant data(const QModelIndex &index, int role) const override
    {
        if (role != Qt::BackgroundRole)
            return QSortFilterProxyModel::data(index, role);

        if (m_customData.contains(index.row()))
            return m_customData.value(index.row());
        return QSortFilterProxyModel::data(index, role);
    }

private slots:
    void resetInternalData()
    {
        m_customData.clear();
    }

private:
  QHash<int, QVariant> m_customData;
};

関連項目： modelAboutToBeReset() およびmodelReset()。

[virtual slot] void QAbstractItemModel::revert()

モデルに対して、キャッシュされた情報を破棄すべきであることを通知します。この関数は通常、行の編集に使用されます。

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

[virtual] QHash<int, QByteArray> QAbstractItemModel::roleNames() const

モデルのロール名を返します。

Qt で設定されているデフォルトのロール名は次のとおりです:

[pure virtual invokable] int QAbstractItemModel::rowCount(const QModelIndex &parent = QModelIndex()) const

指定されたparent の下にある行の数を返します。親が有効な場合、rowCountは親の子要素の数を返します。

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

[private signal] void QAbstractItemModel::rowsAboutToBeInserted(const QModelIndex &parent, int start, int end)

このシグナルは、行がモデルに挿入される直前に発火します。新しい項目は、指定されたparent 項目の下、start とend （これらを含む）の間に配置されます。

関連項目: insertRows() およびbeginInsertRows()。

[private signal] void QAbstractItemModel::rowsAboutToBeMoved(const QModelIndex &sourceParent, int sourceStart, int sourceEnd, const QModelIndex &destinationParent, int destinationRow)

このシグナルは、モデル内で行が移動される直前に発火します。移動対象となるのは、指定されたsourceParent 項目の下にある、sourceStart からsourceEnd までの範囲（両端を含む）の項目です。これらは、行destinationRow から始まるdestinationParent へ移動されます。

注：このシグナルに接続されたコンポーネントは、モデルの寸法変更に対応するためにこれを使用します。このシグナルはQAbstractItemModel の実装によってのみ発火され、サブクラスのコード内で明示的に発火することはできません。

関連項目： beginMoveRows()。

[private signal] void QAbstractItemModel::rowsAboutToBeRemoved(const QModelIndex &parent, int first, int last)

このシグナルは、モデルから行が削除される直前に発火します。削除される項目は、指定されたparent 項目の下にある、first からlast までの範囲（両端を含む）の項目です。

関連項目： removeRows() およびbeginRemoveRows()。

[private signal] void QAbstractItemModel::rowsInserted(const QModelIndex &parent, int first, int last)

このシグナルは、モデルに行が挿入された後に発火します。新しい項目は、指定されたparent 項目の下にある、first からlast までの範囲（両端を含む）のものとなります。

関連項目： insertRows() およびbeginInsertRows()。

[private signal] void QAbstractItemModel::rowsMoved(const QModelIndex &sourceParent, int sourceStart, int sourceEnd, const QModelIndex &destinationParent, int destinationRow)

このシグナルは、モデル内で行が移動された後に発信されます。指定されたsourceParent 項目の下にある、sourceStart からsourceEnd までの項目（両端を含む）が、行destinationRow から始まるdestinationParent に移動されました。

注：このシグナルに接続されたコンポーネントは、モデルの寸法変更に対応するためにこのシグナルを使用します。このシグナルはQAbstractItemModel の実装によってのみ発火され、サブクラスのコード内で明示的に発火させることはできません。

関連項目： beginMoveRows()。

[private signal] void QAbstractItemModel::rowsRemoved(const QModelIndex &parent, int first, int last)

このシグナルは、モデルから行が削除された後に発火します。削除されるのは、指定されたparent 項目の下にある、first からlast までの範囲（両端を含む）の項目です。

関連項目： removeRows() およびbeginRemoveRows()。

[virtual invokable] bool QAbstractItemModel::setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole)

index にある項目のrole データをvalue に設定します。

成功した場合はtrue を返し、そうでない場合はfalse を返します。

データの設定に成功した場合は、dataChanged() シグナルを発火させる必要があります。

基底クラスの実装はfalse を返します。編集可能なモデルでは、この関数とdata() を再実装する必要があります。

関連項目： Qt::ItemDataRole 、data()、およびitemData()。

[virtual] bool QAbstractItemModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole)

指定されたorientation を持つヘッダー内の、指定されたrole およびsection のデータを、指定されたvalue に設定します。

ヘッダーのデータが更新された場合はtrue を返し、そうでない場合はfalse を返します。

この関数を再実装する場合、headerDataChanged() シグナルを明示的に発火させる必要があります。

Qt::ItemDataRole およびheaderData()も参照してください 。

[virtual] bool QAbstractItemModel::setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles)

index にある項目のロールデータを、roles 内の関連付けられた値に設定します。これは、Qt::ItemDataRole ごとに実行されます。

成功した場合はtrue を返し、失敗した場合はfalse を返します。

roles に含まれていないロールは変更されません。

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

[virtual invokable] QModelIndex QAbstractItemModel::sibling(int row, int column, const QModelIndex &index) const

index にあるアイテムについて、row およびcolumn にある兄弟要素を返します。その位置に兄弟要素が存在しない場合は、無効なQModelIndex を返します。

sibling() は、項目の親を検索し、それを用いて指定されたrow およびcolumn にある子項目のインデックスを取得する、単なる利便性のための関数です。

このメソッドは、実装固有の最適化のためにオプションでオーバーライドすることができます。

関連項目: index()、QModelIndex::row()、およびQModelIndex::column()。

[virtual invokable] void QAbstractItemModel::sort(int column, Qt::SortOrder order = Qt::AscendingOrder)

指定されたorder 内のcolumn に基づいてモデルをソートします。

基底クラスの実装では何も行いません。

[virtual] QSize QAbstractItemModel::span(const QModelIndex &index) const

index で表される項目の行および列の範囲を返します。

[virtual slot] bool QAbstractItemModel::submit()

モデルに対し、キャッシュされた情報を永続ストレージに書き込むよう指示します。この関数は通常、行の編集に使用されます。

エラーがない場合は `true ` を返し、エラーがある場合は `false` を返します。

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

[virtual] Qt::DropActions QAbstractItemModel::supportedDragActions() const

このモデルのデータでサポートされているアクションを返します。

デフォルトの実装では、supportedDropActions() を返します。追加のアクションをサポートしたい場合は、この関数を再実装してください。

supportedDragActions() は、ドラッグが発生した際にQAbstractItemView::startDrag() によってデフォルト値として使用されます。

「 Qt::DropActions 」 および「アイテムビューでのドラッグ＆ドロップの使用」も参照してください 。

[virtual] Qt::DropActions QAbstractItemModel::supportedDropActions() const

このモデルでサポートされているドロップアクションを返します。

デフォルトの実装では、Qt::CopyAction を返します。追加のアクションをサポートしたい場合は、この関数を再実装してください。また、追加の操作を処理するために、dropMimeData() 関数も再実装する必要があります。

dropMimeData()、Qt::DropActions 、および「アイテムビューでのドラッグ＆ドロップの使用」も参照してください 。