GET-DOCUMENT-ELEMENT( ) method

Retrieves the root element of the document. The parameter must be a valid X-noderef handle and will refer to the document’s root element if the method succeeds.

Return type:

LOGICAL

Applies to:

X-document object handle

 

Syntax 

GET-DOCUMENT-ELEMENT ( x-node-handle )

x-node-handle

A valid X-noderef handle to use for the root element.

The following example demonstrates the use of GET-DOCUMENT-ELEMENT if hDoc is an X-document and hRoot is an X-noderef:

 

/* Creates an ABL document object & initializes the associated XML object. */ CREATE X-document hDoc.   /* Creates an ABL reference for an XML node in a parse tree. */ CREATE X-NODEREF hRoot.   /* Reads the myxml.xml document into an XML parse tree. */ hDoc:LOAD("file","myxml.xml",false).   /* Associates hRoot with the root node of the hDoc document. */ hDoc:GET-DOCUMENT-ELEMENT(hRoot).