QTestEventList Class
QTestEventList クラスは、GUI イベントのリストを提供します。詳細...
| ヘッダー: | #include <QTestEventList> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Test) target_link_libraries(mytarget PRIVATE Qt6::Test) |
| qmake: | QT += testlib |
| 継承元: | QList |
パブリック関数
| 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) |
詳細な説明
QTestEventList には、後で使用するためのテストデータとして保存したり、任意の `QWidget` で再生したりできる GUI イベントを格納できます。QTestEventList は、リストにイベントを格納するための便利な関数を提供します。
例:
QTestEventList events;
events.addKeyClick('a');
events.addKeyClick(Qt::Key_Backspace);
events.addDelay(200);
QLineEdit *lineEdit = new QLineEdit(myParent);
// ...
events.simulate(lineEdit);
events.simulate(lineEdit);上記の例では、ユーザーが「a 」という文字を入力し、その直後にバックスペースキーを押して、200ミリ秒待機した後、この操作を繰り返すことをシミュレートしています。
メンバ関数のドキュメント
QTestEventList::QTestEventList()
空の QTestEventList を作成します。
QTestEventList::QTestEventList(const QTestEventList &other)
other のコピーとして、新しいQTestEventListを作成します。
[noexcept] QTestEventList::~QTestEventList()
リストを空にし、保存されているすべてのイベントを破棄します。
void QTestEventList::addDelay(int msecs)
msecs ミリ秒の遅延を追加します。
QTest::qWait()も参照してください 。
void QTestEventList::addKeyClick(Qt::Key qtKey, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
リストに新しいキークリックを追加します。このイベントは、修飾キーmodifiers を設定した状態でキーqtKey を押下したことをシミュレートし、その後msecs ミリ秒待機します。
QTest::keyClick()も参照してください 。
void QTestEventList::addKeyClick(char ascii, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
リストに新しいキークリックを追加します。このイベントは、修飾キーmodifiers を指定したascii キーの押下をシミュレートし、その後msecs ミリ秒待機します。
これはオーバーロードされた関数です。
QTest::keyClick()も参照してください 。
void QTestEventList::addKeyClicks(const QString &keys, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
リストに新しいキーボード入力項目を追加します。このイベントでは、keys をmodifiers で押下し、各キーの押下間隔をmsecs ミリ秒とします。
QTest::keyClicks()も参照してください 。
void QTestEventList::addKeyPress(Qt::Key qtKey, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
リストに新しいキー押下イベントを追加します。このイベントは、修飾キーmodifiers を設定した状態でキーqtKey を押下し、その後msecs ミリ秒待機します。
QTest::keyPress()も参照してください 。
void QTestEventList::addKeyPress(char ascii, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
リストに新しいキー押下を追加します。このイベントは、修飾キーmodifiers を指定してキーascii を押下し、その後msecs ミリ秒待機します。
これはオーバーロードされた関数です。
QTest::keyPress()も参照してください 。
void QTestEventList::addKeyRelease(Qt::Key qtKey, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
リストに新しいキーの解放を追加します。このイベントは、修飾子modifiers を指定してキーqtKey を解放し、その後msecs ミリ秒待機します。
QTest::keyRelease()も参照してください 。
void QTestEventList::addKeyRelease(char ascii, Qt::KeyboardModifiers modifiers = Qt::NoModifier, int msecs = -1)
リストに新しいキーの解放を追加します。このイベントは、修飾子modifiers を持つキーascii を解放し、その後msecs ミリ秒待機します。
これはオーバーロードされた関数です。
QTest::keyRelease()も参照してください 。
void QTestEventList::addMouseClick(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)
リストにマウスクリックを追加します。このイベントは、button をクリックし、オプションでmodifiers を指定し、位置pos にて、オプションでdelay を指定して実行されます。デフォルトの位置はウィジェットの中心です。
QTest::mouseClick()も参照してください 。
void QTestEventList::addMouseDClick(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)
リストにダブルクリックを追加します。このイベントは、button をダブルクリックし、オプションでmodifiers を、位置pos で、オプションでdelay を用いて実行します。デフォルトの位置はウィジェットの中心です。
QTest::mousePress()も参照してください 。
void QTestEventList::addMouseMove(QPoint pos = QPoint(), int delay = -1)
リストにマウスの移動イベントを追加します。このイベントにより、マウスはpos の位置に移動します。delay (ミリ秒単位)が設定されている場合、マウスの移動後にテストは待機します。デフォルトの位置はウィジェットの中心です。
QTest::mousePress()も参照してください 。
void QTestEventList::addMousePress(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)
リストにマウスクリックを追加します。このイベントは、button をクリックし、オプションでmodifiers を指定し、pos の位置で、オプションでdelay を指定して実行されます。デフォルトの位置はウィジェットの中心です。
QTest::mousePress()も参照してください 。
void QTestEventList::addMouseRelease(Qt::MouseButton button, Qt::KeyboardModifiers modifiers = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)
リストにマウスのリリースイベントを追加します。このイベントは、button を解放し、オプションでmodifiers を、位置pos に、オプションでdelay を指定して解放します。デフォルトの位置はウィジェットの中心です。
QTest::mouseRelease()も参照してください 。
void QTestEventList::clear()
リストからすべてのイベントを削除します。
void QTestEventList::simulate(QWidget *w)
リスト内のイベントを、ウィジェット `w` 上で1つずつシミュレートします。例については、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.