OpenFileDialog

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

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

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

Синтаксис

OpenFileDialog(<Имя файла (STRING,LIST)>,<Заголовок диалога (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 -- Выбрать один файл картинки (диалог приобретает несколько другой вид)
  • 2 -- Выбрать множество файлов, в случае использования такого режима, в переменной первого аргумента будет возвращен список, состоящий из имен файлов.
  • 3 -- Выбрать множество файлов картинок, в случае использования такого режима, в переменной первого аргумента будет возвращен список, состоящий из имен файлов.
• <Расширение по умолчанию (STRING)> - (необязательный аргумент) задает расширение выбираемого файла по умолчанию.

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

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

Примеры

//Функция выбирает текстовый файл
Файл:="";
If not OpenFileDialog(Файл,"Выберите файл загрузки","Текстовые файлы (*.txt)|*.txt",0) Then
  Exit;
EndIf;
Message("Происходит загрузка файла "+Файл+"...");