AddObj Method (ChildrenCollection)

Reference> ChildrenCollection Object> ChildrenCollection Methods> AddObj Method (ChildrenCollection)

Adds or inserts an independent object in the collection and returns a reference to the created object. An independent style object is not a member of the collection, but is a standalone object created in code with a Dim or Set statement using the New keyword. The AddObj method allows you to add and include these existing standalone objects into the collection.

Syntax

object.AddObj ([Index], Key, Obj)

Arguments

index is an optional variant, an integer specifying the position where you want to insert the object. If you do not specify an index, the object is added to the end of the collection.

key is a required, unique string that identifies the added object. Use this key to retrieve a specific object.

Obj is a required, independent object to insert or add into the collection.

Return Value

A reference to the newly added object where appropriate, otherwise none.

Remarks

If the key name is not unique, an error will occur.