.. highlightlang:: us

.. index:: ImageSetFileName

.. _imagesetfilename:

ImageSetFileName
================

.. us.tag  ImageSetFileName NOTREADYGERMAN New360 Image ImageSet

:ref:`ImageSetFileName` setzt einen neuen Dateinamen für die Bilddatei und lädt
die Bilddatei in das Bildobjekt.

.. function::  bool = ImageSetFileName(hImg, ssNewFileName)

.. 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:: ssNewFileName

   *ssNewFileName* ist der Dateiname der verknüpften Datei.

.. us.comment

**Kommentar**

Der Dateiname kann als vollständiger oder relativer Name angegeben werden. Um
die Bilddatei zu finden sucht UniPlot die Datei in verschiedenen Verzeichnissen. 
Die Suche wird abgebrochen sobald die Datei gefunden wurde. UniPlot sucht in den
folgenden Verzeichnissen:

* Versuche die Bilddatei mit dem gegebenen Namen zu öffnen.

* Suche im Verzeichnis der gegebenen IPW/IPZ-Datei.

* Suche in den Verzeichnissen, die im Dialog :ref:`extrasweitere-optionen` im
  Textfeld **Sucherverzeichnisse für Bildateien** angegeben sind.

Falls die Suche erfolglos bleibt, wird im IPW/IPZ-Dokument ein Rahmen mit dem 
Bilddateinamen angezeigt.

.. seealso::
   :ref:`uberblick-bilder`,
   :ref:`ImageGetFileName`

:sub:`id-134981`