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:
DEFINE VARIABLE hXdoc AS HANDLE NO-UNDO.
. . .
CREATE X-DOCUMENT hXdoc.
CREATE X-NODEREF hXnode.
hXdoc:CREATE-NODE(hXnode,"City","ELEMENT").
. . .
|