SaveFileDialogServer

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

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

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

Синтаксис

SaveFileDialogServer(<Имя файла (STRING)>,<Заголовок диалога (STRING)>,<Доступные фильтры файлов (STRING)>,<Тип диалога (INT)>=0,<Расширение по умолчанию (STRING)>,<Ограничить доступ этим каталогом (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)> - (необязательный аргумент) задает расширение выбираемого файла по умолчанию.
• <Ограничить доступ этим каталогом (STRING)> - (необязательный аргумент) задает каталог проекта на сервере, выход из которого (т.е. в верхние каталоги) для пользователя, выбирающего файл, будет запрещен.

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

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

Примеры

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