.. highlightlang:: us

.. index:: ImageSaveAs

.. _imagesaveas:

ImageSaveAs
===========

.. us.tag  ImageSaveAs NOTREADYGERMAN Image ImageSet New400 Changed6000

:ref:`ImageSaveAs` speichert das Bild in eine Datei.

.. function::  bool = ImageSaveAs(hImg, ssFileName)
               bool = ImageSaveAs(hImg, ssFileName, ssEncoding, dpi, quality)

.. us.return

**Returnwert**

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

.. us.params

**Parameter**

.. uparam:: hImg

   *hImg* ist die Zugriffsnummer (Handle) des mit :ref:`ImageCreate` erzeugten
   Bildobjekts.

.. uparam:: ssFileName

   *ssFileName* ist der vollständige Dateiname.

.. uparam:: ssEncoding

   *ssEncoding* ist einer der folgenden Strings: ``"png"``, ``"jpg"``, ``"gif"``,
   ``"tif"``, ``"bmp"``.

.. uparam:: dpi

   *dpi* bedeutet dots per inch. Übliche Werte sind 96, 120, 300, 600 1200, 1440.

.. uparam:: quality

   *quality* ist ein Wert zwischen 0 und 100 und gibt bei jpg-Dateien die 
   Ausgabequalität an. Üblich ist der Wert 75.

.. us.comment

**Kommentar**

Die drei Parameter *ssEncoding*, *dpi*, *quality* werden verwendet, wenn mit
:ref:`ImageCreate` eine wmf-, emf-, emf+- oder emf+dual-Datei geladen wurde.
Die Metadatei kann dann als Bitmap gespeichert werden. Die Funktion 
:ref:`PageSaveAsBitmap` verwendet diese Funktion zu diesem Zweck.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2018
     - Zusätzliche Parameter *ssEncoding*, *dpi*, *quality* zum Speichern von
       Metadateien als Bitmap-Datei.
   * - 4.0
     - Neu.

.. seealso::
   :ref:`uberblick-bilder`,
   :ref:`ImageCreate`,
   :ref:`PageSaveAsBitmap`,
   :ref:`PageSaveAsMetafile`

:sub:`id-1357194`