.. highlightlang:: us

.. index:: GetOpenFileName

.. _getopenfilename:

GetOpenFileName
===============

.. us.tag  GetOpenFileName GERMAN FILE_MISC DialogBoxes

:ref:`GetOpenFileName` öffnet ein Dialogfeld, aus dem der Benutzer einen
Dateinamen auswählen kann.

.. function::  ssFileName = GetOpenFileName()
    ssFileName = GetOpenFileName(ssDir)
    ssFileName = GetOpenFileName(ssDir, ssFilter)
    ssFileName = GetOpenFileName(ssDir, ssFilter, nFilterindex)
    ssFileName = GetOpenFileName(ssDir, ssFilter, nFilterindex, bMultipleSelect)
    ssFileName = GetOpenFileName(ssDir, ssFilter, nFilterindex, bMultipleSelect, ssTitle)
    <ssFileName, nFilter> = GetOpenFileName()
    <ssFileName, nFilter> = GetOpenFileName(ssDir)
    <ssFileName, nFilter> = GetOpenFileName(ssDir, ssFilter)
    <ssFileName, nFilter> = GetOpenFileName(ssDir, ssFilter, nFilterindex)
    <ssFileName, nFilter> = GetOpenFileName(ssDir, ssFilter, nFilterindex, bMultipleSelect)
    <ssFileName, nFilter> = GetOpenFileName(ssDir, ssFilter, nFilterindex, bMultipleSelect, ssTitle)

.. us.return

**Returnwert**

Die Funktion gibt entweder einen gültigen Dateinamen zurück (komplett mit
Laufwerks- und Pfadangabe) oder einen leeren String, falls der Benutzer die
Schaltfläche **Abbrechen** gewählt hat. Wird die Funktion mit vier Parametern
aufgerufen und ist *bMultipleSelect* TRUE, kann der Benutzer mehrere Dateinamen
auswählen. In diesem Fall gibt die Funktion einen String-Vektor mit den
ausgewählten Dateinamen zurück. Wenn die Funktion mit zwei Rückgabeparametern
aufgerufen wird, gibt sie in *nFilter* zurück welcher Filter selektiert wurde.

.. us.params

**Parameter**

.. uparam:: ssDir

   Mit dem Parameter *ssDir* kann ein Pfad vorgegeben werden. Beispiel:
   :file:`c:\\Programme\\UniPlot\\Data`. Falls *ssDir* einen vollständigen
   Dateinamen enthält, wird der Name zur Initialisierung der Textfeldes Dateinamen
   verwendet, falls die Datei existiert.

.. uparam:: ssFilter

   Der Filterstring *ssFilter* kann ein oder mehrere Formatangaben für die Liste
   der Dateiformate enthalten. Der Filterstring muss folgenden Aufbau haben, z. B.

   ::

      "Alle Dateien (*.*)|*.*|"

   Falls mehrere Formatangaben vorgegeben werden sollen, können
   sie hintereinander gehängt werden, z. B.::

      "Text-Dateien (*.txt)|*.txt|Alle Dateien (*.*)|*.*|"

.. uparam:: nFilterindex

   Der Parameter legt fest, welcher Filter selektiert ist, wenn das Dialogfeld
   auf dem Monitor dargestellt wird. Die Nummerierung der Filter beginnt bei 1.

.. uparam:: bMultipleSelect

   Wenn *bMultipleSelect* den Wert TRUE (1) hat, kann der Benutzer mehrere
   Dateinamen auswählen.

.. uparam:: ssTitle

   Zeichenkette mit dem Dialogtitel.

.. us.example

**Beispiel**

::

   GetOpenFileName() // liefert z. B.:
         d:/data/test.dat

   ssFileName = GetOpenFileName("c:", ..
             "UniScript Files (*.ic)|*.ic|" + ..
             "All Files (*.*)|*.*|")
   if (ssFileName != "") {
       // Load the file ssFileName.
   }

.. seealso::
   :ref:`uberblick-dateien`,
   :ref:`uberblick-dialogboxen`,
   :ref:`GetSaveFileName`,
   :ref:`GetOpenFileName_Data`,
   :ref:`DialogBox`,
   :ref:`MessageBox`

:sub:`id-139001`