.. highlightlang:: us

.. index:: LayerMoveObjects

.. _layermoveobjects:

LayerMoveObjects
================

.. us.tag  LayerMoveObjects ENGLISH New420 LayerSet Changed424 Changed5800

:ref:`LayerMoveObjects` moves Objects to the specified diagram. Objects can
only be moved inside a page. The function can also be used to change the drawing
order of Objects.

.. function::  bool = LayerMoveObjects(hLayer, hvObject)
               bool = LayerMoveObjects(hLayer, hvObject, bTail)

.. us.return

**Return Value**

If the function succeeds, the return value is TRUE (1); otherwise it is FALSE (0).

.. us.params

**Parameters**

.. uparam:: hLayer

   Identifies the layer.

.. uparam:: hvObject

   *hvObject* is a vector with Objects handles. The following element types
   can be used: ``OBJ_TEXT``,  ``OBJ_TABLE``, ``OBJ_RECT``, ``OBJ_ELLIPSE``,
   ``OBJ_LINE``, ``OBJ_LINK``, ``OBJ_OLEITEM``, see also :ref:`ObjGetClass`.

.. uparam:: bTail

   If *bTail* is TRUE (1), the Objects is added to the end of the list. If
   *bTail* is FALSE (0), the Objects is inserted at the beginning of the list.
   Default value is  TRUE (1).

.. us.history

**History**

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

   * - Version
     - Description
   * - R2016.1
     - Documentation added.

.. seealso::
   :ref:`overview-diagrams`,
   :ref:`LayerCreate`,
   :ref:`LayerAddObjects`,
   :ref:`LayerMoveDataset`

:sub:`id-1272153`