Команда SET LIBRARY

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

Синтаксис

SET LIBRARY TO [FileName [ADDITIVE]]

Параметры

FileName

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

В FoxPro для MS-DOS в качестве расширения имени файла библиотеки принимается .PLB. Если имя файла библиотеки имеет расширение .PLB, то его не нужно указывать вместе с именем файла. Если расширение имени файла библитеки отлично от .PLB, его следует указать вместе с именем файла.

В Visual FoxPro и FoxPro для Windows в качестве расширения имени файла биб иотеки принимается .FLL. Если имя файла библиотеки имеет расширение .FLL, то его е нужно указывать вместе с именем файла. Если расширение имени файла библитеки отлично от .FLL, его следует указать вместе с именем файла.

В FoxPro для Macintosh в качестве расширения имени файла библиотеки при имается .MLB. Если имя файла библиотеки имеет расширение .MLB, то его не нужно указ вать вместе с именем файла. Если расширение имени файла библитеки отлично от .MLB, его следует указать вместе с именем файла.

Важное замечание

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

Библиотеками API, построенными для одной версии, нельзя пользоваться в другой версии. Например, библиотеки, созданные для FoxPro для Windows версии 2.6, не ьзя использовать в Visual FoxPro. Нужно повторно выполнить компилирование и ре актирование связей средствами системы Professional Edition of Visual FoxPro.

В Visual FoxPro в качестве расширения имени файла процедур принимается .PRG.

Когда вы выполняете процедуру с помощью команды DO ProcedureName, Visual FoxPro ищет эту процедуру по следующей схеме:

1. В файле, содержащем команду DO ProcedureName.

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

3. В цепочке выполняемых программ. Visual FoxPro просматривает файлы программ, ачиная с самой последней выполнявшейся программы и вплоть до первой выпол явшейся программы.

4. В файле процедур, открытом по команде SET LIBRARY (если она выдавалась).

5. Среди автономных файлов программ. Если Visual FoxPro найдет файл программы с таким же именем, заданным в команде DO, эта программа выполняется. Если файла п ограммы с таким именем найти не удастся, Visual FoxPro генерирует сообщение об ошибке.

ADDITIVE

Открывает дополнительные библиотеки API. Ключевое слово ADDITIVE следует указ вать после имени файла в цепочке команд SET LIBRARY.

Visual FoxPro игнорирует предложение ADDITIVE, если команда SET LIBRARY испо ьзуется для открытия файла процедур.

Комментарии

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

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

Вы можете пользоваться существующими библиотеками API или создавать собственн е с помощью профессионального выпуска Visual FoxPro.

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

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

Замечание Возможность открывать в Visual FoxPro файл процедур по команде SET LIBRARY о еспечивает совместимость с dBASE IV. При выдаче команды SET LIBRARY для файла процедур закрываются все открытые библиотеки API. При выдаче команды SET LIBRARY для библиотеки API закрывается файл процедур, открытый по команде SET LIBRARY. Чтобы открыть файл процедур, не закрывая при этом библиотек API, воспо ьзуйтесь командой SET PROCEDURE.

Подробнее о файлах процедур см. разделы PROCEDURE и SET PROCEDURE.