.. highlightlang:: us

.. index:: PageSaveAsMetafile

.. _pagesaveasmetafile:

PageSaveAsMetafile
==================

.. us.tag  PageSaveAsMetafile GERMAN PageSet Changed310 Changed5309 Changed5900 Changed6000

:ref:`PageSaveAsMetafile` erzeugt von der angegebenen Seite eine 
Windows-Meta-Datei (WMF), eine Enhanced Metafile-Datei (EMF), eine Enhanced
Metafile with Extensions (EMF+) oder eine Kombination aus EMF und EMF+ (EMF+Dual).

.. function::  bool = PageSaveAsMetafile(hPage, ssFileName)
               bool = PageSaveAsMetafile(hPage, ssFileName, rsScale)
               bool = PageSaveAsMetafile(hPage, ssFileName, rsScale, nEMF)
               bool = PageSaveAsMetafile(hPage, ssFileName, rsScale, nEMF, bSetViewPort)
               bool = PageSaveAsMetafile(hPage, ssFileName, rsScale, nEMF, bSetViewPort, nClipFlag)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich war und sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: hPage

   *hPage* ist die Zugriffsnummer (Handle) der Seite.

.. uparam:: ssFileName

   *ssFileName* ist der vollständige Dateiname unter der die Datei gespeichert
   werden soll.

.. uparam:: rsScale

   *rsScale* ist ein Faktor um das Meta-Bild-Größe zu skalieren. Der Faktor muss
   im Bereich 0.1 bis 3.0 (``1% - 300%``) liegen. Wird der Parameter nicht
   angegeben, wird der Wert 1 verwendet.

.. uparam:: nEMF

   Gibt den Typ der Metadatei an.

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

      * - Wert
        - Beschreibung
      * - 0
        - WMF (Default) (Namenserweiterung :file:`.wmf`).
      * - 1
        - EMF (Namenserweiterung :file:`.emf`).
      * - 2
        - EMF+ (Namenserweiterung :file:`.emf`).
      * - 3
        - EMF+Dual (Namenserweiterung :file:`.emf`).

.. uparam:: bSetViewPort

   Wenn *bSetViewPort* gleich TRUE ist, wird bei WMF-Dateien der Viewport gesetzt. 
   Auf EMF-Dateien hat dieser Parameter keinen Einfluss. Defaultwert ist TRUE (1). 
   Einige Programme können keine Metafiles verwenden, wenn der Viewport in der
   Metadatei gesetzt wurde. Dann sollte dieser Parameter auf FALSE (0) gesetzt
   werden.

.. uparam:: nClipFlag

   Legt fest, wie die Größe der Seite berechnet wird.

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

      * - Wert
        - Beschreibung
      * - 0
        - Boundig Box: Größtes Rechteck, das alle Elemente der Seite umschließt.
          (Default Wert)
      * - 1
        - Boundig Box: Größtes Rechteck. Das Rechteck wird an den Seitengrenzen
          abgeschnitten.
      * - 2
        - Seitengröße.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2018
     - Der vierte Parameter *nEMF* kann nun die Werte 0 bis 3 annehmen.
   * - R2017
     -
   * - 5.30.9
     - Neuer Parameter *nClipFlag*

.. seealso::
   :ref:`uberblick-dokument-seiten`,
   :ref:`PageSaveAsBitmap`,
   :ref:`AppGetActivePage`,
   :ref:`GetOpenFileName`

:sub:`id-533873`