Открывает окно диалога выбора/сохранения файла.
Синтаксис:
ВыбратьФайл(<ТипДиалога>, <ИмяФайла>, <ИмяНачКаталога>, <3аголовокОкна>, <Фильтр>,
<Расширение>, <Таймаут>)
Англоязычный синоним:
SelectFile
Параметры:
<TипДиaлoгa> |
Числовое выражение, значение которого определяет тип открываемого диалога. Допустимые значения: 0 — диалог типа «открыть», 1 — диалог типа «сохранить». |
<ИмяФайла> |
Имя переменной, содержащей строковое значение с именем файла. В эту же переменную система возвращает имя выбранного файла. |
<ИмяНачКаталога> |
Имя переменной, содержащей строковое значение с именем начального каталога. В эту же переменную система возвращает имя выбранного каталога. |
<ЗаголовокОкна> |
Строковое выражение, с помощью которого можно задать заголовок открываемого окна. |
<Фильтр> |
Строковое выражение, с помощью которого можно задать список фильтров отбора файлов. Фильтр состоит из двух частей, разделенных сиволом "" (вертикальная черта): строки представления, которая отображается в окне выбора файла, и непосредственно строки маски. В строке маски можно использовать символ "*", что означает наличие любого числа произвольных символов. Символ "?" в строке маски означает наличие одного произвольного символа. Одновременно можно задавать несколько фильтров в виде списка, в качестве разделителей используется символ "|" (вертикальная черта). Например, список из двух фильтров: "Текст(*.txt)|*.txt| Таблицы(*.mxl)|*.mxl" |
<Расширение> |
Строковое выражение, с помощью которого можно задать расширение файла по умолчанию, которое используется системой при записи файла. |
<Таймаут> |
Необязательный параметр. Числовое выражение, значение которого задает время ожидания системы (в секундах) на отклик пользователя. |
Возвращаемое значение:
Число: 0 — если в окне диалога нажата кнопка «Отмена»; 1 — если в окне диалога нажата кнопка «ОК», при этом в переменную <ИмяФайла> возвращается выбранное имя файла, а в переменную <ИмяНачКаталога> возвращается имя выбранного каталога; -1 (минус единица) — закончилось время <Таймаут> ожидания отклика пользователя.
Описание:
Метод ВыбратьФайл открывает окно диалога выбора/сохранения файла.
Пример:
* В данном примере приведена процедура вызова диалога выбора файла.
Процедура УдалФ()
ИмяВыбрФайла = "";
ИмяПути="";
Если ФС.ВыбратьФайл(0, ИмяВыбрФайла, ИмяПути, "Выберите файл",
"Все файлы (*.*)!*.*", , ) = 1 Тогда
ФС.УдалитьФайл(ИмяПути + ИмяФайла);
КонецЕсли;
КонецПроцедуры