QAbstractTableModel Class

詳細な説明

QAbstractTableModel は、データを項目の 2 次元配列として表現するモデル向けの標準インターフェースを提供します。これは直接使用されるものではなく、サブクラス化する必要があります。

このモデルは、QAbstractItemModel よりもより特殊なインターフェースを提供するため、QListView にデータを提供するには使用できますが、ツリービューでの使用には適していません。単純な項目のリストを表現し、モデルに 1 列のデータのみを含める必要がある場合は、QAbstractListModel をサブクラス化するのがより適切かもしれません。

rowCount() およびcolumnCount() 関数は、テーブルの次元を返します。モデル内の項目に対応するモデルインデックスを取得するには、index() を使用し、行番号と列番号のみを指定します。

サブクラス化

QAbstractTableModel をサブクラス化する場合は、rowCount()、columnCount()、およびdata() を実装する必要があります。index() およびparent() 関数のデフォルトの実装は、QAbstractTableModel によって提供されます。適切に動作するモデルでは、headerData() も実装する必要があります。

編集可能なモデルは、setData() を実装する必要があり、またflags() を実装して、Qt::ItemIsEditable を含む値を返す必要があります。

サイズ変更可能なデータ構造へのインターフェースを提供するモデルは、insertRows()、removeRows()、insertColumns()、およびremoveColumns() の実装を提供できます。これらの関数を実装する際は、接続されたすべてのビューが変更を認識できるように、適切な関数を呼び出すことが重要です：

• insertRows() の実装では、データ構造に新しい行を挿入する前に beginInsertRows() を呼び出し、その直後に endInsertRows() を呼び出す必要があります。
• insertColumns() の実装では、データ構造に新しい列を挿入する前に beginInsertColumns() を呼び出し、その直後に endInsertColumns() を呼び出す必要があります。
• removeRows() の実装は、データ構造から行が削除される前に beginRemoveRows() を呼び出し、その直後に endRemoveRows() を呼び出さなければなりません。
• removeColumns() の実装では、データ構造から列が削除される前に beginRemoveColumns() を呼び出し、その直後に endRemoveColumns() を呼び出す必要があります。

スレッドセーフ

QObject のサブクラスである QAbstractTableModel は、thread-safe ではありません。QAbstractTableModel に関連する API は、モデルオブジェクトが存在するスレッドからのみ呼び出す必要があります。QAbstractTableModel がビューに接続されている場合、ビューはそのスレッドに存在し、そのスレッドからモデルとやり取りを行うため、QAbstractTableModel は GUI スレッド上で動作します。 バックグラウンドスレッドを使用してモデルの内容を設定または変更することは可能ですが、モデル関連のAPIを直接呼び出すことはできないため、慎重に行う必要があります。代わりに、更新内容をキューに入れ、メインスレッドで適用する必要があります。これは、キュー付き接続を使用して行うことができます。