Capítulo 3: Simulación de eventos de la interfaz gráfica de usuario
Qt Test presenta algunos mecanismos para probar interfaces gráficas de usuario. En lugar de simular eventos nativos del sistema de ventanas, Qt Test envía eventos internos de Qt. Esto significa que no hay efectos secundarios en el equipo en el que se ejecutan las pruebas.
Este capítulo muestra cómo escribir una prueba sencilla de interfaz gráfica de usuario.
Cómo escribir una prueba de interfaz gráfica de usuario
En esta ocasión, supongamos que quieres probar el comportamiento de nuestra clase ` QLineEdit `. Al igual que antes, necesitarás una clase que contenga tu función de prueba:
#include <QtWidgets>
#include <QTest>
class TestGui: public QObject
{
Q_OBJECT
private slots:
void testGui();
};La única diferencia es que debes incluir las definiciones de la clase ` Qt GUI `, además del espacio de nombres ` QTest `.
void TestGui::testGui()
{
QLineEdit lineEdit;
QTest::keyClicks(&lineEdit, "hello world");
QCOMPARE(lineEdit.text(), QString("hello world"));
}En la implementación de la función de prueba, primero creamos un ` QLineEdit`. A continuación, simulamos escribir «hello world» en el campo de edición de línea utilizando la función ` QTest::keyClicks()`.
Nota: El widget también debe estar visible para poder probar correctamente los atajos de teclado.
QTest::keyClicks() simula pulsar una secuencia de teclas en un widget. Opcionalmente, se puede especificar un modificador de teclado, así como un retraso (en milisegundos) de la prueba tras cada pulsación de tecla. De forma similar, puedes utilizar las funciones QTest::keyClick(), QTest::keyPress(), QTest::keyRelease(), QTest::mouseClick(), QTest::mouseDClick(), QTest::mouseMove(), QTest::mousePress() y QTest::mouseRelease() para simular los eventos de la interfaz gráfica de usuario asociados.
Por último, utilizamos la macro QCOMPARE() para comprobar si el texto del campo de edición de línea es el esperado.
Preparación del ejecutable independiente
Al igual que antes, para convertir nuestro caso de prueba en un ejecutable independiente, se necesitan las dos líneas siguientes:
QTEST_MAIN(TestGui)
#include "testgui.moc"La macro « QTEST_MAIN()» se expande en un sencillo método `main()` que ejecuta todas las funciones de prueba y, dado que tanto la declaración como la implementación de nuestra clase de prueba se encuentran en un archivo `.cpp`, también debemos incluir el archivo `moc` generado para que funcione la introspección de Qt.
Compilación del ejecutable
Puedes compilar el ejecutable del caso de prueba utilizando CMake o qmake.
Compilación con CMake
Configura los ajustes de compilación en tu archivo CMakeLists.txt:
# Copyright (C) 2022 The Qt Company Ltd.
# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
cmake_minimum_required(VERSION 3.16)
project(tutorial3 LANGUAGES CXX)
find_package(Qt6 REQUIRED COMPONENTS Core Gui Test Widgets)
qt_standard_project_setup()
qt_add_executable(tutorial3
testgui.cpp
)
set_target_properties(tutorial3 PROPERTIES
WIN32_EXECUTABLE TRUE
MACOSX_BUNDLE TRUE
)
target_link_libraries(tutorial3 PRIVATE
Qt6::Core
Qt6::Gui
Qt6::Test
Qt6::Widgets
)
install(TARGETS tutorial3
BUNDLE DESTINATION .
RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
)
qt_generate_deploy_app_script(
TARGET tutorial3
OUTPUT_SCRIPT deploy_script
NO_UNSUPPORTED_PLATFORM_ERROR
)
install(SCRIPT ${deploy_script})A continuación, desde la línea de comandos, ejecuta « cmake » o utiliza el script de conveniencia « qt-cmake », que se encuentra en « Qt-prefix/<version>/<platform>/bin/qt-cmake »:
<Qt-prefix>/<version>/<platform>/bin/qt-cmake <source-dir> <build-dir> -G NinjaA continuación, ejecuta tu herramienta generadora preferida para compilar el ejecutable. En este caso, utilizamos Ninja:
ninjaCompilación con qmake
Configura los ajustes de compilación en tu archivo .pro:
QT += widgets testlib
SOURCES = testgui.cpp
# install
target.path = $$[QT_INSTALL_EXAMPLES]/qtestlib/tutorial3
INSTALLS += targetA continuación, ejecuta qmake y, por último, ejecuta make para compilar tu ejecutable:
qmake
makeEjecución del ejecutable
Al ejecutar el ejecutable resultante, deberías obtener la siguiente salida:
© 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.