En esta página

QTestEventList Class

La clase `QTestEventList` proporciona una lista de eventos de la interfaz gráfica de usuario. Más información...

Encabezado: #include <QTestEventList>
CMake: find_package(Qt6 REQUIRED COMPONENTS Test)
target_link_libraries(mytarget PRIVATE Qt6::Test)
qmake: QT += testlib
Heredado de: QList

Funciones públicas

QTestEventList()
QTestEventList(const QTestEventList &other)
~QTestEventList()
void addDelay(int msecs)
void addKeyClick(Qt::Key qtKey, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
void addKeyClick(char ascii, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
void addKeyClicks(const QString &keys, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
void addKeyPress(Qt::Key qtKey, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
void addKeyPress(char ascii, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
void addKeyRelease(Qt::Key qtKey, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
void addKeyRelease(char ascii, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
void addMouseClick(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)
void addMouseDClick(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)
void addMouseMove(QPoint pos = QPoint(), int delay = -1)
void addMousePress(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)
void addMouseRelease(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)
void clear()
void simulate(QWidget *w)

Descripción detallada

Una QTestEventList puede rellenarse con eventos de la interfaz gráfica de usuario (GUI) que pueden almacenarse como datos de prueba para su uso posterior, o reproducirse en cualquier QWidget. QTestEventList proporciona funciones prácticas para rellenar la lista.

Ejemplo:

QTestEventList events;
events.addKeyClick('a');
events.addKeyClick(Qt::Key_Backspace);
events.addDelay(200);
QLineEdit *lineEdit = new QLineEdit(myParent);
// ...
events.simulate(lineEdit);
events.simulate(lineEdit);

El ejemplo anterior simula que el usuario introduce el carácter a seguido de una tecla de retroceso, espera 200 milisegundos y repite la operación.

Documentación de las funciones de miembro

QTestEventList::QTestEventList()

Crea un objeto QTestEventList vacío.

QTestEventList::QTestEventList(const QTestEventList &other)

Crea un nuevo objeto `QTestEventList` como copia de ` other`.

[noexcept] QTestEventList::~QTestEventList()

Vacía la lista y elimina todos los eventos almacenados.

void QTestEventList::addDelay(int msecs)

Añade un retraso de msecs milisegundos.

Véase también QTest::qWait().

void QTestEventList::addKeyClick(Qt::Key qtKey, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)

Añade una nueva pulsación de tecla a la lista. El evento simulará la pulsación de la tecla qtKey con el modificador modifiers y, a continuación, esperará msecs milisegundos.

Véase también QTest::keyClick().

void QTestEventList::addKeyClick(char ascii, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)

Añade una nueva pulsación de tecla a la lista. El evento simulará la pulsación de la tecla « ascii » con el modificador « modifiers » y, a continuación, esperará « msecs » milisegundos.

Esta es una función sobrecargada.

Véase también QTest::keyClick().

void QTestEventList::addKeyClicks(const QString &keys, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)

Añade nuevas entradas de teclado a la lista. El evento pulsará la tecla keys con el valor modifiers y esperará msecs milisegundos entre cada tecla.

Véase también QTest::keyClicks().

void QTestEventList::addKeyPress(Qt::Key qtKey, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)

Añade una nueva pulsación de tecla a la lista. El evento pulsará la tecla qtKey con el modificador modifiers y, a continuación, esperará msecs milisegundos.

Véase también QTest::keyPress().

void QTestEventList::addKeyPress(char ascii, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)

Añade una nueva pulsación de tecla a la lista. El evento pulsará la tecla ascii con el modificador modifiers y, a continuación, esperará msecs milisegundos.

Esta es una función sobrecargada.

Véase también QTest::keyPress().

void QTestEventList::addKeyRelease(Qt::Key qtKey, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)

Añade una nueva liberación de tecla a la lista. El evento liberará la tecla qtKey con el modificador modifiers y, a continuación, esperará msecs milisegundos.

Véase también QTest::keyRelease().

void QTestEventList::addKeyRelease(char ascii, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)

Añade una nueva liberación de tecla a la lista. El evento liberará la tecla ascii con el modificador modifiers y, a continuación, esperará msecs milisegundos.

Esta es una función sobrecargada.

Véase también QTest::keyRelease().

void QTestEventList::addMouseClick(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Añade un clic del ratón a la lista. El evento hará clic en button con un modifiers opcional en la posición pos con un delay opcional. La posición por defecto es el centro del widget.

Véase también QTest::mouseClick().

void QTestEventList::addMouseDClick(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Añade un doble clic con el ratón a la lista. El evento realizará un doble clic en button con un modifiers opcional en la posición pos con un delay opcional. La posición por defecto es el centro del widget.

Véase también QTest::mousePress().

void QTestEventList::addMouseMove(QPoint pos = QPoint(), int delay = -1)

Añade un movimiento del ratón a la lista. El evento desplazará el ratón a la posición pos. Si se establece un « delay » (en milisegundos), la prueba esperará un tiempo tras mover el ratón. La posición por defecto es el centro del widget.

Véase también QTest::mousePress().

void QTestEventList::addMousePress(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Añade un clic del ratón a la lista. El evento pulsará el botón button con un modifiers opcional en la posición pos con un delay opcional. La posición por defecto es el centro del widget.

Véase también QTest::mousePress().

void QTestEventList::addMouseRelease(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Añade un evento de liberación del ratón a la lista. El evento liberará el button con un modifiers opcional en la posición pos con un delay opcional. La posición por defecto es el centro del widget.

Véase también QTest::mouseRelease().

void QTestEventList::clear()

Elimina todos los eventos de la lista.

void QTestEventList::simulate(QWidget *w)

Simula los eventos de la lista uno a uno en el widget w. Para ver un ejemplo, consulta la documentación de la clase QTestEventList.

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