En esta página

Capítulo 4: Reproducción de eventos de la interfaz gráfica de usuario

En este capítulo, mostraremos cómo simular un evento de la interfaz gráfica de usuario (GUI), y cómo almacenar una serie de eventos de la GUI, así como reproducirlos en un widget.

El método para almacenar una serie de eventos y reproducirlos es bastante similar al explicado en el capítulo 2. Lo único que hay que hacer es añadir una función de datos a la clase de prueba:

class TestGui: public QObject
{
    Q_OBJECT

private slots:
    void testGui_data();
    void testGui();
};

Escribir la función de datos

Al igual que antes, la función de datos asociada a una función de prueba lleva el mismo nombre, al que se le añade « _data ».

void TestGui::testGui_data()
{
    QTest::addColumn<QTestEventList>("events");
    QTest::addColumn<QString>("expected");

    QTestEventList list1;
    list1.addKeyClick('a');
    QTest::newRow("char") << list1 << "a";

    QTestEventList list2;
    list2.addKeyClick('a');
    list2.addKeyClick(Qt::Key_Backspace);
    QTest::newRow("there+back-again") << list2 << "";
}

En primer lugar, definimos los elementos de la tabla utilizando la función ` QTest::addColumn()`: una lista de eventos de la interfaz gráfica de usuario y el resultado esperado al aplicar dicha lista de eventos a un ` QWidget`. Ten en cuenta que el tipo del primer elemento es ` QTestEventList`.

Un ` QTestEventList ` puede rellenarse con eventos de la interfaz gráfica de usuario que pueden almacenarse como datos de prueba para su uso posterior, o reproducirse en cualquier ` QWidget`.

En nuestra función de datos actual, creamos dos elementos ` QTestEventList `. La primera lista consta de un único clic en la tecla «a». Añadimos el evento a la lista utilizando la función ` QTestEventList::addKeyClick()`. A continuación, utilizamos la función ` QTest::newRow()` para asignar un nombre al conjunto de datos e introducir la lista de eventos y el resultado esperado en la tabla.

La segunda lista consta de dos pulsaciones de tecla: una «a» seguida de una tecla «retroceso». De nuevo, utilizamos la función QTestEventList::addKeyClick() para añadir los eventos a la lista, y QTest::newRow() para introducir la lista de eventos y el resultado esperado en la tabla con un nombre asociado.

Reescritura de la función de prueba

Ahora podemos reescribir nuestra prueba:

void TestGui::testGui()
{
    QFETCH(QTestEventList, events);
    QFETCH(QString, expected);

    QLineEdit lineEdit;

    events.simulate(&lineEdit);

    QCOMPARE(lineEdit.text(), expected);
}

La función `TestGui::testGui()` se ejecutará dos veces, una por cada entrada de los datos de prueba que hemos creado en la función asociada `TestGui::testGui_data()`.

En primer lugar, recuperamos los dos elementos del conjunto de datos utilizando la macro ` QFETCH()`. La función ` QFETCH()` admite dos argumentos: el tipo de datos del elemento y el nombre del elemento. A continuación, creamos un ` QLineEdit` y aplicamos la lista de eventos a ese widget mediante la función ` QTestEventList::simulate()`.

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 a 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(tutorial4 LANGUAGES CXX)

find_package(Qt6 REQUIRED COMPONENTS Core Gui Test Widgets)

qt_standard_project_setup()

qt_add_executable(tutorial4
    testgui.cpp
)

set_target_properties(tutorial4 PROPERTIES
    WIN32_EXECUTABLE TRUE
    MACOSX_BUNDLE TRUE
)

target_link_libraries(tutorial4 PRIVATE
    Qt6::Core
    Qt6::Gui
    Qt6::Test
    Qt6::Widgets
)

install(TARGETS tutorial4
    BUNDLE  DESTINATION .
    RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
)

qt_generate_deploy_app_script(
    TARGET tutorial4
    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 Ninja

A continuación, ejecuta tu herramienta generadora preferida para compilar el ejecutable. En este caso, utilizamos Ninja:

ninja

Compilació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/tutorial4
INSTALLS += target

A continuación, ejecuta qmake y, por último, ejecuta make para compilar tu ejecutable:

qmake
make

Ejecución del ejecutable

Al ejecutar el ejecutable resultante, deberías obtener la siguiente salida:

********* Start testing of TestGui *********
Config: Using QtTest library %VERSION%, Qt %VERSION%
PASS   : TestGui::initTestCase()
PASS   : TestGui::testGui(char)
PASS   : TestGui::testGui(there+back-again)
PASS   : TestGui::cleanupTestCase()
Totals: 4 passed, 0 failed, 0 skipped, 0 blacklisted, 18ms
********* Finished testing of TestGui *********

© 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.