.. highlightlang:: us

.. index:: auto_LoadTemplate

.. _auto_loadtemplate:

auto_LoadTemplate
=================

.. us.tag  auto_LoadTemplate GERMAN

:ref:`auto_LoadTemplate` öffnet eine Vorlagendatei.

.. function::  hPage = auto_LoadTemplate(ssFileName)
               hPage = auto_LoadTemplate(ssFileName, ssPageName)

.. us.return

**Returnwert**

*hPage* ist die Zugriffsnummer der Seite die von der Vorlage erzeugt wurde. Mit
dieser Zugriffsnummer können die Funktionen die auf das Seiten-Objekt zugreifen,
aufgerufen werden (siehe Beispiel 2 und 3).

.. us.params

**Parameter**

.. uparam:: ssFileName

   *ssFileName* ist der Name der Vorlagendatei.
   Hinweis: Verwenden Sie für die Eingabe von Dateinamen anstatt des
   Backslashes (``"\"``) einen Slash (``"/"``). Beispiel: ``"c:/data/datei.ipw"``.
   Der Name der Vorlage kann ohne Laufwerk und Pfad angegeben werden. In
   diesem Fall sucht die Funktion die Vorlage in den angegebenen
   Automatisierungs-Skript- Verzeichnissen.

.. uparam:: ssPageName

   *ssPageName* ist der Seitenname der Vorlage. Falls dieser Parameter nicht
   angegeben wird, wird die erste Seite aus der Vorlage geladen, z. B. 
   ``auto_LoadTemplate("template1.ipw")``.

.. us.example

**Beispiel**

Beispiel 1: Das folgende Beispiel erzeugt eine Kopie der ersten Seite der Datei
:file:`template-de.ipz`.

::

   auto_LoadTemplate(GetRootDirectory() + "template/template-de.ipz");

Beispiel 2: Bei diesem Beispiel wird der Returnwert *hPage* verwendet, um die
Seite als Metadatei zu speichern.

::

   hPage = auto_LoadTemplate("c:/uniplot/template/datei.ipw");
   PageSaveAsMetafile(hPage, "c:/test.wmf");

Beispiel 3: Bei diesem Beispiel wird der Returnwert *hPage* verwendet, um die
Seite umzubenennen.

::

   hPage = auto_LoadTemplate("c:/uniplot/template/datei.ipw", "Page 1");
   PageSetTitle(hPage, "MOM");

.. seealso::
   :ref:`uberblick-automatisierung-der-diagrammerstellung`,
   :ref:`GetRootDirectory`,
   :ref:`PageSaveAsMetafile`,
   :ref:`PageSetTitle`,
   :ref:`auto_SetTemplate`

:sub:`id-1812115`