Incluir recursos en aplicaciones

Visual FoxPro proporciona varios archivos de recursos que amplían la funcionalidad básica de las aplicaciones, entre los que se incluyen archivos de recursos FOXUSER, bibliotecas API y controles ActiveX. Si utiliza estos archivos, necesitará incluirlos en el árbol del proyecto o de distribución.

Para obtener detalles acerca de cómo incluir archivos en el programa de instalación, consulte la Ayuda asociada al programa de creación de instalaciones que esté utilizando. El programa de creación de instalaciones que elija debe crear paquetes de instalación MSI mediante la tecnología Windows Installer.

Incluir archivos de recursos FOXUSER

Los archivos de recursos de Visual FoxPro almacenan información útil para las aplicaciones, incluyendo las posiciones de las ventanas, las configuraciones de la ventana Examinar y definiciones de etiquetas. Si su aplicación utiliza cualquiera de estos elementos de recursos, deberá distribuir con ella la base de datos FOXUSER y los archivos memo o los archivos de recursos que cree específicamente para su aplicación. Estos archivos de recursos constan de una tabla de Visual FoxPro asociada a un archivo memo, normalmente denominados FoxUser.dbf y FoxUser.fpt.

Nota   El archivo de recursos FOXUSER no es el mismo que el archivo de recursos que depende de la configuración regional que contiene cuadros de diálogo y mensajes de error. El archivo de recursos FOXUSER almacena información de aplicación como macros definidas por usted; el archivo de recursos que depende de la configuración regional almacena cadenas de texto del sistema.

Incluir archivos de biblioteca externa

Si su aplicación incluye archivos de biblioteca externa como controles ActiveX (archivos .ocx) o bibliotecas de API de Visual FoxPro (archivos .fll), asegúrese de que se colocan en el directorio apropiado del paquete de instalación. Puede distribuir el archivo FoxTools.fll de Visual FoxPro con sus aplicaciones. Para obtener más información acerca de la creación de bibliotecas externas para tener acceso a la API de Visual FoxPro, consulte Acceso a las API.

Incluir controles Active X y componentes COM

Si incluye controles ActiveX o ha creado un servidor de Automatización (un componente COM) como parte de su aplicación, incluya cualquier archivo .ocx y .dll en su proyecto y asegúrese de que se instalan los archivos de soporte necesarios en la ubicación adecuada en el equipo del usuario. Observe que el Logotipo de Windows 2000 no recomienda la instalación de componentes en el directorio del sistema de Windows. Tenga en cuenta que sólo puede distribuir controles ActiveX de los que tenga licencia. Para los servidores de Automatización, también debe incluir archivos de registro, como bibliotecas de tipos (archivos .tlb) y archivos de registro (archivos .vbr) en su aplicación.

Si utiliza el programa de creación de instalaciones para crear los discos de distribución, se puede incluir estos archivos automáticamente. De esta manera, el programa de creación de instalaciones asegurará que los componentes COM se registran correctamente en el equipo del usuario cuando se instale la aplicación. Para obtener más información acerca de cómo incluir archivos en el programa de creación de instalaciones, consulte la Ayuda asociada al programa.

Todos los usuarios pueden ejecutar formularios que contengan controles ActiveX; sin embargo, su aplicación no puede llevar a cabo ciertas tareas si se ejecuta con la versión de tiempo de ejecución de Visual FoxPro. Recuerde las siguientes instrucciones:

• La aplicación se tiene que ejecutar en una versión completa de Visual FoxPro para modificar formularios, clases o subclases que incluyan controles ActiveX.

• La aplicación debe ejecutarse bajo una versión completa de Visual FoxPro para agregar controles ActiveX a formularios en tiempo de ejecución. Por ejemplo, la versión completa de Visual FoxPro es necesaria para agregar el control Outline a un formulario ejecutando el código siguiente:

  PUBLIC frmOleNewForm
  frmOleNewForm = CREATEOBJECT("form")
  frmOleNewForm.Show
  frmOleNewForm.ScaleMode = 3
  frmOleNewForm.Addobject("NewOutline","OLEControl",;
     "MSOutl.Outline")
  

  Nota   Cuando se cierra un formulario, los controles agregados en tiempo de ejecución no se guardan.

• Su aplicación se puede ejecutar con la versión de tiempo de ejecución o con la versión completa de Visual FoxPro para agregar subclases de controles ActiveX a un formulario en tiempo de ejecución. Por ejemplo, puede definir la subclase RedOutline a partir de la clase Outline y distribuir la subclase en Olelib.vcx; todos los usuarios pueden agregar entonces el control RedOutline a un formulario ejecutando el código siguiente:

  PUBLIC frmOleNewForm
  frmOleNewForm = CREATEOBJECT("form")
  frmOleNewForm.Show
  frmOleNewForm.ScaleMode = 3
  SET CLASSLIB TO CURR() + OLELIB.VCX
  frmOleNewForm.Addobject("NewOutline","RedOutline")
  

Incluir un archivo de configuración

El archivo de configuración, Config.fpw, puede establecer numerosos valores predeterminados de Visual FoxPro. Por ejemplo, es posible cambiar el título de Visual FoxPro, su color de fondo y la forma en que el usuario se desplaza mediante el teclado.

Si desea que el archivo de configuración sea de sólo lectura, sitúelo en el proyecto y márquelo como incluido. Si desea que la configuración sea modificable, incluya el archivo en el proyecto y márquelo como excluido. A continuación, distribuya el archivo de configuración con el archivo de aplicación o con el ejecutable, en forma de archivo independiente. En cualquiera de los casos, es necesario que el archivo de configuración se denomine Config.fpw. Sin embargo, puede especificar un nombre de archivo de configuración diferente mediante el modificador de línea de comandos C al iniciar Visual FoxPro.

Para obtener más información acerca de las opciones que puede establecer en el archivo de configuración, consulte “Utilizar un archivo de configuración” en Personalizar el entorno de Visual FoxPro.

Incluir un archivo de recursos dependiente de la configuración regional

Si va a distribuir su aplicación con la versión de tiempo de ejecución de Visual FoxPro, es posible que tenga que incluir un archivo de recursos que dependa de la configuración regional. Este archivo contiene los cuadros de diálogo y otros elementos de interfaz de usuario que Visual FoxPro usa para interactuar con el usuario. Hay un archivo de recursos de tiempo de ejecución diferente para cada idioma que tenga una versión disponible de Visual FoxPro.

Para obtener más información acerca del uso de archivos de tiempo de ejecución dependientes de la configuración regional, consulte “Distribuir archivos de tiempo de ejecución dependientes de la configuración regional” en Desarrollar aplicaciones internacionales.

Nota   El archivo de recursos dependiente de la configuración regional no es el mismo que el archivo de recursos FOXUSER, que almacena información de la aplicación, como macros definidas por el usuario. El archivo de recursos dependiente de la configuración regional almacena cadenas de texto del sistema.

Si desea crear una aplicación para plataformas de Oriente Medio, asegúrese de agregar el archivo VBAME.DLL al conjunto de distribución e instalarlo en el directorio del sistema de Windows.

Incluir archivos de Ayuda

Si crea una Ayuda gráfica para su aplicación, incluya el archivo .chm o .hlp en el directorio de distribución de la aplicación para que el programa de creación de instalaciones lo incluya en sus discos de distribución. Para obtener detalles acerca de cómo crear Ayuda, consulte Agregar ayuda a la aplicación personalizada.

Nota   No puede distribuir Winhelp.exe o los archivos de Ayuda distribuidos con Visual FoxPro. Para obtener más información, consulte Quitar características y archivos restringidos de Visual FoxPro.

Incluir todos los archivos

Puede reproducir y distribuir libremente algunos de los archivos, gráficos y programas de Visual FoxPro con las aplicaciones que cree. Para obtener detalles, consulte Quitar características y archivos restringidos de Visual FoxPro.

Antes de generar una aplicación, asegúrese de que su proyecto incluye los archivos necesarios para la aplicación, así como cualquier archivo de recursos adicional, como pueden ser archivos gráficos o plantillas.

La tabla siguiente muestra los archivos que puede agregar al proyecto.

Para agregar archivos a su aplicación

• Incluya los archivos en el proyecto.

  Si no desea modificarlos en la aplicación distribuida, sitúe los archivos en el proyecto y márquelos como incluidos. Estos archivos serán de sólo lectura y no admitirán cambios.

  –O bien–

• Agregue los archivos al directorio de la aplicación para que el programa de creación de instalaciones tenga acceso a ellos.

  Si desea modificar los archivos, sitúelos dentro del proyecto y márquelos como excluidos. A continuación, distribúyalos con su aplicación como archivos independientes.

Para obtener más información acerca de cómo crear un proyecto y cómo incluir o excluir archivos en un proyecto, consulte Compilar una aplicación.

Vea también

Opciones de menú | Quitar características y archivos restringidos de Visual FoxPro | Proteger y documentar el código fuente | Preparar una aplicación para su distribución