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