SaveFileDialogServer

From SunFlurry wiki
Jump to: navigation, search
  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;