object.children

SequenceOfObjects object.children(object)

This function takes an object reference (as returned by the Object findObject(objectName) function or by the Object waitForObject(objectOrName) function), and returns a list of the object's child objects. The return type is scripting language-specific, e.g., a tuple in Python, and an array in the other languages. Examples are given below.

Test cases that rely on the order of the children encountered in this list, may find that the order changes (or even possibly, new children appear in the list) due to many different factors, such as:

• Enhancements to Squish
• Updates to the toolkit libraries
• Changes in the AUT

obj = waitForObject(":MyWidget")
children = object.children(obj)
# iterate over tuple
for child in children:
    ...

var obj = waitForObject(":MyWidget");
var children = object.children(obj);
// iterate over array
for (var i = 0; i < children.length; ++i) {
    var child = children[i];
    ...
}

my $obj = waitForObject(":MyWidget");
my @children = object::children($obj);
# iterate over array
foreach $child (@children) {
    ...
}

obj = waitForObject(":MyWidget")
children = Squish::Object.children(obj)
# iterate over array
for child in children
    # ...
end

set obj [waitForObject ":MyWidget"]
set children [object children $obj]
foreach child $children {
    ...
}