IDLffXMLDOMNode::AppendChild

The IDLffXMLDOMNode::AppendChild function method adds a new node to the end of the calling node’s children list.

If the new child node is already in the tree, it is first removed.

The ownership of the IDL object to which the NewChild object reference refers is changed so that it is no longer owned by its previous owner and becomes owned by the calling object. Therefore, destroying the calling object destroys the new child as well.

Syntax

Result = Obj->[IDLffXMLDOMNode::]AppendChild( NewChild )

Return Value

Returns an object reference to the new child node.

Arguments

NewChild

An object reference to an instance of an IDLffXMLDOMNode subclass that refers to the node that is being added.

Keywords

None

Version History

6.1	Introduced