.. highlightlang:: us

.. index:: VideoSetFileName

.. _videosetfilename:

VideoSetFileName
================

.. us.tag VideoSetFileName NOTREADYGERMAN Video-set New5503

:ref:`VideoSetFileName` setzt den Datennamen der Video-Datei. Die 
Daten wird beim Aktivieren  :ref:`VideoActivate` geladen.

.. function:: bool = VideoSetFileName(hVideo, ssFileName)

.. us.return

**Returnwert**

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

.. us.params

**Parameter**

.. uparam:: hVideo

   *hVideo* ist die Zugriffsnummer (handle) des mit :ref:`VideoCreate` erzeugten
   Video-Objekts.

.. uparam:: ssFileName

   *ssFileName*

.. 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 
Videodateinamen angezeigt.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2013.3
     - Neu.

.. seealso::
   :ref:`overview-videos`,
   :ref:`VideoCreate`,
   :ref:`VideoGetFileName`

:sub:`id-42978`