SaveFileDialog

SaveFileDialog (Визуальные функции)
Объект: Функции общего назначения Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Исключения: Невозможно превратить в строку, число Визуальность: Да

• Начальная страница
• Общее описание
• Объекты
• Функции общего назначения

Функция выводит стандартный системный диалог сохранения файла с заголовком и установками, определяемыми аргументами. Выбранное имя файла для сохранения возвращается в переменной, задающей первый аргумент. Файл будет выбран на локальном компьютере или в сети локального компьютера. Функция может использоваться только в визуальном клиенте. Возвращаемое имя файла, содержит также путь с папками (является полным именем файла).

Синтаксис

SaveFileDialog(<Имя файла (STRING)>,<Заголовок диалога (STRING)>,<Доступные фильтры файлов (STRING)>,<Тип диалога (INT)>=0,<Расширение по умолчанию (STRING)>):<Пользователь нажал на ОК (INT)>

Аргументы

• <Имя файла (STRING) - (возможен аргумент-переменная (ByRef)) Переменная, в которой возвращается путь и имя выбранного пользователем файла.
• <Заголовок диалога (STRING)> - (необязательный аргумент) Аргумент задает заголовок диалога выбора файла
• <Доступные фильтры файлов (STRING)> - (необязательный аргумент) Аргумент задает список доступный пользователю файловых фильтров. Фильтры задаются через знак |, строка фильтров имеет формат: <Наименование фильтра 1>|<Файловый фильтр 1>[|<Наименование фильтра 2>|<Файловый фильтр 2>...]. Файловый фильтр при этом является именем файла с возможным использованием знаков * и ?. Пример полной строки фильтров: "Sunflurry table (*.sft)|*.sft|Microsoft Excel book (*.xls)|*.xls|All files (*.*)|*.*".
• <Тип диалога (INT)> - (необязательный аргумент) Тип диалога, может принимать следующие значения:
  • 0 -- Выбрать один файл (по умолчанию)
  • 1 -- Выбрать один файл картинки (диалог приобретает несколько другой вид)
• <Расширение по умолчанию (STRING)> - (необязательный аргумент) задает расширение выбираемого файла по умолчанию.

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

Возвращает 1, если пользователь выбрал файл и нажал на "ОК", иначе возвращает 0.

Примеры

//Функция сохраняет список Сп в выбранный пользователем файл с расширением .bin
Имя:="";
If SaveFileDialog(Имя,"Выгрузка текущей настройки:","Файлы bin (*.bin)|*.bin",0) Then
  ObjectToFile(Сп,Имя);
  Box("Настройка успешно сохранена!",Q_INFORMATION);
EndIf;