.. highlightlang:: us

.. index:: PageAddLayer

.. _pageaddlayer:

PageAddLayer
============

.. us.tag  PageAddLayer ENGLISH PageSet

:ref:`PageAddLayer` adds one or more
layers (diagrams) to the given page.

.. function::  bool = PageAddLayer(hPage, hvLayer)

.. us.return

**Return Value**

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

.. us.params

**Parameters**

.. uparam:: hPage

   Identifies the page.

.. uparam:: hvLayer

   *hvLayer* is a vector with layer handles.

.. us.example

**Example**

::

   * hdoc = DocCreate()
   * hPage = PageCreate()
   * DocAddPage(hDoc, hPage)
   * hlayer = LayerCreate()
   * PageAddLayer(hPage, hlayer)
   * PageReplot(hPage)

.. seealso::
   :ref:`overview-document-pages`,
   :ref:`PageCreate`,
   :ref:`DocCreate`,
   :ref:`DocAddPage`

:sub:`id-2004703`