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 文档以了解如何启用它。