Функция LOCFILE( )

Ищет файл на диске и возвращает имя файла вместе с его путем.

Синтаксис

LOCFILE(cFileName [, cFileExtensions] [, cDialogCaption] [, cCreatorType])

Параметры

cFileName

Задает имя файла, который нужно найти. Если cFileName содержит только имя файла, функция LOCFILE( ) сначала будет искать в каталоге Visual FoxPro, используемом по умолчанию. Если там файла не окажется, начнется просмотр пути Visual FoxPro. Для задания пути Visual FoxPro пользуйтесь коман ой SET PATH.

Если cFileName вместе с именем файла содержит путь, будет просматриваться заданная область. Если там файл не будет найден, LOCFILE( ) перейдет к поиску в каталоге Visual FoxPro, используемом по умолчанию, а затем к поиску по пути Visual FoxPro.

Если файл найден, LOCFILE( ) возвращает его имя и путь.

cFileExtensions

Задает расширения имени для искомого файла. Если имя файла, заданное аргуме том cFileName, не включает расширение, Visual FoxPro дополняет его расширениями из списка cFileExtensions и продолжает поиск файла.

Аргумент cFileExtensions также задает расширения имен файлов, которые будут отображаться в диалоговом окне Open в случае, когда заданный файл не удается найти. Список расширений име файлов Visual FoxPro и соответствующих типов создающих их приложений см. в азделе Расширения имен файлов и типы файлов.

cFileExtensions можно задавать в разных видах:

Если cFileExtensions содержит одно расширение (например .PRG), отображаются только файлы с данным асширением имени.

cFileExtensions может содержать список расширений имен файлов, разделенных точкой с запятой. Например, если задать PRG;FXP, будут отображены все файлы с расширениями имен .PRG и .FXP.

Если у файлов одинаковые имена, но разные расширения (например CUSTOMER.PRG и CUSTOMER.FXP), будет отображен только тот из этих файлов, расширение имени кото ого стоит первым в списке cFileExtensions.

cFileExtensions может содержать список расширений имен файлов, разделенных вертикальными ли иями (например, PRG|FXP). В этом случае отображаются все файлы с любым из данных расширений, даже если у них одинаковые имена.

Если в качестве cFileExtensions задана просто точка с запятой (;), отображаютс все файлы, не имеющие расшире ия имени.

Если cFileExtensions пустая строка, а аргумент cCreatorType опущен, отображаются все файлы текущего каталога.

cFileExtensions может также включать символы подстановки (* и ?). Будут отображены все файлы, расширения имен которых удовлетворяют данному критерию с учетом символов по становки. Например, если в качестве cFileExtensions задать ?X?, отображаются все файлы с расширениями имен .FXP, .EXE и .TXT.

cDialogCaption

Задает текст, который вы намерены использовать в качестве приглашения для по ьзователя. Этот текст фигурирует в диалоговом окне Open.

cCreatorType

Допустимо только в FoxPro для Macintosh.

Отображает файлы, созданные приложением определенного типа. Если в качестве cFileExtensions задана пустая строка, отображаются только файлы, созданные приложениями типа cCreatorType. Если в список cFileExtensions включен шаблон имен, отображаются файлы, имена которых удовлетворяют этому шаб ону при условии, что создавшие их приложения принадлежат типу cCreatorType.

Список расширений имен файлов Visual FoxPro и соответствующих типов создающих их приложений см. в разделе Расширения имен файлов и типы файлов.

Результат

Символьный

Комментарии

Диалоговое окно Open отображается в том случае, когда файл не удалось найти в каталоге, используемом по умолчанию, в каталогах пути Visual FoxPro или в точно указанном месте. Диалоговое окно Open можно использовать для поиска файла. Ког а в диалоговом окне Open выбирается файл, его имя возвращается вместе с путем к нему.

Если выйти из диалогового окна Open, нажав кнопку Cancel или клавишу Esc, или кнопку Close меню Control, Visual FoxPro сгенерирует сообщение об оши ке, а LOCFILE( ) не возвратит никакого значения.