ImageSetFileName

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

bool = ImageSetFileName(hImg, ssNewFileName)

Returnwert

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

Parameter

hImg

hImg ist die Zugriffsnummer (Handle) des mit ImageCreate erzeugten Bildobjekts.

ssNewFileName

ssNewFileName ist der Dateiname der verknüpften Datei.

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 Extras=>Weitere 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.

id-134981