SaveFileRequester

SaveFileRequester()

Syntax

DateiName$ = SaveFileRequester(Titel$, StandardDatei$, Pattern$, PatternPosition)

Beschreibung

Öffnet einen Standard-Requester für den Anwender zum Auswählen einer zu speichernden Datei.

Parameter

Titel$ Der Titel des Requester-Fensters.

StandardDatei$ Der beim Öffnen des Requesters zu verwendende Dateiname.

Pattern$ Ein Standard-Filter, welcher nur die Anzeige von Dateien mit dieser oder jener Dateiendung erlaubt. Er muss in der folgenden Form angegeben werden: "Text-Dateien | *.txt | Musik-Dateien | *.mus;*.mod". Der Pattern arbeitet immer paarweise: Name (welcher wirklich im Filter erscheint) und Endung (z.B. *.txt). Mehrere für einen Typ mögliche Endungen können unter Benutzung des ; (Semikolon) angegeben werden. (Nicht unterstützt auf OSX, der Requester zeigt immer alle Dateien.)

PatternPosition Gibt an, welcher Pattern als Standard eingestellt sein soll. Mögliche Werte sind 0 bis zur Anzahl der Patterns minus 1 (da der Index für den ersten Pattern bei 0 beginnt). Sobald der Requester geschlossen wurde, kann SelectedFilePattern() benutzt werden, um den ausgewählten Pattern zu ermitteln. (Nicht unterstützt auf OSX.)

Rückgabewert

Der ausgewählte Dateiname - oder ein leerer String, wenn der Requester vom Anwender abgebrochen wurde.

Anmerkungen

Der zurückgegebene 'DateiName$' kann mit den folgenden Funktionen einfach in Datei-, Pfad- und Dateiendung-String zerlegt werden: GetFilePart(), GetPathPart() und GetExtensionPart().

Beispiel

  StandardFile$ = "C:\autoexec.bat"   ; anfänglichen Pfad + Dateiname festlegen
  ; Mit dem nächsten String werden die Pattern (mit "|" als Trennzeichen) für anzuzeigende
  ; Dateitypen festgelegt:
  ;  Erster:  "Text (*.txt)" als Name, ".txt" und ".bat" als erlaubte Dateiendungen
  ;  Zweiter: "PureBasic (*.pb)" als Name, ".pb" al erlaubte Dateiendung
  ;  Dritter: "Alle Dateien (*.*) als Name, "*.*" als erlaubte Dateiendung, gültig für alle Dateien
  Pattern$ = "Text (*.txt)|*.txt;*.bat|PureBasic (*.pb)|*.pb|Alle Dateien (*.*)|*.*"
  Pattern = 0    ; wir verwenden den ersten von drei möglichen Pattern als Standard
  File$ = SaveFileRequester("Bitte Datei zum Speichern auswählen", StandardFile$, Pattern$, Pattern)
  If File$
    MessageRequester("Information", "Sie haben folgende Datei ausgewählt:"+Chr(10)+File$, 0)
  Else
    MessageRequester("Information", "Der Requester wurde abgebrochen.", 0) 
  EndIf

Unterstützte OS

Alle

<- PathRequester() - Requester Inhaltsverzeichnis - SelectedFilePattern() ->

Titel$	Der Titel des Requester-Fensters.
StandardDatei$	Der beim Öffnen des Requesters zu verwendende Dateiname.
Pattern$	Ein Standard-Filter, welcher nur die Anzeige von Dateien mit dieser oder jener Dateiendung erlaubt. Er muss in der folgenden Form angegeben werden: "Text-Dateien \| .txt \| Musik-Dateien \| .mus;.mod". Der Pattern arbeitet immer paarweise: Name (welcher wirklich im Filter erscheint) und Endung (z.B. .txt). Mehrere für einen Typ mögliche Endungen können unter Benutzung des ; (Semikolon) angegeben werden. (Nicht unterstützt auf OSX, der Requester zeigt immer alle Dateien.)
PatternPosition	Gibt an, welcher Pattern als Standard eingestellt sein soll. Mögliche Werte sind 0 bis zur Anzahl der Patterns minus 1 (da der Index für den ersten Pattern bei 0 beginnt). Sobald der Requester geschlossen wurde, kann SelectedFilePattern() benutzt werden, um den ausgewählten Pattern zu ermitteln. (Nicht unterstützt auf OSX.)