QAbstractItemModelTester Class
La clase `QAbstractItemModelTester` sirve para probar las subclases de ` QAbstractItemModel `. Más información...
| Encabezado: | #include <QAbstractItemModelTester> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Test) target_link_libraries(mytarget PRIVATE Qt6::Test) |
| qmake: | QT += testlib |
| Heredado de: | QObject |
Tipos públicos
| enum class | FailureReportingMode { QtTest, Warning, Fatal } |
Funciones públicas
| QAbstractItemModelTester(QAbstractItemModel *model, QObject *parent = nullptr) | |
| QAbstractItemModelTester(QAbstractItemModel *model, QAbstractItemModelTester::FailureReportingMode mode, QObject *parent = nullptr) | |
| QAbstractItemModelTester::FailureReportingMode | failureReportingMode() const |
| QAbstractItemModel * | model() const |
(since 6.4) void | setUseFetchMore(bool value) |
Descripción detallada
La clase `QAbstractItemModelTester` es una clase de utilidad para probar modelos de elementos.
Al implementar un modelo de elemento (es decir, una subclase concreta de ` QAbstractItemModel `), hay que cumplir un conjunto de reglas muy estrictas que garantizan la coherencia para los usuarios del modelo (vistas, modelos proxy, etc.).
Por ejemplo, para un índice dado, la reimplementación de ` hasChildren()` por parte de un modelo debe ser coherente con los valores devueltos por ` rowCount()` y ` columnCount()`.
QAbstractItemModelTester ayuda a detectar los errores más comunes en las clases de modelos de elementos personalizados. Mediante la realización de una serie de pruebas, intentará comprobar que el estado del modelo sea coherente en todo momento. Las pruebas se repetirán automáticamente cada vez que se modifique el modelo.
QAbstractItemModelTester emplea pruebas no destructivas, que suelen consistir en leer datos y metadatos de un modelo de elemento determinado. QAbstractItemModelTester también intentará realizar modificaciones ilegales del modelo. En los modelos que estén correctamente implementados, dichos intentos deberían ser rechazados y, en consecuencia, no debería modificarse ningún dato.
Uso
El uso de QAbstractItemModelTester es sencillo. En un caso de prueba basta con crear una instancia, pasando al constructor el modelo que se desea probar:
MyModel *modelToBeTested = ...;
auto tester = new QAbstractItemModelTester(modelToBeTested);QAbstractItemModelTester informará de los fallos en las pruebas a través de los mecanismos de registro de Qt Test.
También es posible utilizar QAbstractItemModelTester fuera de un caso de prueba. Por ejemplo, puede resultar útil probar un modelo de elementos utilizado por una aplicación sin necesidad de crear una prueba unitaria explícita para dicho modelo (lo cual podría resultar complicado). Para utilizar QAbstractItemModelTester fuera de un caso de prueba, se debe pasar uno de los enumeradores de « QAbstractItemModelTester::FailureReportingMode » a su constructor, especificando así cómo deben registrarse los fallos.
QAbstractItemModelTester también puede proporcionar información de depuración adicional en forma de mensajes de registro bajo la categoría de registro « qt.modeltest ». Este registro de depuración está desactivado por defecto; consulta la documentación de QLoggingCategory para saber cómo activarlo.
Nota: Aunque QAbstractItemModelTester es una ayuda válida para el desarrollo y las pruebas de modelos de elementos personalizados, no detecta (ni puede detectar) todos los problemas posibles en las subclases de ` QAbstractItemModel `. En particular, nunca realizará pruebas destructivas significativas de un modelo, por lo que este debe someterse a pruebas por separado.
Véase también Programación Modelo/Vista y QAbstractItemModel.
Documentación sobre los tipos de miembro
enum class QAbstractItemModelTester::FailureReportingMode
Esta enumeración especifica cómo debe notificar un error el método ` QAbstractItemModelTester ` al comprobar una subclase de ` QAbstractItemModel `.
| Constante | Valor | Descripción |
|---|---|---|
QAbstractItemModelTester::FailureReportingMode::QtTest | 0 | Los fallos se notificarán como fallos de prueba de « QtTest ». |
QAbstractItemModelTester::FailureReportingMode::Warning | 1 | Los fallos se notificarán como mensajes de advertencia en la categoría de registro « qt.modeltest ». |
QAbstractItemModelTester::FailureReportingMode::Fatal | 2 | Un fallo provocará la finalización inmediata y anómala del programa. El motivo del fallo se indicará mediante « qFatal() ». |
Documentación de la función miembro
QAbstractItemModelTester::QAbstractItemModelTester(QAbstractItemModel *model, QObject *parent = nullptr)
Crea una instancia del probador de modelos, con el parent especificado, que probará el modelo model.
El modo de notificación de errores se establece en FailureReportingMode::QtTest.
QAbstractItemModelTester::QAbstractItemModelTester(QAbstractItemModel *model, QAbstractItemModelTester::FailureReportingMode mode, QObject *parent = nullptr)
Crea una instancia del probador de modelos, con el parent indicado, que probará el modelo model, utilizando el mode especificado para informar de los fallos en las pruebas.
Véase también QAbstractItemModelTester::FailureReportingMode.
QAbstractItemModelTester::FailureReportingMode QAbstractItemModelTester::failureReportingMode() const
Devuelve el modo que utiliza esta instancia para notificar los fallos en las pruebas.
Véase también QAbstractItemModelTester::FailureReportingMode.
QAbstractItemModel *QAbstractItemModelTester::model() const
Devuelve el modelo que esta instancia está evaluando.
[since 6.4] void QAbstractItemModelTester::setUseFetchMore(bool value)
Si « value » es «true», se habilita el rellenado dinámico del modelo sometido a prueba, que es el valor por defecto. Si « value » es «false», se deshabilita.
Esta función se introdujo en Qt 6.4.
Véase también QAbstractItemModel::fetchMore().
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.