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 logging カテゴリ下のロギングメッセージとして報告することもできます。このようなデバッグロギングはデフォルトでは無効になっています; 有効にする方法についてはQLoggingCategory のドキュメントを参照してください。