Share via

SET LIBRARY (Comando)

  • Artículo

Abre un archivo de biblioteca API (interfaz de programación de aplicaciones) externa.

SET LIBRARY TO [FileName [ADDITIVE]]

Parámetros

  • FileName
    Especifica el nombre del archivo de la biblioteca API o del archivo de procedimiento que desee abrir.

    Visual FoxPro supone una extensión .fll para las bibliotecas. Si una biblioteca tiene la extensión .fll, no necesita incluir la extensión con el nombre del archivo. Si una biblioteca tiene una extensión distinta de .fll, debe incluir la extensión con el nombre del archivo.

    Precaución   Cuando utilice SET LIBRARY, no olvide que:

    • No puede usar bibliotecas de API creadas para una plataforma en otra plataforma. Por ejemplo, las bibliotecas creadas para FoxPro para MS-DOS no pueden usarse en Visual FoxPro; las bibliotecas creadas para Visual FoxPro no pueden usarse en FoxPro para MS-DOS.
    • No puede usar bibliotecas de API creadas para una versión en otra versión. Por ejemplo, no puede usar bibliotecas creadas para FoxPro versión 2.6 en Visual FoxPro. Es necesario volver a compilar y vincular.

    Visual FoxPro supone que los archivos de procedimiento tienen la extensión .prg.

    Cuando ejecute un procedimiento con DO ProcedureName, Visual FoxPro buscará el procedimiento en los siguientes archivos y por este orden:

    • El archivo que contiene DO ProcedureName.
    • Un archivo de procedimiento abierto con SET PROCEDURE (si hay alguno definido).
    • Los programas de la cadena de ejecución. Visual FoxPro busca en los archivos de programa comenzando por el programa ejecutado más recientemente y continuando hacia atrás hasta llegar al primer programa ejecutado.
    • Un archivo de procedimiento abierto con SET LIBRARY (si hay alguno definido).
    • Un archivo de programa independiente. Si Visual FoxPro encuentra un archivo de programa con el mismo nombre que el archivo especificado con DO, ejecutará este programa. Si no encuentra ningún nombre de archivo de programa que coincida, Visual FoxPro mostrará un mensaje de error.

  • ADDITIVE
    Abre bibliotecas API adicionales. Incluya ADDITIVE después del nombre de archivo en comandos SET LIBRARY sucesivos.

    Visual FoxPro pasa por alto ADDITIVE cuando se utiliza SET LIBRARY para abrir un archivo de procedimiento.

Observaciones

Utilice SET LIBRARY para abrir bibliotecas externas de Interfaz de programación de aplicaciones (API) o un archivo de procedimiento.

Las bibliotecas de rutinas API amplían las posibilidades del lenguaje Visual FoxPro y la interfaz de usuario. Una vez que se abre una biblioteca de rutinas API externas, puede utilizar las funciones API como si fueran funciones de Visual FoxPro. Use DISPLAY STATUS o LIST STATUS para mostrar las funciones disponibles en la biblioteca.

Puede utilizar las bibliotecas API existentes o crear las suyas propias.

En Visual FoxPro, el procedimiento más recomendable para registrar funciones en bibliotecas compartidas es utilizar el comando DECLARE - DLL.

Para eliminar de la memoria todas las bibliotecas API, use SET LIBRARY TO sin incluir FileName ni ADDITIVE. Para eliminar una sola biblioteca de la memoria, use RELEASE LIBRARY LibraryName.

Si especifica un archivo de procedimiento, los procedimientos incluidos en ese archivo estarán disponibles para todos los programas, y también lo estarán de forma interactiva a través de la ventana Comandos.

Nota   La capacidad de Visual FoxPro para abrir un archivo de procedimientos con SET LIBRARY proporciona compatibilidad con dBASE IV. El uso de SET LIBRARY para abrir un archivo de procedimiento cerrará todas las bibliotecas API abiertas. Al utilizar SET LIBRARY para abrir bibliotecas API se cerrará un archivo de procedimiento abierto con SET LIBRARY. Use SET PROCEDURE para abrir un archivo de procedimiento y evitar que se cierren las bibliotecas API.

Para obtener más información acerca de los archivos de procedimiento, vea PROCEDURE y SET PROCEDURE.

Vea también

CALL | DISPLAY STATUS | LIST | LOAD | RELEASE