Открывает внешний библиотечный файл API (Application Programming Interface).

SET LIBRARY TO [FileName [ADDITIVE]]

Параметры

FileName

Определяет имя открываемого файла внешней библиотеки API или процедурного файла.

Система Visual FoxPro предполагает для данных библиотек расширение (.fll). Если рассматриваемая библиотека имеет данное расширение, .fll, то вы можете не указывать его с именем файла. Если файл библиотеки внешних функций имеет другое расширение, отличное от .fll, вы должны указать имя файла библиотеки вместе с расширением.

Caution noteОбратите Внимание

При использовании команды SET LIBRARY, вы должны помнить о следующем:

  • Вы не можете использовать библиотеки API, созданные для разных платформ, операционных систем. Например, библиотеки, созданные для FoxPro / MS-DOS не могут быть использованы в Visual FoxPro; библиотеки, созданные для Visual FoxPro, не могут быть использованы в FoxPro / MS-DOS.

  • Вы не можете использовать библиотеки API, соданные для разных платформ FoxPro. Например, вы не можете использовать библиотеки, созданные для FoxPro- 2.6 в системе Visual FoxPro. Вам нужно перекомпилировать эти библиотеки.

Система Visual FoxPro подразумевает расширение (.prg) для процедурных файлов.

При выполнении программного модуля, при помощи команды DO ProcedureName, система Visual FoxPro выполняет поиск указанного модуля  в следующем порядке:

  • поиск по имени файла ProcedureName.

  • поиск в процедурном файле, установленном командой SET PROCEDURE (если такая установлена).

  • поиск по всем выполняемым програмным модулям.

  • поиск в процедурном файле, указанном в команде SET LIBRARY (если такая установлена).

  • поиск в независимом программном файле .ехе; если указанный модуль не найден - то генерируется сообщение об ошибке. 

ADDITIVE

Внешняя библиотека открывается в дополнение к уже открытым библиотекам API. Данная опция ADDITIVE указывается после имени открываемой библиотеки API в команде SET LIBRARY.

При открытии процедурного файла система Visual FoxPro игнорирует опцию ADDITIVE.

Expand imageКомментарии

Команда SET LIBRARY используется  для открытия внешних библиотек Application Program Interface (API) или процедурных файлов.

Функции библиотек API расширяют как возможности языка программирования Visual FoxPro, так и пользовательского интерфейса. Как только открывается внешняя библиотека API, то все ее функции становятся доступными, как внутренние функции Visual FoxPro. Для просмотра доступных API функций используйте команды DISPLAY STATUS или LIST STATUS .

Вы можете использовать уже существующие библиотеки API, а также создавать новые библиотеки API.

Для использования внешних функций в Visual FoxPro, имеется более предпочтительный метод: объявление и использование DLL-функций при помощи команды DECLARE - DLL.

Для освобождения всех библиотек API из памяти, выполните команду SET LIBRARY TO без параметров FileName или ADDITIVE. Для освобождения конкретной библиотеки, используйте команду RELEASE LIBRARY LibraryName.

Если вы открываете процедурный файл, то все его функции и процедуры становятся доступными как из программных модулей, так и из Колмандного окна.

NoteПримечание

Функциональность Visual FoxPro: открывать процедурные файлы при помощи данной команды SET LIBRARY введена для совместимости с программными модулями dBASE IV. Если данная команда SET LIBRARY используется для открытия процедурного файла, то тогда закрываются все библиотеки API (см. ссылку выше, по-тексту), открытые ранее. Для предотвращения данной ситуации: используйте команду SET PROCEDURE для открытия процедурных файлов, в этом случае не закрываются открытые библиотеки API.

Дополнительную информацию об использовании процедурных файлов см. в разделах  PROCEDURE и SET PROCEDURE.

Expand imageСм. также