IDLffXMLDOMNode::InsertBefore

The IDLffXMLDOMNode::InsertBefore function method inserts a new node into the calling node’s children list at the location before a reference node.

If the reference node is not specified or is a null object reference, the new node is inserted at the end of the list of children.

If the new node is an IDLffXMLDOMDocumentFragment, all of its children are inserted in the same order before the reference node.

If the new 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::]InsertBefore( NewChild [, RefChild] )

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 to insert.

RefChild

An object reference to an instance of an IDLffXMLDOMNode subclass that refers to the reference node. The new child node is inserted before the reference node. The reference node must be a child of the calling node.

Keywords

None

Version History

6.1	Introduced