.. highlightlang:: us

.. index:: auto_SetTemplate

.. _auto_settemplate:

auto_SetTemplate
================

.. us.tag  auto_SetTemplate NOTREADYENGLISH

:ref:`auto_SetTemplate` sets a template. This function should be called if the
document page was not opened using :ref:`auto_LoadTemplate`. The functions sets
some globally used variables, which will be used by other ``auto_`` functions,
e. g. :ref:`auto_LoadDataset`.

.. function::  bool = auto_SetTemplate(hPage)

.. us.return

**Return Value**

bool

.. us.params

**Parameters**

.. uparam:: hPage

   *hPage* is a page handle.

.. us.comment

**Comment**

This function can be used to add more pages to an already existing document.

.. us.example

**Example**

::

   hPage = AppGetActivePage();
   auto_SetTemplate(hPage);
   auto_AddPage();
   hNewPage = auto_LoadTemplate("MyDocument.ipw", "Page 1")

.. seealso::
   :ref:`overview-automation`,
   :ref:`auto_LoadTemplate`,
   :ref:`auto_AddPage`,
   :ref:`AppGetActivePage`

:sub:`id-910638`