XMLElement.AddChild Method

Adds a new XMLElement object as a sub-element of this element. The new element is placed at the position specified through the document's DTD. If this element can have more than one child of the specified type the before or after parameters can be used to specify a position.

Syntax

   XMLElement.AddChild XMLElement[, before][, after]
Parameter Description
XMLElement

Specifies an XMLElement object.

before

Optional. Specifies a relative position in the list of child elements of the specified type. The XML element to be added is placed before the child identified by the before parameter. You can specify before or after positions but not both.

after

Optional. Specifies a relative position in the list of child elements of the specified type. The XML element to be added is placed after the child identified by the after parameter. You can specify before or after positions but not both.

Return Value

The method returns one of the following values:


Value Description
0 An error has occurred.
1 The new element could not be added because the document becomes invalid according to the document's DTD. In this case Text Control fires an XMLInvalid event.
2 The new element has been successfully added.

Example

The following Basic example creates a new "Telephone" element and adds it to the second address in an XML document that contains addresses consisting of the sub-elements Name, Street, City and Telephone:

Dim NewElement As Object
Set NewElement = CreateObject("TIS.TX.XMLElement.32")
NewElement.ElementName = "Telephone"
NewElement.Text = "034568-782346"
TXTextControl1.XMLElements("Address")(2).AddChild NewElement

See Also