SignalSpy QML Type
シグナル発信のイントロスペクションを有効にする。詳細...
Import Statement: | import QtTest |
Inherits: |
プロパティ
- count : int
- signalArguments : list
- signalName : string
- target : object
- valid : bool
方法
詳細説明
次の例では、ユーザー定義の Button タイプの "clicked" シグナルを監視するために SignalSpy を設置しています。シグナルが発信されると、スパイのcount プロパティが増加します。
Button { id: button SignalSpy { id: spy target: button signalName: "clicked" } TestCase { name: "ButtonClick" function test_click() { compare(spy.count, 0) button.clicked(); compare(spy.count, 1) } } }
上記のスタイルのテストは、同期的に発信されるシグナルに適しています。非同期シグナルの場合は、wait() メソッドを使用して、シグナルが発生するまで(またはタイムアウトが終了するまで)テストをブロックできます。
TestCase およびQt Quick Testも参照 。
プロパティの説明
count : int |
このプロパティは、最後にclear() が呼び出されてから、target からsignalName が発信された回数を定義する。
target 、signalName 、およびclear ()も参照 。
signalArguments : list |
このプロパティは、放出されたシグナル引数のリストを保持する。シグナルが発信されるたびに、シグナルの引数を含むリストが1つ追加されます。新しいtarget または新しいsignalName に接続するとき、またはclear() メソッドを呼び出すとき、signalArguments は空にリセットされます。
signalName およびclear()も参照してください 。
target : object |
このプロパティは、signalName シグナルの放出をリッスンするために使用されるターゲット・オブジェクトを定義します。
signalName およびcount も参照 。
valid : bool |
このプロパティは、現在のシグナル接続状態を定義します。target のsignalName が正常に接続されると真になり、そうでなければ偽になる。
count 、target 、signalName 、clear ()も参照 。
メソッド・ドキュメント
clear() |
count を 0 にクリアし、valid を false にリセットし、signalArguments を空にクリアする。
wait(timeout = 5000) |
target 上のシグナルsignalName が発せられるのを、最大timeout ミリ秒待つ。シグナルが発せられない場合、テストケースは失敗する。
SignalSpy { id: spy target: button signalName: "clicked" } function test_async_click() { ... // do something that will cause clicked() to be emitted ... spy.wait() compare(spy.count, 1) }
wait()が呼ばれたときにすでにシグナルが発信されていた場合と、まだシグナルが発信されていない場合です。wait()関数は、シグナルが既に発生した場合は即座に返すことで、最初のシナリオを処理します。
clear() メソッドを使用すると、既に発生したシグナルに関する情報を破棄して、wait() と将来のシグナルの発生を同期させることができる。
clear() およびTestCase::tryCompare()も参照の こと。
© 2025 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.