QAbstractItemModelTester Class

Ausführliche Beschreibung

Die Klasse `QAbstractItemModelTester` ist eine Hilfsklasse zum Testen von Elementmodellen.

Bei der Implementierung eines Item-Modells (d. h. einer konkreten Unterklasse von ` QAbstractItemModel `) müssen sehr strenge Regeln eingehalten werden, die die Konsistenz für die Nutzer des Modells (Ansichten, Proxy-Modelle usw.) gewährleisten.

Beispielsweise muss bei einem bestimmten Index die Neuimplementierung von ` hasChildren()` durch ein Modell mit den Werten übereinstimmen, die von ` rowCount()` und ` columnCount()` zurückgegeben werden.

QAbstractItemModelTester hilft dabei, die häufigsten Fehler in benutzerdefinierten Elementmodellklassen zu erkennen. Durch die Durchführung einer Reihe von Tests versucht es zu überprüfen, ob der Modellstatus jederzeit konsistent ist. Die Tests werden bei jeder Änderung des Modells automatisch wiederholt.

QAbstractItemModelTester führt nicht-destruktive Tests durch, die in der Regel darin bestehen, Daten und Metadaten aus einem bestimmten Elementmodell auszulesen. QAbstractItemModelTester versucht zudem, unzulässige Änderungen am Modell vorzunehmen. In korrekt implementierten Modellen sollten solche Versuche zurückgewiesen werden, sodass keine Daten verändert werden.

Verwendung

Die Verwendung von QAbstractItemModelTester ist unkompliziert. In einem Testfall reicht es aus, eine Instanz zu erstellen und dabei das zu testende Modell an den Konstruktor zu übergeben:

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

QAbstractItemModelTester meldet Testfehler über die Protokollierungsmechanismen von „ Qt Test “.

Es ist auch möglich, QAbstractItemModelTester außerhalb eines Testfalls zu verwenden. So kann es beispielsweise sinnvoll sein, ein von einer Anwendung verwendetes Item-Modell zu testen, ohne einen expliziten Unit-Test für ein solches Modell erstellen zu müssen (was unter Umständen schwierig sein könnte). Um `QAbstractItemModelTester` außerhalb eines Testfalls zu verwenden, übergeben Sie einen der ` QAbstractItemModelTester::FailureReportingMode `-Enumeratoren an dessen Konstruktor und legen Sie so fest, wie Fehler protokolliert werden sollen.

QAbstractItemModelTester kann außerdem zusätzliche Debugging-Informationen als Protokollmeldungen unter der Protokollkategorie „ qt.modeltest “ ausgeben. Diese Debug-Protokollierung ist standardmäßig deaktiviert; Informationen zur Aktivierung finden Sie in der Dokumentation zu „ QLoggingCategory “.