2.1.3.2 children

children

Retrieves a collection of DHTML Objects that are direct descendants of the object.

Similar to the objects contained in the all collection, the objects contained in the children collection are undefined if the child elements are overlapping tags.

The children collection can contain HTML elements.

Syntax

[ collAll = ] object.children

[ oObject = ] object.children(vIndex [, iSubIndex])

Possible Values

collAll Array of elements contained by the object. 

oObject Reference to an individual item in the array of elements contained by the object.

vIndex Required. Integer or string that specifies the element or collection to retrieve. If this parameter is an integer, the method returns the element in the collection at the specified position, where the first element has value 0, the second has 1, and so on. If this parameter is a string and there is more than one element with the name or id property equal to the string, the method returns a collection of matching elements.

iSubIndex Optional. Position of an element to retrieve. This parameter is used when vIndex is a string. The method uses the string to construct a collection of all elements that have a name or id property equal to the string, and then retrieves from this collection the element at the position specified by iSubIndex.

Members Table

The following table lists the members exposed by the children object.

Attributes

Attribute	Description
constructor	Returns a reference to the constructor of an object.
length	Sets or retrieves the number of objects in a collection.

Methods

Method	Description
item	Retrieves an object from various collections, including the all collection.
tags	Retrieves a collection of objects that have the specified HTML tag name.
urns	Retrieves a collection of all objects to which a specified behavior is attached.