.. highlightlang:: us

.. index:: ObjCreateXML

.. _ObjCreateXML:

ObjCreateXML
============

.. us.tag  ObjCreateXML ENGLISH New5505

:ref:`ObjCreateXML` creates a new page, layer of drawing object from
the given XML text.

.. function:: error = ObjCreateXML(hParent, ssXML)

.. us.return

**Return Value**

*error* is 0, if the function was successful. Otherwise it is an error object, 
see :ref:`error_create`.

*error*.

.. us.params

**Parameters**

.. uparam:: hParent

   *hParent* is the handle of the parent object.

   .. list-table::
      :header-rows: 1

      * - ssXML
        - hParent
      * - page
        - Document handle (hDoc)
      * - layer (Diagramm)
        - Page handle (hPage)
      * - Drawing Object (line, table, ...)
        - Diagram handle of background handle (hLayer)
      * - Dataset
        - Diagram handle (hLayer)

.. uparam:: ssXML

   *ssXML* is an XML string for a page, diagram, drawing object of dataset. 
   See :ref:`ObjGetXML`.

.. us.comment

**Comment**

.. note::

   This function is a beta version. The release version will be available
   in one of the next updates.

.. us.example

**Example**

::

   ssXML = "[[<?xml version='1.0' encoding='utf-8'?>
   <line stroke-color='#14639E' stroke-width='10' x1='1.1' x2='19.2' y1='-25.1' y2='-25.1'/>]]";

   hDoc = DocCreate();
   hPage = PageCreate();
   DocAddPage(hDoc, hPage);
   hLayer = PageGetAllLayers(hPage)[1];
   ObjCreateXML(hLayer, ssXML);

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - R2013.5
     - New.

.. seealso::
   :ref:`overview-objects`,
   :ref:`ObjGetXML`,
   :ref:`xml_parse_string`,
   :ref:`xml_save_node`

:sub:`id-1964146`