Иллюстрированный самоучитель по языку системы 1С:Предприятие

Работа с Файлами

Методы объекта "ФС"

ВыбратьФайл

Открывает окно диалога выбора/сохранения файла.

Синтаксис:

ВыбратьФайл(<ТипДиалога>, <ИмяФайла>, <ИмяНачКаталога>, <3аголовокОкна>, <Фильтр>,
<Расширение>, <Таймаут>)

Англоязычный синоним:

SelectFile

Параметры:

<TипДиaлoгa> Числовое выражение, значение которого определяет тип открываемого диалога. Допустимые значения: 0 – диалог типа "открыть", 1 – диалог типа "сохранить".
<ИмяФайла> Имя переменной, содержащей строковое значение с именем файла. В эту же переменную система возвращает имя выбранного файла.
<ИмяНачКаталога> Имя переменной, содержащей строковое значение с именем начального каталога. В эту же переменную система возвращает имя выбранного каталога.
<ЗаголовокОкна> Строковое выражение, с помощью которого можно задать заголовок открываемого окна.
<Фильтр> Строковое выражение, с помощью которого можно задать список фильтров отбора файлов. Фильтр состоит из двух частей, разделенных сиволом "" (вертикальная черта): строки представления, которая отображается в окне выбора файла, и непосредственно строки маски. В строке маски можно использовать символ "*", что означает наличие любого числа произвольных символов. Символ "?" в строке маски означает наличие одного произвольного символа. Одновременно можно задавать несколько фильтров в виде списка, в качестве разделителей используется символ "|" (вертикальная черта). Например, список из двух фильтров:
"Текст(*.txt)|*.txt| Таблицы(*.mxl)|*.mxl"
<Расширение> Строковое выражение, с помощью которого можно задать расширение файла по умолчанию, которое используется системой при записи файла.
<Таймаут> Необязательный параметр. Числовое выражение, значение которого задает время ожидания системы (в секундах) на отклик пользователя.

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

Число: 0 – если в окне диалога нажата кнопка "Отмена"; 1 – если в окне диалога нажата кнопка "ОК", при этом в переменную <ИмяФайла> возвращается выбранное имя файла, а в переменную <ИмяНачКаталога> возвращается имя выбранного каталога; -1 (минус единица) – закончилось время <Таймаут> ожидания отклика пользователя.

Описание:

Метод ВыбратьФайл открывает окно диалога выбора/сохранения файла.

Пример:

В данном примере приведена процедура вызова диалога выбора файла.

Процедура УдалФ()

ИмяВыбрФайла = "";

ИмяПути="";

Если ФС.ВыбратьФайл(0, ИмяВыбрФайла, ИмяПути, "Выберите файл",

"Все файлы (*.*)!*.*", , ) = 1 Тогда

ФС.УдалитьФайл(ИмяПути + ИмяФайла);

КонецЕсли;

КонецПроцедуры
Если Вы заметили ошибку, выделите, пожалуйста, необходимый текст и нажмите CTRL + Enter, чтобы сообщить об этом редактору.