QAbstractItemModelTester Class

詳細な説明

QAbstractItemModelTester クラスは、アイテムモデルをテストするためのユーティリティクラスです。

アイテムモデル（つまり、QAbstractItemModel の具体的なサブクラス）を実装する際には、モデルのユーザー（ビュー、プロキシモデルなど）にとっての一貫性を確保するために、非常に厳格な一連のルールに従わなければなりません。

たとえば、特定のインデックスに対して、モデルによる `hasChildren()` の再実装は、`rowCount()` および `columnCount()` が返す値と一貫性がなければなりません。

QAbstractItemModelTesterは、カスタムアイテムモデルクラスにおける最も一般的なエラーの検出を支援します。一連のテストを実行することで、モデルの状態が常に一貫していることを確認しようとします。これらのテストは、モデルが変更されるたびに自動的に繰り返されます。

QAbstractItemModelTester は非破壊的なテストを採用しており、通常は指定されたアイテムモデルからデータやメタデータを読み取ることで構成されます。また、QAbstractItemModelTester はモデルに対する不正な変更も試みます。適切に実装されたモデルでは、そのような試みは拒否され、その結果としてデータが変更されることはありません。

使用方法

QAbstractItemModelTester の使用方法は簡単です。テストケースでは、テスト対象のモデルをコンストラクタに渡してインスタンスを作成するだけで十分です。

MyModel *modelToBeTested = ...;
auto tester = new QAbstractItemModelTester(modelToBeTested);

QAbstractItemModelTesterは、Qt Test のロギングメカニズムを通じてテストの失敗を報告します。

また、QAbstractItemModelTesterをテストケースの外で利用することも可能です。例えば、アプリケーションで使用されるアイテムモデルを、そのモデル専用のユニットテストを明示的に作成することなく（これは困難な場合があるため）テストするのに役立つ場合があります。 テストケースの外で QAbstractItemModelTester を使用するには、QAbstractItemModelTester::FailureReportingMode の列挙型のいずれかをそのコンストラクタに渡して、失敗のログ記録方法を指定します。

QAbstractItemModelTesterは、qt.modeltest のロギングカテゴリの下で、追加のデバッグ情報をログメッセージとして報告することもあります。このようなデバッグロギングはデフォルトでは無効になっています。有効にする方法については、QLoggingCategory のドキュメントを参照してください。