QAbstractListModel Class

詳細説明

QAbstractListModel は、データをアイテムの単純な非階層的シーケンスとして表現するモデルのための標準インターフェースを提供します。これは直接は使用されませんが、サブクラス化する必要があります。

このモデルはQAbstractItemModel よりも特殊なインタフェースを提供するため、ツリー・ビューでの使用には適していません。そのような目的でモデルを提供したい場合は、QAbstractItemModel をサブクラス化する必要があります。データを管理するために多数のリスト・モデルを使用する必要がある場合は、代わりにQAbstractTableModel をサブクラス化する方が適切かもしれません。

単純なモデルは、このクラスをサブクラス化し、必要最小限の関数を実装することで作成できます。例えば、QListView ウィジェットに文字列のリストを提供する、単純な読み取り専用のQStringList ベースのモデルを実装することができます。このような場合、リスト内の項目数を返すrowCount() 関数と、リストから項目を取得するdata() 関数を実装するだけでよい。

モデルは1次元構造を表すので、rowCount （）関数はモデル内の項目の総数を返します。columnCount() 関数は、あらゆる種類のビューとの相互運用性を考慮して実装されていますが、デフォルトでは、モデルには1つの列しか含まれていないことをビューに通知します。

サブクラス化

QAbstractListModel をサブクラス化する際には、rowCount() およびdata() 関数の実装を提供する必要があります。お行儀の良いモデルはheaderData() の実装も提供します。

もしあなたのモデルが QML 内で使用され、roleNames() 関数によって提供されるデフォルトのロール以外のロールを必要とする場合は、オーバーライドする必要があります。

編集可能なリストモデルの場合、setData() の実装も提供し、flags() 関数がQt::ItemIsEditable を含む値を返すように実装しなければなりません。

QAbstractListModel では、columnCount （）のデフォルト実装が提供され、このモデルには項目が 1 列しかないことをビューに通知します。

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

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