0

ФС (Файловая система)
Метод ВыбратьФайл()

Открывает окно диалога выбора файла

Синтаксис

Метод ВыбратьФайл() имеет следующий синтаксис:

число ВыбратьФайл([ТипДиалога=0], [ИмяФайла=""], [ИмяКаталога=""], [Заголовок=""], [Фильтр=""], [Расширение=""], [Таймаут=0])

А также альтернативный англоязычный синтаксис:

number SelectFile([Type=0], [Filename=""], [CatalogName=""], [Title=""], [Filter=""], [Extention=""], [Timeout=0])

Параметры

Описание параметров метода ВыбратьФайл():

Имя параметра Тип Описание
ТипДиалога Число Тип диалога: 0 — диалог типа <открыть>, 1 — диалог типа <сохранить>.

Значение по умолчанию = 0

ИмяФайла Строка На входе содержит начальное имя файла, а на выходе — выбранное пользователем имя файла
ИмяКаталога Строка На входе содержит начальное имя каталога, а на выходе — выбранный пользователем каталог. Если параметр не указан, открывается последний использовавшийся пользователем каталог
Заголовок Строка Заголовок окна диалога. Если не указан, отображается стандартный заголовок «Выбор файла»
Фильтр Строка Содержит фильтры отбора файлов (например Все файлы (*.*)|*.* или Файлы Excell (*.xls)|*.xls, где до вертикальной черты указывается представление фильтра, а после нее — шаблон имени файла. При указании шаблона допускается использование символов: * — любая последовательность символов и ? — один любой символ). Несколько шаблонов разделяются символом вертикальной черты (например: Файлы Excell(*.xls)|*.xls |Файлы Excell(*.xlsх)|*.xlsх)
Расширение Строка Расширение сохраняемого файла по умолчанию
Таймаут Число Время ожидания отклика пользователя в секундах. Если 0, то время открытия диалога не ограничено
Жирным шрифтом выделены обязательные параметры

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

Число

1 — если нажата кнопка ‘ОК’
0 — если в окне диалога нажата кнопка ‘Отмена’
-1 — если наступил таймаут (закончилось время ожидания отклика пользователя)

Описание

Метод ВыбратьФайл() открывает окно выбора файла для его открытия или сохранения. Полное имя файла м.б. получено путем сложения содержимого параметров ИмяКаталога и ИмяФайла, например так:

ПолноеИмя = ИмяКаталога + ИмяФайла;

Пример использования

Пример кода с использованием метода ВыбратьФайл():

ИмяКаталога = "";
РезВыбора = ФС.ВыбратьФайл(1, ИмяФайла, ИмяКаталога, "Укажите файл для сохранения", "Файлы xls (*.xls)|*.xls", "xls", 30);
Если РезВыбора = 1 Тогда
	ПолноеИмя = ИмяКаталога + ИмяФайла;
	Таб.Записать(ПолноеИмя, "xls");
КонецЕсли;

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *