Creates a handle which can be used as a parameter or return-value for methods which will associate the handle with an XML node. This object is not a node in its own right, but merely a way to provide access to the underlying XML node.
Syntax
CREATE X-NODEREF handle[ IN WIDGET-POOL widget-pool-name]
handle
A valid X-noderef object handle to use for the new XML node.
IN WIDGET-POOL widget-pool-name
An expression of type CHARACTER that evaluates, at run time, to the name of the widget pool that contains the XML node.
Note: Widget pool names are not case-sensitive.
An X-noderef object is not in a fully usable state until it has been associated with an X-document. Before this, you can only access its HANDLE, TYPE, PRIVATE-DATE, and UNIQUE-ID attributes without error. To avoid run-time errors, the code below shows one way to test the status of an X-noderef object (X-noderef):
cType = X-noderef:SUBTYPE NO-ERROR.
IF VALID-HANDLE(X-noderef) AND cType = 'ELEMENT' THEN DO:
/*** your code ***/
END.
Example
The following code fragment depicts creating an XML document node reference and using it to create a node: