Add findChild to TestCase.

This is useful for auto tests where it's necessary to have access to
dynamically created child items. For example:

property Component threeItemDelegate: Text {
    objectName: "delegate" + styleData.index
    text: styleData.value
}

...

function test_stuff() {
    ...

    var delegate0 = findChild(item, "delegate0");
    // check delegate0 for some condition...
}

[ChangeLog][QtTest][TestCase] Added findChild function to TestCase.

Change-Id: I04a8b07c9904768c07ec12f4b03f1afb1989e054
Reviewed-by: Liang Qi <liang.qi@digia.com>
Reviewed-by: J-P Nurmi <jpnurmi@digia.com>

1 files changed, 15 insertions, 0 deletions

diff --git a/src/imports/testlib/TestCase.qml b/src/imports/testlib/TestCase.qml
index 37addd1d7d..f946a4eef3 100644
--- a/src/imports/testlib/TestCase.qml
+++ b/src/imports/testlib/TestCase.qml
@@ -638,6 +638,21 @@ Item {
     }
 
     /*!
+        \since 5.4
+        \qmlmethod QtObject TestCase::findChild(parent, objectName)
+
+        Returns the first child of \a parent with \a objectName,
+        or \c null if no such item exists. Children are searched recursively.
+
+        \code
+        compare(findChild(item, "childObject"), expectedChildObject);
+        \endcode
+    */
+    function findChild(parent, objectName) {
+        return qtest_results.findChild(parent, objectName);
+    }
+
+    /*!
         \qmlmethod TestCase::tryCompare(obj, property, expected, timeout = 5000, message = "")
 
         Fails the current test case if the specified \a property on \a obj