Funktionsreferenz

FileSaveDialog

Zeigt den "Datei speichern"-Dialog an.

FileSaveDialog ( "title", "init dir", "filter" [, options [, "default name" [, hwnd]]] )

 

Parameter

title Titel des Dialoges.
init dir Startverzeichnis, welches im Verzeichnisbaum markiert wird.
filter Dateifilter wie z. B. "Alle (*.*)" oder "Textdateien (*.txt)" oder Multifiltergruppen wie z. B."Alle (*.*)|Textdateien (*.txt)" (Siehe Bemerkungen).
options [optional] 2 = Pfad muss existieren (nur wenn der Benutzer einen Pfad eintippt; endet mit einem Backslash)
 16 = Frage beim Überschreiben einer Datei
default name [optional] Dateinamensvorschlag, unter dem die Datei gespeichert werden soll. Standard ist ein leerer String ("").
hwnd [optional] Das Fenster Handle welches als Parent für diesen Dialog verwendet werden soll.

 

Rückgabewert

Erfolg: Gibt den kompletten Pfad der ausgewählten Datei zurück. Rückgabe mehrerer Dateien wie folgt: "Verzeichnis|Datei1|Datei2|..."
Fehler: Setzt @error
@error: 1 - Dateiauswahl fehlgeschlagen.
2 - Ungültiger Dateifilter

 

Bemerkungen

Die Filter wie im Beispiel zu sehen mit Semikolon abtrennen.
Multifiltergruppen werden durch einen Strich "|" getrennt.

Wenn der Dateinamensvorschlag angegeben wird, müssen auch die "options" angegeben werden.
Wenn keine der "options"-Funktionen benötigt wird, muss "options" den Wert "0" erhalten.

Besondere Windows-Ordner (wie z.B "Eigene Dateien") können manchmal auch als Startverzeichnis gesetzt werden; siehe Anhang CLSIDs besonderer Ordner.

@WorkingDir wird bei erfolgreichem Rückgabewert geändert.

 

Verwandte Funktionen

FileOpenDialog, FileSelectFolder

 

Beispiel


$MyDocsFolder = "::{450D8FBA-AD25-11D0-98A8-0800361B1103}"

$var = FileSaveDialog( "Wähle einen Namen.", $MyDocsFolder, "Skripte (*.aut;*.au3)", 2)
; Option 2 = Dialog wird solange wiederholt, bis ein gültiger Pfad bzw. eine gültige Datei ausgewählt wurde.

If @error Then
    MsgBox(4096,"","Speichern abgebrochen.")
Else
    MsgBox(4096,"","Es wurde " & $var & " gewählt.")
EndIf


; Multifiltergruppen
$var = FileSaveDialog( "Wähle einen Namen.", $MyDocsFolder, "Skripte (*.aut;*.au3)|Textdateien (*.ini;*.txt)", 2)
; Option 2 = Dialog wird solange wiederholt, bis ein gültiger Pfad bzw. eine gültige Datei ausgewählt wurde.

If @error Then
    MsgBox(4096,"","Speichern abgebrochen.")
Else
    MsgBox(4096,"","Es wurde " & $var & " gewählt.")
EndIf