Описание встроенного языка системы 1С Предприятие


         

ВыбратьФайл


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

Синтаксис:

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

            <Расширение>, <Таймаут>)

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

SelectFile

Параметры:

<TипДиaлoгa>

Числовое выражение, значение которого определяет тип открываемого диалога. Допустимые значения: 0 — диалог типа «открыть», 1 — диалог типа «сохранить».



<ИмяФайла>

Имя переменной, содержащей строковое значение с именем файла. В эту же переменную система воз­вращает имя выбранного файла.

<ИмяНачКаталога>

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

<ЗаголовокОкна>

Строковое выражение, с помощью которого можно задать заголовок открываемого окна.

<Фильтр>

Строковое выражение, с помощью которого можно задать список фильтров отбора файлов. Фильтр состоит из двух частей, разделенных сиволом "" (вертикальная черта): строки представления, кото­рая отображается в окне выбора файла, и непо­средственно строки маски. В строке маски можно использовать символ "*", что означает наличие лю­бого числа произвольных символов. Символ "?" в строке маски означает наличие одного произволь­ного символа. Одновременно можно задавать не­сколько фильтров в виде списка, в качестве разде­лителей используется символ "|" (вертикальная чер­та). Например, список из двух фильтров:

"Текст(*.txt)|*.txt| Таблицы(*.mxl)|*.mxl"

<Расширение>

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

<Таймаут>

Необязательный параметр. Числовое выражение, значение которого задает время ожидания системы (в секундах) на отклик пользователя.

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

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

Описание:

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

Пример:

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

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

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

   ИмяПути="";

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

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

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

   КонецЕсли;

КонецПроцедуры



Содержание раздела