LOCFILE( )-Funktion

Sucht auf der Festplatte nach einer Datei und gibt den Dateinamen einschließlich seinem Pfad zurück.

LOCFILE(cFileName [, cFileExtensions] [, cFileNameCaption])

Rückgabewerte

Zeichen

Parameter

• cFileName
  Bezeichnet den Namen der zu suchenden Datei. Enthält cFileName nur einen Dateinamen, sucht LOCFILE( ) zuerst im Visual FoxPro-Standardverzeichnis bzw. -ordner. Wird die Datei dort nicht gefunden, wird anschließend im Visual FoxPro-Pfad gesucht. Den Visual FoxPro-Pfad können Sie mit SET PATH angeben.

  Enthält cFileName einen Pfad und einen Dateinamen, wird im angegebenen Verzeichnis gesucht. Ist die Datei dort nicht auffindbar, durchsucht LOCFILE( ) erst das Visual FoxPro-Standardverzeichnis bzw. den Standardordner und anschließend den Visual FoxPro-Pfad.

  Wenn die Datei gefunden wird, gibt LOCFILE( ) den Dateinamen und den Pfad zurück.

• cFileExtensions
  Bezeichnet Dateierweiterungen für die zu suchende Datei. Enthält der in cFileName angegebene Dateiname keine Erweiterung, verwendet Visual FoxPro die in cFileExtensions aufgelisteten Erweiterungen und sucht erneut nach der Datei.

  Ist sie nicht auffindbar, gibt cFileExtensions außerdem die Erweiterungen der im Dialogfeld Öffnen angezeigten Dateien an.

  cFileExtensions kann verschiedene Formate besitzen:

  • Enthält cFileExtensions eine einzige Erweiterung (z. B. PRG), werden nur Dateien mit dieser Erweiterung angezeigt.

  • cFileExtensions kann auch Platzhalterzeichen (* und ?) enthalten. Es werden dann alle Dateien angezeigt, deren Erweiterungen die Platzhalterkriterien erfüllen. Wenn z. B. cFileExtensions ?x? ist, werden alle Dateien mit den Erweiterungen FXP, EXE, oder TXT angezeigt.

  • In Visual FoxPro für Windows kann cFileExtensions eine Dateibeschreibung, gefolgt von einer einzelnen oder einer Liste von durch Kommas getrennten Dateinamenerweiterungen enthalten. Die Dateibeschreibung wird im Listenfeld Dateityp angezeigt. Trennen Sie die Dateibeschreibung von der Dateinamenerweiterung bzw. der Liste mit Dateinamenerweiterungen mit einem Doppelpunkt (:). Verwenden Sie ein Semikolon (;), um mehrere Dateibeschreibungen von ihren Erweiterungen zu trennen.

    Wenn Sie z. B. Text:txt für cFileExtensions angeben, wird die Dateibeschreibung Text im Listenfeld Dateityp sichtbar und alle Dateien mit der Erweiterung TXT werden angezeigt.

    Wird für cFileExtensions Tabellen:dbf; Dateien:txt,bak angegeben, werden die Dateibeschreibungen Tabellen und Dateien im Listenfeld Dateityp angezeigt. Bei Wahl von Tabellen aus dem Listenfeld Dateityp, werden alle Dateien mit der Erweiterung DBF angezeigt. Bei Wahl von Dateien werden alle Dateien mit den Erweiterungen TXT und BAK angezeigt.

• cFileNameCaption
  Gibt den Text an, der den Benutzer zur Eingabe auffordert. Dieser Text wird links neben dem Textfeld angezeigt, in dem Sie den Dateinamen eingeben. Wird das Argument weggelassen, erfolgt die Anzeige von Dateiname: .

Eine Liste mit den Visual FoxPro-Dateierweiterungen und den entsprechenden Creator Types finden Sie in der Hilfe unter Dateierweiterungen und Dateitypen.

Hinweise

Ist die Datei im Standardverzeichnis bzw. -ordner, im Visual FoxPro-Pfad oder in einem angegebenen Verzeichnis nicht auffindbar, wird das Dialogfeld Öffnen angezeigt. Mit diesem Dialogfeld kann nach der Datei gesucht werden. Bei Wahl einer Datei im Dialogfeld Öffnen wird der Dateiname zusammen mit dem Pfad zurückgegeben.

Wird das Dialogfeld mit Abbrechen, ESC oder durch Wählen des Befehls Schließen aus dem Systemmenü verlassen, generiert Visual FoxPro eine Fehlermeldung und LOCFILE( ) gibt keinen Wert zurück.

Siehe auch

FILE( ) | GETFILE( ) | GETPICT( ) | PUTFILE( ) | SET PATH