.. highlightlang:: us

.. index:: LayerCreate

.. _layercreate:

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

.. us.tag  LayerCreate ENGLISH Changed427 Changed570

:ref:`LayerCreate` creates a new diagram.

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

.. us.return

**Return Value**

*hLayer* identifies the newly created diagram.

.. us.params

**Parameters**

.. uparam:: hLayerOther

   If *hLayerOther* is a valid layer object handle the functions creates a new 
   object as a copy of the given object. If *hLayerOther* is set to 0 a layer 
   object with default settings is created.

.. us.example

**Example**

::

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

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.7.0
     - *hLayerOther* can be set to 0.
   * - 4.2.7
     - Function can be invoked with one parameter (copy constructor). The copy constructor will not copy datasets or drawing objects.

.. seealso::
   :ref:`overview-diagrams`,
   :ref:`PageCreate`,
   :ref:`PageAddLayer`,
   :ref:`PageReplot`,
   :ref:`DocCreate`,
   :ref:`ObjCopy`,
   :ref:`ObjSetName`,
   :ref:`ObjGetName`

:sub:`id-182331`