.. highlightlang:: us

.. index:: GetSaveFileName

.. _getsavefilename:

GetSaveFileName
===============

.. us.tag  GetSaveFileName GERMAN FILE_MISC DialogBoxes

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

.. function::  ssFilename = GetSaveFileName()
    ssFilename = GetSaveFileName(ssDir)
    ssFilename = GetSaveFileName(ssDir, ssFilter)
    ssFilename = GetSaveFileName(ssDir, ssFilter, nFilterIndex)
    ssFilename = GetSaveFileName(ssDir, ssFilter, nFilterIndex, ssTitle)
    <ssFilename, nFilter> = GetSaveFileName()
    <ssFilename, nFilter> = GetSaveFileName(ssDir)
    <ssFilename, nFilter> = GetSaveFileName(ssDir, ssFilter)
    <ssFilename, nFilter> = GetSaveFileName(ssDir, ssFilter, nFilterIndex)
    <ssFilename, nFilter> = GetSaveFileName(ssDir, ssFilter, nFilterIndex, 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.

.. us.params

**Parameter**

.. uparam:: ssDir

   Mit dem Parameter *ssDir* kann ein Pfad vorgegeben werden. Beispiel:
   :file:`c:/Programme/UniPlot/Samples`.
   Falls *ssDir* einen vollständigen Dateinamen enthält, wird der Name zur
   Initialisierung der Textfelds Dateinamen verwendet.

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

   Titel des Dialogfelds.

.. us.example

**Beispiel**

::

   * GetSaveFileName() // liefert z. B.:
   d:/data/test.dat
   * GetSaveFileName("c:", ..
         "UniScipt-Dateien (*.ic)|*.ic|" + ..
         "Alle Dateien (*.*)|*.*|").

.. seealso::
   :ref:`uberblick-dateien`,
   :ref:`GetOpenFileName`,
   :ref:`DialogBox`,
   :ref:`MessageBox`

:sub:`id-1115219`