Triggering tests to run after the window is shown

1 files changed, 19 insertions, 0 deletions

diff --git a/doc/testcases.txt b/doc/testcases.txt
index 73e3a02..3f77479 100644
--- a/doc/testcases.txt
+++ b/doc/testcases.txt
@@ -224,3 +224,22 @@ TestCase {
     }
 }
 ----------------------
+
+The special property "windowShown" can be used to trigger a test to run
+just after the main window has been shown on-screen:
+
+----------------------
+Button {
+    id: button
+    onClicked: text = "Clicked"
+    TestCase {
+        name: "ClickTest"
+        when: windowShown
+
+        function test_click() {
+            button.clicked();
+            compare(button.text, "Clicked");
+        }
+    }
+}
+----------------------