Release 10.1A: OpenEdge Development:
Progress 4GL Reference

> ## APPEND-CHILD( ) method

> Appends a node as the last child node of this XML document or element node. Connects a node into the document structure after the node has been created with the CREATE-NODE( ) or CREATE-NODE-NAMESPACE( ) method, cloned with the CLONE-NODE( ) method, or disconnected with the REMOVE-NODE( ) method. This has no effect on the node reference.

> If the node is already in the tree, it is disconnected from its present location and then connected at the specified location.

> Return type: LOGICAL

> Applies to: X-document object handle, X-noderef object handle

> Syntax
>     APPEND-CHILD( x-node-handle )

> ``x-node-handle``

> The handle that represents the node to append to this XML document or element node. `x-node-handle` must refer to a node in this document. You cannot use APPEND-CHILD( ) to move a node from one document to another.

> The following code fragment demonstrates creating a node in a tree with the name and value of a field:

>     . . .
>     hDoc:CREATE-NODE(hNoderef,bufField:NAME,"ELEMENT").
>     hNoderefParent:APPEND-CHILD(hNoderef).
>     hDoc:CREATE-NODE(hText,"","TEXT").
>     hText:NODE-VALUE = STRING(bufField:BUFFER-VALUE).
>     hNoderef:APPEND-CHILD(hText).
>     . . .

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095