Link Search Menu Expand Document
KLCV DEV MANUAL

Object.Append Method

Explanation Connects the specified object to the object tree as a child object.

Objects connected to the object tree are no longer deleted when the variable scope disappears and can be referenced from the object tree at any time. If you want to keep the object permanently, connect to the object tree. The connected object can be deleted with the Delete method.

Note that connecting many objects to the object tree can be memory inefficient and slow.
Call format obj.Append( child [, name ] )
Return value None
Arguments Object child
String name The name of the child object.
It cannot be specified if the child has already been given a name.
An exception will be raised if there are objects with the same name in the same hierarchy to connect.
Exception CRS-334 Only objects can be connected
CRS-335 Objects with the same name cannot connect
CRS-336 Already connected to the object tree
CRS-357 Cannot Append with a different name
CRS-362 Objects with array elements or structures cannot be Append
Example of use 
Function OnTouch(e) {
    var child = new Array(1, 2, 3, 4, 5);
    Append(child, "TheArray");
}
Related item Delete, DeleteChild methods