.. highlightlang:: us

.. _auto_getfilenamedialog:

auto_GetFileNameDialog
======================

.. index:: auto_GetFileNameDialog

.. us.tag  auto_GetFileNameDialog GERMAN DialogBoxes

:ref:`auto_GetFileNameDialog` ruft ein
Dialogfeld auf, mit dem bis zu 16 Dateinamen ausgewählt werden können.
Die Funktion kann innerhalb von Automatisierungsskripten verwendet
werden.

.. function::  svFilename = auto_GetFileNameDialog()
    svFilename = auto_GetFileNameDialog(nFiles)
    svFilename = auto_GetFileNameDialog(nFiles, ssTitle)

.. us.return

**Returnwert**

*svFilename* ist ein String-Vektor mit den vollständigen
Dateinamen. Falls der Benutzer die Schaltfläche **Abbruch** gedrückt hat,
gibt die Funktion einen String mit dem Wert ``"DLG_CANCEL"`` zurück. Die
Funktion liefert immer gültige Dateinamen. Falls der Benutzer nicht
für alle Felder einen Dateinamen auswählen möchte, wählt er die
Zeichenkette ``"---------------"``.

.. us.params

**Parameter**

.. uparam:: nFiles

   *nFiles* ist die Anzahl der gewünschten Dateinamen.
   Die Anzahl muss zwischen 1 und 16 liegen. Falls dieser Parameter nicht
   angegeben wird, können bis zu 8 Dateien ausgewählt werden.

.. uparam:: ssTitle

   Optionaler Dialog-Titel. Der mit *ssTitle* angegebene
   Titel ersetzt den Standard-Titel.

.. us.comment

**Kommentar**

Die Funktion sucht im Suchverzeichnis nach Dateinamen die dem
Suchfilter entsprechen.

.. image:: S:/uniplot-obj/images/auto_GetFileNameDialog.*

Um das Suchverzeichnis zu ändern, wählt man die Schaltfläche **Suchfilter**. Im folgenden
Dialog kann man das Suchverzeichnis und den Suchfilter ändern.

.. image:: S:/uniplot-obj/images/auto_SetFileNameDialogInit.*

Sollen die Dateien in verschiedenen Verzeichnissen gesucht
werden, müssen die einzelnen Verzeichnisse durch ein Semikolon
getrennt werden. Im Filter können die Zeichen Stern (``*``) und
Fragezeichen (``?``) verwendet werden. Ein Stern steht für eine beliebige
Zeichenfolgen (ein oder mehr Zeichen); ein Fragezeichen steht für ein
beliebiges Zeichen.

Bei Excel-Dateien wird im Dialog der Tabellenname in eckigen Klammern
hinter dem Dateinamen angegeben.

Mit der Funktion :ref:`auto_SetFileNameDialogInit` kann der Suchfilter und das
Suchverzeichnis vorgegeben werden.

.. us.example

**Beispiel**

::

   ...
   auto_SetFileNameDialogInit("*.xls");
   svFilename = auto_GetFileNameDialog(4);
   if (svFilename[1] == "DLG_CANCEL") {
       return;
   }
   NumberOfFiles = len(svFilename);
   for (i in 1:NumberOfFiles) {
       svFilename[i] = auto_ImportData(svFilename[i]);
       auto_LoadDataset("Diagramm 1", "N", "Mom");
       auto_LoadDataset("Diagramm 1", "N", "be");
       auto_LoadDataset("Diagramm 1", "N", "NOx");
   }
   ...

.. seealso::
   :ref:`uberblick-automatisierung-der-diagrammerstellung`,
   :ref:`auto_ImportData`,
   :ref:`auto_LoadDataset`,
   :ref:`auto_SetFileNameDialogInit`

:sub:`id-1661890`