QQuickTest Namespace
El espacio de nombres QQuickTest contiene todas las funciones y macros relacionadas con las pruebas de Qt Quick. Más información...
| Header: | #include <QtQuickTest> |
Funciones
| bool | qIsPolishScheduled(const QQuickItem *item) |
(since 6.4) bool | qIsPolishScheduled(const QQuickWindow *window) |
(since 6.4) bool | qWaitForPolish(const QQuickItem *item, int timeout = defaultTimeout) |
(since 6.4) bool | qWaitForPolish(const QQuickWindow *window, int timeout = defaultTimeout) |
Macros
(since 6.10) | QTRY_VERIFY_ACTIVE_FOCUS(item) |
| QUICK_TEST_MAIN(name) | |
| QUICK_TEST_MAIN_WITH_SETUP(name, QuickTestSetupClass) | |
(since 6.10) | QVERIFY_ACTIVE_FOCUS(item) |
Descripción detallada
Consulta la Introducción a « Qt Quick Test » para obtener información sobre cómo escribir pruebas unitarias de « Qt Quick ».
Para vincular la biblioteca C++ de Qt Quick Test, consulta Qt Quick Test C++ API.
Véase también Ejecución depruebas de C++ antes de las pruebas de QML.
Documentación de funciones
bool QQuickTest::qIsPolishScheduled(const QQuickItem *item)
Devuelve « true » si no se ha llamado a « updatePolish()» en « item » desde la última llamada a « polish()»; en caso contrario, devuelve « false ».
Al asignar valores a propiedades en QML, es posible que cualquier ajuste de diseño que el elemento deba realizar como resultado de la asignación no surta efecto inmediatamente, sino que se posponga hasta que el elemento se haya actualizado. En estos casos, puedes utilizar esta función para asegurarte de que el elemento se haya actualizado antes de que continúe la ejecución de la prueba. Por ejemplo:
QVERIFY(QQuickTest::qIsPolishScheduled(item));
QVERIFY(QQuickTest::qWaitForItemPolished(item));Sin la llamada a ` qIsPolishScheduled() ` anterior, la llamada a ` qWaitForItemPolished() ` podría detectar que no se ha programado ningún pulido y, por lo tanto, pasar al instante, dando por hecho que el elemento ya se había pulido. Esta función deja claro por qué un elemento no se ha pulido y permite que las pruebas fallen prematuramente en tales circunstancias.
El equivalente en QML de esta función es isPolishScheduled().
Véase también QQuickItem::polish() y QQuickItem::updatePolish().
[since 6.4] bool QQuickTest::qIsPolishScheduled(const QQuickWindow *window)
Devuelve ` true ` si hay algún elemento gestionado por esta ventana para el que ` qIsPolishScheduled(item) ` devuelva ` true`; en caso contrario, devuelve ` false`.
Por ejemplo, si un elemento en algún lugar de la escena puede estar pulido o no, pero necesitas esperar a que lo esté, puedes utilizar el siguiente código:
if (QQuickTest::qIsPolishScheduled(window))
QVERIFY(QQuickTest::qWaitForPolish(window));El equivalente en QML de esta función es ` isPolishScheduled()`.
Esta función sobrescribe QQuickTest::qIsPolishScheduled().
Esta función se introdujo en Qt 6.4.
Véase también QQuickItem::polish(), QQuickItem::updatePolish() y QQuickTest::qWaitForPolish().
[since 6.4] bool QQuickTest::qWaitForPolish(const QQuickItem *item, int timeout = defaultTimeout)
Espera timeout milisegundos o hasta que se haya llamado a updatePolish() en item.
Devuelve true si se ha llamado a updatePolish() en item en un plazo de timeout milisegundos; en caso contrario, devuelve false.
Esta función se introdujo en Qt 6.4.
Véase también QQuickItem::polish(), QQuickItem::updatePolish() y QQuickTest::qIsPolishScheduled().
[since 6.4] bool QQuickTest::qWaitForPolish(const QQuickWindow *window, int timeout = defaultTimeout)
Espera timeout milisegundos o hasta que qIsPolishScheduled(item) devuelva false para todos los elementos gestionados por window.
Devuelve true si qIsPolishScheduled(item) devuelve «false» para todos los elementos en un plazo de timeout milisegundos; en caso contrario, devuelve false.
El equivalente en QML de esta función es waitForPolish().
Esta función se introdujo en Qt 6.4.
Véase también QQuickItem::polish(), QQuickItem::updatePolish() y QQuickTest::qIsPolishScheduled().
Documentación de macros
[since 6.10] QTRY_VERIFY_ACTIVE_FOCUS(item)
Esta macro realiza la misma comprobación que QVERIFY_ACTIVE_FOCUS con item, pero de forma repetida, hasta que la condición se cumpla o se alcance el tiempo de espera (en milisegundos). Entre cada evaluación, se procesarán los eventos. Si se alcanza el tiempo de espera, se registra un error en el registro de pruebas y la prueba no se seguirá ejecutando.
Nota: Esta macro solo se puede utilizar en una función de prueba invocada por el marco de pruebas.
Esta macro se introdujo en Qt 6.10.
QUICK_TEST_MAIN(name)
Configura el punto de entrada para una aplicación de pruebas de Qt Quick. El argumento name identifica de forma única este conjunto de pruebas.
#include <QtQuickTest>
QUICK_TEST_MAIN(example)Nota: La macro da por hecho que los archivos fuente de las pruebas se encuentran en el directorio actual, a menos que se haya definido la variable de entorno QUICK_TEST_SOURCE_DIR.
Véase también QUICK_TEST_MAIN_WITH_SETUP() y Ejecución de pruebas de Qt Quick .
QUICK_TEST_MAIN_WITH_SETUP(name, QuickTestSetupClass)
Configura el punto de entrada de una aplicación de pruebas de Qt Quick. El argumento name identifica de forma única este conjunto de pruebas.
Esta macro es idéntica a QUICK_TEST_MAIN(), salvo que admite un argumento adicional, QuickTestSetupClass, que es el tipo de una clase derivada de QObject que se instanciará. Con esta clase es posible definir código de configuración adicional que se ejecutará antes de ejecutar la prueba QML.
Nota: La macro da por hecho que los archivos fuente de las pruebas se encuentran en el directorio actual, a menos que se haya definido la variable de entorno QUICK_TEST_SOURCE_DIR.
El siguiente fragmento de código muestra el uso de esta macro:
// src_qmltest_qquicktest.cpp
#include <QtQuickTest>
#include <QQmlEngine>
#include <QQmlContext>
#include <QGuiApplication>
class Setup : public QObject
{
Q_OBJECT
public:
Setup() {}
public slots:
void applicationAvailable()
{
// Initialization that only requires the QGuiApplication object to be available
}
void qmlEngineAvailable(QQmlEngine *engine)
{
// Initialization requiring the QQmlEngine to be constructed
engine->rootContext()->setContextProperty("myContextProperty", QVariant(true));
}
void cleanupTestCase()
{
// Implement custom resource cleanup
}
};
QUICK_TEST_MAIN_WITH_SETUP(mytest, Setup)
#include "src_qmltest_qquicktest.moc"Véase también QUICK_TEST_MAIN() y Ejecución de pruebas de Qt Quick .
[since 6.10] QVERIFY_ACTIVE_FOCUS(item)
Comprueba si el objeto « item » (que debe derivarse de « QQuickItem ») tiene un « active focus ». Si es así, la ejecución continúa. En caso contrario, se registra un error en el registro de pruebas y la prueba no se ejecuta más allá de ese punto. El mensaje de error contiene información específica del foco que resulta relevante para diagnosticar la causa del error.
Nota: Esta macro solo se puede utilizar en una función de prueba invocada por el marco de pruebas.
Esta macro se introdujo en Qt 6.10.
© 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.