.. highlightlang:: us

.. index:: ObjCreateXML

.. _ObjCreateXML:

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

.. us.tag  ObjCreateXML GERMAN New5505

:ref:`ObjCreateXML` erzeugt eine Seite, ein Diagramm oder Zeichenobjekt aus einem
XML-Text.

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

.. us.return

**Returnwert**

*error* ist 0, wenn die Funktion erfolgreich war, sonst ein error-Object, siehe
:ref:`error_create`.

.. us.params

**Parameter**

.. uparam:: hParent

   *hParent* ist die Zugriffsnummer des Parent-Objekts.

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

      * - ssXML
        - hParent
      * - page
        - Zugriffsnummer eines Dokuments (hDoc)
      * - layer (Diagramm)
        - Zugriffsnummer einer Seite (hPage)
      * - Zeichenobjekt (line, table, ...)
        - Zugriffsnummer des Hintergrund-Layers oder eines Diagramms (hLayer)
      * - Datensatz
        - Zugriffsnummer eines Diagramms (hLayer)

.. uparam:: ssXML

   *ssXML* ist eine XML-formatierte Dokument-Seite, ein Diagramm, ein
   Zeichenobjekt oder ein Datensatz. Siehe :ref:`ObjGetXML`.

.. us.comment

**Kommentar**

.. note::

   Diese Funktion ist eine Beta-Version. Die Release-Version wird in einem der
   nächsten Updates fertig gestellt.

.. us.example

**Beispiel**

::

   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
     - Beschreibung
   * - R2013.5
     - Neu.

.. seealso::
   :ref:`uberblick-objekte`,
   :ref:`ObjGetXML`,
   :ref:`xml_parse_string`,
   :ref:`xml_save_node`

:sub:`id-1964146`