.. highlightlang:: us

.. index:: LBCreate

.. _lbcreate:

LBCreate
========

.. us.tag  LBCreate NOTREADYENGLISH Changed427 Changed570

:ref:`LBCreate` creates a line or arrow drawing object.

.. function::  hLine = LBCreate()
    hLine = LBCreate(hLineOther)

.. us.return

**Return Value**

*hLine* is the line handle. If the line cannot be created *hLine* is 0.

.. us.params

**Parameters**

.. uparam:: hLineOther

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

.. us.example

**Example**

::

   hLine = LBCreate()
   LBSetP1P2(hLine, [0, 0, 10, -10])
   LayerAddObjects(hLayer, hLine);

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.7.0
     - *hLineOther* can be set to 0.
   * - 4.2.7
     - Function can be invoked with one parameter (copy constructor).

.. seealso::
   :ref:`overview-lines-and-arrows`,
   :ref:`LBDestroy`,
   :ref:`LBSetP1P2`

:sub:`id-1328750`