Difference between revisions of "OpenFileDialog"
(Created page with "{{infobox function |name=OpenFileDialog |object=Функции общего назначения |caption=Визуальные функции |type=1 |status=2 |db=0 |exce...") |
m (1 revision imported) |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 20: | Line 20: | ||
</code> | </code> | ||
==== Аргументы ==== | ==== Аргументы ==== | ||
| − | * <code>''<Имя файла (STRING)''</code> - {{ByRef}} Переменная, в которой возвращается путь и имя выбранного пользователем файла. | + | * <code>''<Имя файла (STRING)''</code> - {{ByRef}} Переменная, в которой возвращается путь и имя выбранного пользователем файла; или список, элементами которого служат имена и пути файлов, если диалог открыт в режиме множественного выбора. |
* <code>''<Заголовок диалога (STRING)>''</code> - {{Optional}} Аргумент задает заголовок диалога выбора файла | * <code>''<Заголовок диалога (STRING)>''</code> - {{Optional}} Аргумент задает заголовок диалога выбора файла | ||
* <code>''<Доступные фильтры файлов (STRING)>''</code> - {{Optional}} Аргумент задает список доступный пользователю файловых фильтров. Фильтры задаются через знак '''|''', строка фильтров имеет формат: <code><Наименование фильтра 1>|<Файловый фильтр 1>[|<Наименование фильтра 2>|<Файловый фильтр 2>...]</code>. Файловый фильтр при этом является именем файла с возможным использованием знаков '''*''' и '''?'''. Пример полной строки фильтров: "Sunflurry table (*.sft)|*.sft|Microsoft Excel book (*.xls)|*.xls|All files (*.*)|*.*". | * <code>''<Доступные фильтры файлов (STRING)>''</code> - {{Optional}} Аргумент задает список доступный пользователю файловых фильтров. Фильтры задаются через знак '''|''', строка фильтров имеет формат: <code><Наименование фильтра 1>|<Файловый фильтр 1>[|<Наименование фильтра 2>|<Файловый фильтр 2>...]</code>. Файловый фильтр при этом является именем файла с возможным использованием знаков '''*''' и '''?'''. Пример полной строки фильтров: "Sunflurry table (*.sft)|*.sft|Microsoft Excel book (*.xls)|*.xls|All files (*.*)|*.*". | ||
| Line 26: | Line 26: | ||
** 0 -- Выбрать один файл (по умолчанию) | ** 0 -- Выбрать один файл (по умолчанию) | ||
** 1 -- Выбрать один файл картинки (диалог приобретает несколько другой вид) | ** 1 -- Выбрать один файл картинки (диалог приобретает несколько другой вид) | ||
| − | ** 2 -- Выбрать множество файлов, в случае использования такого режима, в | + | ** 2 -- Выбрать множество файлов, в случае использования такого режима, в переменной первого аргумента будет возвращен список, состоящий из имен файлов. |
| − | ** 3 -- Выбрать множество файлов картинок, в случае использования такого режима, в | + | ** 3 -- Выбрать множество файлов картинок, в случае использования такого режима, в переменной первого аргумента будет возвращен список, состоящий из имен файлов. |
* <code>''<Расширение по умолчанию (STRING)>''</code> - {{Optional}} задает расширение выбираемого файла по умолчанию. | * <code>''<Расширение по умолчанию (STRING)>''</code> - {{Optional}} задает расширение выбираемого файла по умолчанию. | ||
Latest revision as of 18:08, 20 November 2021
| 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("Происходит загрузка файла "+Файл+"...");
