#INCLUDE (Directiva del preprocesador)

Visual Studio .NET 2003

Indica al preprocesador de Visual FoxPro que trate el contenido de un determinado archivo de encabezado como si apareciera en un programa de Visual FoxPro.

#INCLUDE FileName

Parámetros

FileName
Especifica el nombre del archivo de encabezado que se combina en el programa durante la compilación.

Puede incluir una ruta de acceso con el nombre de archivo de encabezado. Cuando incluye una ruta de acceso con el nombre de archivo de encabezado, Visual FoxPro sólo busca el archivo de encabezado en la ubicación especificada.

Si no incluye una ruta de acceso con el nombre de archivo de encabezado, Visual FoxPro busca el archivo en el directorio predeterminado de Visual FoxPro y, a continuación, en la ruta de acceso de Visual FoxPro. La ruta de acceso de Visual FoxPro se especifica con SET PATH.

Observaciones

Es posible crear archivos de encabezado que contengan directivas del preprocesador y, a continuación, utilizar #INCLUDE para combinar el contenido del archivo de encabezado en un programa cuando se compila. El contenido del archivo de encabezado se inserta en el programa durante la compilación en el punto en que aparezca #INCLUDE.

En un archivo de encabezado sólo se reconocen las directivas del preprocesador #DEFINE ... #UNDEF, #IF ... #ENDIF, and #INCLUDE. Se ignoran los comentarios y los comandos de Visual FoxPro que se incluyan en un archivo de encabezado.

Un programa puede contener cualquier número de directivas #INCLUDE. Estas directivas pueden aparecer en cualquier punto del programa. Si introduce directivas #INCLUDE en archivos de encabezado, podrá anidar directivas #INCLUDE.

Los archivos de encabezado suelen tener la extensión .h, aunque pueden tener cualquier extensión. Se incluye un archivo de encabezado de Visual FoxPro, Foxpro.h. Contiene muchas de las constantes descritas a través de esta documentación.

Ejemplo

En el ejemplo siguiente, se utilizan dos archivos, Const.h, un archivo de encabezado, y Myprog.prg, un archivo de programa. El archivo de encabezado contiene varias directivas #DEFINE que crean constantes de tiempo de compilación. El archivo de programa utiliza #INCLUDE para combinar el archivo de encabezado Const.h durante la compilación, con lo que pone a disposición del programa las constantes de tiempo de compilación del archivo de encabezado.

*** 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

Vea también

#DEFINE ... #UNDEF (Directiva del preprocesador) | #IF ... #ENDIF (Directiva del preprocesador) | #IFDEF |#IF ... #ENDIF (Directiva del preprocesador) | #INCLUDE (Directiva del preprocesador)

Mostrar: