Функция PUTFILE( )

Откывает диалоговое окно Save As и возвращает задаваемое имя файла.

Синтаксис

PUTFILE([cDialogCaption] [, cFileName] [, cFileExtensions])

Результат

Символьный

Параметры

cDialogCaption

Задает надпись вверху диалогового окна Save As. Следует заметить, что длинные заголовки могут быть обрезаны при работе с Windows 95.

cFileName

Задает имя файла, предлагаемое по умолчанию в текстовом поле.

cFileExtensions

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

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

Символьное выражение cFileExtensions может иметь один из следующих форматов:

cFileExtensions может содержать только одно расширение имени, такое как .PRG, и задавать отоб ажение имен файлов только с этим расширением.

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

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

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

Если аргумент cFileExtensions состоит только из точки с запятой (;), Visual FoxPro отобразит все имена фай ов, не имеющие расширений.

Если cFileExtensions представляет собой пустую строку, Visual FoxPro отобразит имена всех файлов в текущем каталоге.

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

Комментарии

С помощью функции PUTFILE( ) можно выбрать имя существующего файла или задать овое имя файла. PUTFILE( ) возвращает имя файла вместе с путем к нему. Если имя файла не введено, PUTFILE( ) возвращает предлагаемое по умолчанию имя файла (заданное аргументом cFileName) и расширение (заданное аргументом cFileExtensions). Если нажать кнопку Cancel или клавишу Esc, функция PUTFILE( ) возвратит пустую строку. Вы можете присвоить имя, возв ащенное функцией PUTFILE( ), своему файлу и сохранить его на диске.