OpenFileRequester()

Syntax

DateiName$ = OpenFileRequester(Titel$, StandardDatei$, Pattern$, PatternPosition [, Flags])

Öffnet einen Standard-Requester für den Anwender zum Auswählen einer Datei. Der Titel kann angegeben werden, um den standardmäßigen Titel zu ersetzen. StandardDatei$ ist nützlich, um den Requester mit dem richtigen Verzeichnis und dem richtigen Dateinamen zu initialisieren.

Parameter

Titel$	Der Titel des Requester-Fensters.
StandardDatei$	Die Standard-Datei, welche beim Öffnen des Requesters angezeigt wird.
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.)
Flags (optional)	Dies kann der folgende Wert sein: #PB_Requester_MultiSelection : Schaltet die Mehrfach-Selektion ein. (siehe NextSelectedFileName())

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" als 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$ = OpenFileRequester("Bitte Datei zum Laden 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

Siehe auch

NextSelectedFileName()

Unterstützte OS

Alle