OpenFileDialogServer

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

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

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

Синтаксис

OpenFileDialogServer(<Имя файла (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.

Примеры

//Функция выбирает файл скомпилированного модуля внутри каталога "Modules\FreeForms\"
Путь:="Modules\FreeForms\ПечатныеФормы\";
If not OpenFileDialogServer(Путь,"Выберите доп. печатную форму:","Файлы отчетов (*.sfc)|*.sfc",0,"*.sfc","Modules\FreeForms\") Then
  Exit;
EndIf;
Путь:=AddBackSlash(GetPath(Путь));
Message("Выбрана папка с печатной формой "+Путь+"...");