set library 命令

请参阅

打开一个外部的 API(应用程序接口)库文件。

语法

SET LIBRARY TO [FileName [ADDITIVE]]

参数
FileName

指定要打开的 API 库文件名或过程文件名。
FoxPro for MS-DOS 中，假定库文件有 .PLB 扩展名。如果库文件有 .PLB 扩展名，就不必在文件名中写入扩展名；如果库文件的扩展名不是 .PLB，就必须在文件名中写上扩展名。
Visual FoxPro 和 FoxPro for Windows 中，假定库文件有 .FLL 扩展名。如果库文件有 .FLL 扩展名，就不必在文件名中写入扩展名；如果库文件的扩展名不是 .FLL，就必须在文件名中写上扩展名。
FoxPro for Macintosh 中，假定库文件有 .MLB 扩展名。如果库文件有 .MLB 扩展名，就不必在文件名中写入扩展名；如果库文件的扩展名不是 .MLB，就必须在文件名中写上扩展名。

重要内容

• 在一个平台上，不能使用在其他平台上建立的 API 库。例如，为 FoxPro for MS-DOS 建立的库，就不能在 Visual FoxPro 中使用；为 Visual FoxPro 建立的库，则不能在 FoxPro for MS-DOS 中使用。
  
• 在一个版本中，不能使用另一个版本的 API 库。例如，在 Visual FoxPro 中，不能使用 FoxPro for Windows 建立的库，必须用 Visual FoxPro 专业版重新编译并链接。
  

Visual FoxPro 假定过程文件的扩展名为 .PRG。
当使用 DO ProcedureName 执行一个过程时，Visual FoxPro 以如下顺序在下列文件中查找过程：

• 在包含 DO ProcedureName 命令的文件中进行查找。
  
• 使用 SET PROCEDURE 命令打开的过程文件(如果存在的话)。
  
• 在执行链中的程序。Visual FoxPro 从最近执行的程序中开始查找程序文件，一直查到第一个执行程序。
  
• 使用 set library 命令打开的过程文件(如果设置过)。
  
• 单独的程序文件。如果 Visual FoxPro 找到一个与 DO 指定的文件名相同的程序文件时，执行这个程序；如果找不到匹配的程序文件名，Visual FoxPro 产生出错信息。

ADDITIVE

打开附加的 API 库。ADDITIVE放在 set library 命令中文件名后面。
当使用 SET LIBRARY 打开一个过程文件时，Visual FoxPro 忽略 ADDITIVE 子句。

说明

使用 SET LIBRARY 打开外部应用程序接口 (API) 库或过程文件。
API 例程库可以增强 Visual FoxPro 语言能力和用户界面。如果打开一个外部 API 库，就可以象使用 Visual FoxPro 函数一样使用 API 函数。要显示库中可用的函数，请使用 DISPLAY STATUS 或 LIST STATUS 命令。
在 Visual FoxPro 专业版中，可以使用已有 API 函数，也可以创建自已的 API 库。
要从内存中移去所有 API 函数，请使用不包括 FileName 和 ADDITIVE 的 SET LIBRARY TO 命令；要从内存中移去单个库，请使用 RELEASE LIBRARY LibraryName 命令。

如果指定过程文件，那么所有程序都可使用过程文件中的过程，并且也可以在命令窗口中，以交互方式使用这些过程。

附注
Visual FoxPro 使用 SET LIBRARY 打开过程文件的功能与 dBASE IV 兼容。使用 SET LIBRARY 打开过程文件会关闭所有打开的 API 库。使用 SET LIBRARY 打开 API 库会关闭用 SET LIBRARY 打开的过程文件，请使用 SET PROCEDURE 打开过程文件，防止关闭 API 库。

有关过程文件的详细内容，请参阅 PROCEDURE 和 SET PROCEDURE。