Description
The TestComplete log consists of log items organized into a tree-like structure. Use the Child property to obtain the child item of the current log item. The total number of child items is specified by the ChildCount property.
Declaration
LogItemObj.Child(Index)
| Read-Only Property | A LogItem object |
| LogItemObj | An expression, variable or parameter that specifies a reference to a LogItem object | |||
| Index | [in] | Required | Integer | |
Applies To
The property is applied to the following object:
Parameters
The property has the following parameter:
Index
The index of the desired child log item. The index is zero-based, that is, the first child item has the index 0, the second - 1, and so on. Index of the last child item is ChildCount - 1.
Property Value
A LogItem object representing the desired child log item.
Remarks
If you use Python or DelphiScript, you should enclose the parameter of the Child property in square brackets: Child[Index].
Example
The code below obtains the names of all child elements that belong to the current log item and then posts these names to the test log.
JavaScript, JScript
function ChildrenNames()
{
// Obtains a collection of logs
var LogsCol = Project.Logs;
// Obtains the first log item
var LogItem = LogsCol.LogItem(0);
// Obtains the number of child elements
// that belong to the log item
var Num = LogItem.ChildCount;
// Iterates through the child items
for (var i = 0; i < Num; i++)
{
// Obtains the name of the current log item
var Name = LogItem.Child(i).Name;
Log.Message(Name);
}
}
Python
def ChildrenNames():
# Obtains a collection of logs
LogsCol = Project.Logs
# Obtains the first log item
LogItem = LogsCol.LogItem[0]
# Obtains the number of child elements
# that belong to the log item
Num = LogItem.ChildCount
# Iterates through the child items
for i in range(0, Num):
# Obtains the name of the current log item
Name = LogItem.Child[i].Name
Log.Message(Name)VBScript
Sub ChildrenNames()
' Obtains a collection of logs
Set LogsCol = Project.Logs
' Obtains the first log item
Set LogItem = LogsCol.LogItem(0)
' Obtains the number of child elements
' that belong to the log item
Num = LogItem.ChildCount
' Iterates through the child items
For i = 0 to (Num - 1)
' Obtains the name of the current log item
Name = LogItem.Child(i).Name
Log.Message(Name)
Next
End Sub
DelphiScript
function ChildrenNames;
var LogsCol, LogItem, Num, i, Name;
begin
// Obtains a collection of logs
LogsCol := Project.Logs;
// Obtains the first log item
LogItem := LogsCol.LogItem[0];
// Obtains the number of child elements
// that belong to the log item
Num := LogItem.ChildCount;
// Iterates through the child items
for i := 0 to (Num - 1) do
begin
// Obtains the name of the current log item
Name := LogItem.Child[i].Name;
Log.Message(Name);
end;
end;
C++Script, C#Script
function ChildrenNames()
{
// Obtains a collection of logs
var LogsCol = Project["Logs"];
// Obtains the first log item
var LogItem = LogsCol["LogItem"](0);
// Obtains the number of child elements
// that belong to the log item
var Num = LogItem["ChildCount"];
// Iterates through the child items
for (var i = 0; i < Num; i++)
{
// Obtains the name of the current log item
var Name = LogItem["Child"](i)["Name"];
Log["Message"](Name);
}
}
See Also
Access Test Log Contents from Tests
LogItem Object
ChildCount Property
Data Property
DataCount Property