.. highlightlang:: us

.. index:: LayerCreate

.. _layercreate:

LayerCreate
===========

.. us.tag  LayerCreate GERMAN Changed427 Changed570

:ref:`LayerCreate` erzeugt ein neues Diagramm.

.. function::  hLayer = LayerCreate()
    hLayer = LayerCreate(hLayerOther)

.. us.return

**Returnwert**

*hLayer* ist die Zugriffsnummer des erzeugten Diagramms.

.. us.params

**Parameter**

.. uparam:: hLayerOther

   Wird LayerCreate() in der Form LayerCreate(*hLayerOther*) aufgerufen, wird eine
   Kopie des Layerobjekts *hLayerOther* erzeugt. Wenn *hLayerOther* gleich 0 ist,
   wird ein Layerobjekt mit Default-Konfiguration erzeugt.

.. us.example

**Beispiel**

::

   hDoc = DocCreate();
   hPage = PageCreate();
   hLayer = LayerCreate();
   DocAddPage(hDoc, hPage);
   PageAddLayer(hPage, hLayer);
   PageReplot(hPage);

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.7.0
     - *hLayerOther* kann auf 0 gesetzt werden.
   * - 4.2.7
     - Die Funktion kann auch als Kopier-Konstruktor aufgerufen werden. Der  Konstruktor kopiert keine Datensätze oder Zeichenobjekte.

.. seealso::
   :ref:`uberblick-diagramme`,
   :ref:`PageCreate`,
   :ref:`PageAddLayer`,
   :ref:`PageReplot`,
   :ref:`DocCreate`,
   :ref:`ObjCopy`,
   :ref:`ObjSetName`,
   :ref:`ObjGetName`

:sub:`id-182331`