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

LOCFILE(cFileName [, cFileExtensions] [, cFileNameCaption])

Параметры

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", если заданный файл не удалось найти.

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

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

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

  • cFileExtensions может содержать описание типа файла со следующим за ним расширением или списком соответствующих расширений, разделенных запятой. Описание файла будет выведено в текстбоксе "Тип файлов" диалогового окна "Open" в случае, если искомый файл не будет найден. Описание файла должно быть отделено от расширения или списка расширений двоеточием (:). Различные описания файлов с их расширениями отделяются друг от друга точкой с запятой (;).

    Например, если cFileExtensions содержит "Text:TXT", описание файла "Text" будет выведено в текстбоксе "Тип файлов" диалогового окна "Open" и будут показаны все файлы с расширением .txt.

    Если cFileExtensions определен как "Tables:DBF; Files:TXT,BAK" описание файла "Tables" будет выведено в текстбоксе "Тип файлов" диалогового окна "Open" и оба эти описания "Tables" и "Files" помещаются в выпадающем списке "Тип файлов". В дальнейшем, в зависимости от выбора "Tables" или "Files" из выпадающего списка "Тип файлов", будут отображаться либо файлы с расширением .dbf, либо .txt и .bak соответственно.

cFileNameCaption

Задает текст, который используется в качестве приглашения пользователю для ввода имени файла слева от текстбокса в диалоговом окне "Open". Если этот параметр опущен, будет выведено "Имя файла:".

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

Возвращаемое значение

Character

Замечания

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

Если выйти из диалогового окна "Open", нажав кнопку Cancel или клавишу Esc, или кнопку Close в правом верхнем углу окна, или выбрав пункт "Закрыть Alt+F4" из меню управления окном, Visual FoxPro сгенерирует сообщение об ошибке, а функция LOCFILE( ) не возвратит никакого значения.

Смотрите также