#INCLUDE-Präprozessordirektive

Weist den Visual FoxPro-Präprozessor an, den Inhalt einer angegebenen Header-Datei so zu behandeln, als würde er in einem Visual FoxPro-Programm stehen.

#INCLUDE FileName

Parameter

• FileName
  Gibt den Namen der Header-Datei an, die beim Kompilieren in das Programm eingebunden wird.

  Sie können zusammen mit dem Namen der Header-Datei einen Pfad angeben. In diesem Fall sucht Visual FoxPro die Header-Datei nur im angegebenen Pfad.

  Wenn Sie keinen Pfad angeben, sucht Visual FoxPro die Header-Datei im Visual FoxPro-Standardverzeichnis und danach im Visual FoxPro-Pfad. Der Visual FoxPro-Pfad wird mit SET PATH angegeben.

Hinweise

Sie können eine Header-Datei erstellen, die Präprozessordirektiven enthält, und den Inhalt der Header-Datei dann beim Kompilieren eines Programms mit Hilfe von #INCLUDE in das Programm einbinden. Der Inhalt der Header-Datei wird beim Kompilieren an der Stelle in das Programm eingefügt, an der #INCLUDE im Programm vorkommt.

In einer Header-Datei werden nur die #DEFINE ... #UNDEF-, #IF ... #ENDIF- und #INCLUDE-Präprozessordirektiven erkannt. Kommentare und Visual FoxPro-Befehle in einer Header-Datei werden ignoriert.

Ein Programm kann eine beliebige Anzahl von #INCLUDE-Direktiven enthalten. Diese Direktiven können an beliebiger Stelle im Programm vorkommen. Durch Einfügen von #INCLUDE-Direktiven in Header-Dateien können Sie #INCLUDE-Direktiven verschachteln.

Header-Dateien werden normalerweise mit der Erweiterung H versehen, sie können jedoch auch eine beliebige andere Erweiterung haben. Eine Visual FoxPro-Header-Datei, Foxpro.H, gehört zum Lieferumfang. Diese Datei enthält viele der Konstanten, die in dieser Dokumentation beschrieben sind.

Beispiel

Im folgenden Beispiel werden zwei Dateien verwendet: Const.H, eine Header-Datei, und Myprog.PRG, eine Programmdatei. Die Header-Datei enthält verschiedene #DEFINE-Direktiven, mit denen Kompilierzeitkonstanten erstellt werden. Die Programmdatei verwendet #INCLUDE, um die Header-Datei Const.H beim Kompilieren einzubinden, wodurch die Kompilierzeitkonstanten in der Header-Datei für das Programm verfügbar werden.

** Header file CONST.H ** #DEFINE ERROR_NODISK 1 #DEFINE ERROR_DISKFULL 2 #DEFINE ERROR_UNKNOWN 3

** Program file MYPROG.PRG ** #INCLUDE CONST.H

FUNCTION chkerror
PARAMETER errcode
  DO CASE
  CASE errcode = ERROR_NODISK
  ?"Error - No Disk"
  CASE errcode = ERROR_DISKFULL
  ?"Error - Disk Full"
  CASE errcode = ERROR_UNKNOWN
  ?"Unknown Error"
  ENDCASE
RETURN

Siehe auch

#DEFINE ... #UNDEF-Präprozessordirektive | #IF ... #ENDIF-Präprozessordirektive | #IFDEF |#IFNDEF ... #ENDIF-Präprozessoranweisung | #INCLUDE-Präprozessordirektive