GetSaveFileName

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

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)

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.

Parameter

ssDir

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

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 (*.*)|*.*|"

nFilterIndex

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

ssTitle

Titel des Dialogfelds.

Beispiel

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

id-1115219