GETFILE( )-Funktion

  • Artikel

Zeigt das Dialogfeld Öffnen an und gibt den Namen der Datei zurück, die Sie ausgewählt haben.

GETFILE([cFileExtensions] [, cText] [, cOpenButtonCaption]
   [, nButtonType] [, cTitleBarCaption])

Rückgabewerte

Zeichen

Parameter

  • cFileExtensions
    Gibt die Dateinamenerweiterungen der Dateien an, die im Listenfeld angezeigt werden, wenn das Menüelement Alle Dateien nicht gewählt wird. Wenn Sie einen Wert als Literal übergeben, setzen Sie ihn in Anführungszeichen. Geben Sie vor den Dateinamenerweiterungen keinen Punkt (.) an.

    cFileExtensions kann verschiedene Formate besitzen:

    • Wenn cFileExtensions eine einzige Dateinamenerweiterung (z. B. PRG) enthält, werden nur Dateien mit dieser Dateinamenerweiterung angezeigt.

    • Wenn für cFileExtensions eine leere Zeichenfolge und cCreatorType nicht angegeben ist, werden alle Dateien des aktuellen Verzeichnisses angezeigt.

    • cFileExtensions kann auch Platzhalterzeichen (* und ?) enthalten. Es werden dann alle Dateien angezeigt, deren Dateinamenerweiterungen die Platzhalterkriterien erfüllen. Wenn Sie z. B. ?X? für cFileExtensions angeben, werden alle Dateien mit den Dateinamenerweiterungen FXP, EXE und TXT angezeigt.

    • In Visual FoxPro für Windows kann cFileExtensions eine Dateibeschreibung, gefolgt von einer einzelnen oder einer Liste von Dateinamenerweiterungen, die durch Kommas getrennt sein müssen, enthalten. Die Dateibeschreibung wird im Listenfeld Dateityp angezeigt. Trennen Sie die Dateibeschreibung von der Dateinamenerweiterung bzw. der Liste mit Dateinamenerweiterungen durch einen 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.

      Wenn Sie für cFileExtensions Tables:DBF; Files:TXT,BAK angeben, werden die Dateibeschreibungen Tables und Files im Listenfeld Dateityp angezeigt. Wenn Tables aus dem Listenfeld Dateityp ausgewählt wird, werden alle Dateien mit der Erweiterung DBF angezeigt. Wird Files aus dem Listenfeld Dateityp ausgewählt, werden alle Dateien mit den Erweiterungen TXT und BAK angezeigt.

    • Wenn Sie für cFileExtensions nur ein Semikolon (;) angeben, werden alle Dateien ohne Dateinamenerweiterung angezeigt.

  • cText
    Gibt den Text für die Verzeichnis- bzw. Ordnerliste des Dialogfeldes Öffnen an.

  • cOpenButtonCaption
    Gibt eine Beschriftung für die Schaltfläche OK an.

  • nButtonType
    Gibt die Anzahl und den Typ der Schaltflächen an, die im Dialogfeld Öffnen angezeigt werden. Die folgenden Schaltflächen werden im Dialogfeld angezeigt, wenn nButtonType 0, 1 oder 2 ist.

    nButtonType Schaltflächen
    0
    (oder keine Angabe)    		 OKAbbrechen
    1 OKNeuAbbrechen
    2 OKKeineAbbrechen

    Neu wird zusammen mit dem im Dialogfeld Öffnen angegebenen Pfad zurückgegeben, wenn nButtonType 1 ist und der/die Benutzer/in die Schaltfläche Neu wählt. Eine leere Zeichenfolge wird zurückgegeben, wenn nButtonType 2 ist und der/die Benutzer/in die Schaltfläche Keine wählt.

  • cTitleBarCaption
    Gibt die Beschriftung für die Titelleiste an

Hinweise

GETFILE( ) gibt eine leere Zeichenfolge zurück, wenn Sie das Dialogfeld Öffnen durch Drücken von ESC schließen, Abbrechen wählen oder aus dem Systemmenü den Befehl Schließen wählen.

Beispiel

CLOSE DATABASES
SELECT 0

gcTable = GETFILE('DBF', 'Browse or Create a .DBF:', 'Browse', 1;   'Browse or Create')
DO CASE
   CASE 'Untitled' $ gcTable
      CREATE (gcTable)
   CASE EMPTY(gcTable)
      RETURN
   OTHERWISE
      USE (gcTable)
      BROWSE
ENDCASE

Siehe auch

FULLPATH( ) | GETEXPR | GETPICT( ) | LOCFILE( ) | PUTFILE( )