Child Method

Applies to TestComplete 14.10, last modified on June 5, 2019

Description

Objects can have children. For example, windows are children of a process, processes are children of the Sys object, etc. Each object maintains a list of child objects. The Child method of a parent object returns one child object by its index in the list.

Declaration

TestObj.Child(Index)

TestObj A variable, parameter or expression that specifies a reference to one of the objects listed in the Applies To section
Index [in]    Required    Integer    
Result Object

Applies To

All processes, windows, controls and onscreen objects.

View Mode

To view this method in the Object Browser panel and in other panels and dialogs, activate the Advanced view mode.

Parameters

The method has the following parameter:

Index

Specifies the zero-based index of the child you want to get.

Result Value

A child object that has the specified index.

Example

The following code inserts two messages. The first message holds the name of the active window, the second one - the names of all of its child objects.

JavaScript, JScript

function TestProc()
{
  var w, i, wndChild;
  w = Sys.Desktop.ActiveWindow();
  Log.Message(w.Name, w.FullName);
  for (i=0; i < w.ChildCount; i++)
  {
    wndChild = w.Child(i);
    Log.Message(wndChild.Name, "", 0);
  }
}

Python

def TestProc():
  w = Sys.Desktop.ActiveWindow()
  Log.Message(w.Name, w.FullName)
  for i in range ( 0 , w.ChildCount):
    wndChild = w.Child(i)
    Log.Message(wndChild.Name, "", 0)

VBScript

Sub TestProc
  Set w = Sys.Desktop.ActiveWindow
  For i = 0 To w.ChildCount - 1
    Set wndChild = w.Child(i)
    Log.Message wndChild.Name
  Next
End Sub

DelphiScript

procedure TestProc;
var
  i : integer;
  w, wndChild : OleVariant;
begin
  w := Sys.Desktop.ActiveWindow;
  Log.Message(w.Name, w.FullName);
  for i := 0 to (w.ChildCount - 1) do
  begin
    wndChild := w.Child(i);
    Log.Message(wndChild.Name, '', 0);
  end;
end;

C++Script, C#Script

function TestProc()
{
  var w, i, wndChild;
  w = Sys["Desktop"]["ActiveWindow"]();
  Log["Message"](w["Name"], w["FullName"]);
  for (i=0; i < w["ChildCount"]; i++)
  {
    wndChild = w["Child"](i);
    Log["Message"](wndChild["Name"], "", 0);
  }
}

See Also

ChildCount Property
WaitChild Method
Find Method
FindChild Method
FindAll Method
FindAllChildren Method
FindId Method
Refresh Method

Highlight search results