Открывает окно диалога выбора файла
Синтаксис
Метод ВыбратьФайл() имеет следующий синтаксис:
число ВыбратьФайл([ТипДиалога=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"); КонецЕсли;