.. highlightlang:: us

.. index:: DocAddEmptyPages

.. _docaddemptypages:

DocAddEmptyPages
================

.. us.tag DocAddEmptyPages NOTREADYENGLISH DocSet New5200

:ref:`DocAddEmptyPages` adds one or more empty pages to a document.

.. function:: hvPage = DocAddEmptyPages(hDoc, svPageNames)

.. us.return

**Return Value**

*hvPage* is a vector of page handle. The order of the handles is identical
with the order of *svPageNames*. In case of an error *hvPage* is 0.

.. us.params

**Parameters**

.. uparam:: hDoc

   Identifies the document.

.. uparam:: svPageNames

   *svPageNames* is a vector with page names. The length of the vector specifies
   the number of pages. If the new names are not unique for the document, they 
   will replaced with default names.

.. us.example

**Example**

.. include:: ../include/test_DocAddEmptyPages.ic

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.20
     - New.

.. seealso::
   :ref:`Overview-Documents`,
   :ref:`DocGetPageNames`

:sub:`id-1658486`