QAbstractItemModelTester 类

详细描述

QAbstractItemModelTester 类是一个用于测试项目模型的小工具类。

在实现项目模型（即具体的 QAbstractItemModel 子类）时，必须遵守非常严格的一组规则，以确保模型的用户（视图、代理模型等）的一致性。

例如，对于给定的索引，模型对 hasChildren() 的重新实现必须与 rowCount() 和 columnCount() 返回的值一致。

QAbstractItemModelTester 帮助捕获自定义项目模型类中最常见的错误。通过执行一系列测试，它将尝试检查模型状态始终保持一致。测试将在模型每次修改时自动重复。

QAbstractItemModelTester 采用了非破坏性测试，通常包括从给定的项目模型中读取数据和元数据。QAbstractItemModelTester 还会尝试非法修改模型。在实现得当的模型中，这样的尝试应该被拒绝，不应该改变数据。

用法

使用 QAbstractItemModelTester 很简单。在一个 测试案例 中，只需创建一个实例，将需要测试的模型传递给构造函数即可。

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

QAbstractItemModelTester将通过 Qt 测试日志机制报告测试失败。

除了在测试用例中，也可以使用QAbstractItemModelTester。例如，可能需要测试一个应用程序使用的模型而无需为该模型构建显式单元测试（这可能会很具挑战性）。为了在测试用例之外使用QAbstractItemModelTester，请将其构造函数传递一个QAbstractItemModelTester::FailureReportingMode枚举值，从而指定如何记录失败。

QAbstractItemModelTester还可以在qt.modeltest日志分类下报告附加的调试信息作为日志消息。这种调试日志默认情况下是禁用的；请参阅QLoggingCategory文档，了解如何启用它。