.. highlightlang:: us

.. index:: DocInsertPage

.. _docinsertpage:

DocInsertPage
=============

.. us.tag  DocInsertPage NOTREADYENGLISH DocSet Changed5300

:ref:`DocInsertPage` inserts new pages to the document.

.. function::  hvNewPage = DocInsertPage(hDoc, nBehind, hvPage)

.. us.return

**Return Value**

The return value *hvNewPage* is a vector with the new page handles.

.. us.params

**Parameters**

.. uparam:: hDoc

   Identifies the document.

.. uparam:: nBehind

   *nBehind* is a page index after the new pages are inserted. A value of 0
   inserts at the beginning.

.. uparam:: hvPage

   *hvPage* is a vector of page handles.  A copy of the page will be created
   if the page already belongs to a document.

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.30.0
     - New return value. Instead of the number of added pages, the new page handles are returned.

.. seealso::
   :ref:`overview-documents`,
   :ref:`DocAddPage`

:sub:`id-1943483`