OpenFileDialog - Revision history

Admin: 1 revision imported

2021-11-20T17:08:39Z

1 revision imported

1>Admin at 07:03, 20 November 2021

2021-11-20T07:03:39Z

Admin: 1 revision imported

2021-02-07T06:52:16Z

1 revision imported

Admin: Created page with "{{infobox function |name=OpenFileDialog |object=Функции общего назначения |caption=Визуальные функции |type=1 |status=2 |db=0 |exce..."

2019-06-07T11:17:21Z

Created page with "{{infobox function |name=OpenFileDialog |object=Функции общего назначения |caption=Визуальные функции |type=1 |status=2 |db=0 |exce..."

New page

{{infobox function
|name=OpenFileDialog
|object=[[Функции общего назначения]]
|caption=Визуальные функции
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число
|visual=1}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция выводит стандартный системный диалог открытия файла с заголовком и установками, определяемыми аргументами. Результат выбора возвращается в переменной, задающей первый аргумент. Файл будет выбран на локальном компьютере или в сети локального компьютера. Функция может использоваться только в визуальном клиенте. Функция может использоваться для выбора нескольких файлов, в этом случае, в переменной будет возвращена не строка, а список, содержащий имена файлов. Возвращаемое имя файла (или имена), содержит также путь с папками (является полным именем файла).

== Синтаксис ==
<code>
'''OpenFileDialog'''({{ByRef|<Имя файла (STRING,LIST)>}}{{Optional|,<Заголовок диалога (STRING)>,<Доступные фильтры файлов (STRING)>,<Тип диалога (INT)>{{Default|{{Eq}}0}},<Расширение по умолчанию (STRING)>}}):''<Пользователь выбрал файл (INT)>''
</code>
==== Аргументы ====
* <code>''<Имя файла (STRING)''</code> - {{ByRef}} Переменная, в которой возвращается путь и имя выбранного пользователем файла.
* <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>''<Тип диалога (INT)>''</code> - {{Optional}} Тип диалога, может принимать следующие значения:
** 0 -- Выбрать один файл (по умолчанию)
** 1 -- Выбрать один файл картинки (диалог приобретает несколько другой вид)
** 2 -- Выбрать множество файлов, в случае использования такого режима, в переменного первого аргумента будет возвращен список, состоящий из имен файлов.
** 3 -- Выбрать множество файлов картинок, в случае использования такого режима, в переменного первого аргумента будет возвращен список, состоящий из имен файлов.
* <code>''<Расширение по умолчанию (STRING)>''</code> - {{Optional}} задает расширение выбираемого файла по умолчанию.

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

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

← Older revision	Revision as of 17:08, 20 November 2021
(No difference)

@@ Line 20: / Line 20: @@
 </code>
 ==== Аргументы ====
-* <code>''<Имя файла (STRING)''</code> - {{ByRef}} Переменная, в которой возвращается путь и имя выбранного пользователем файла.
+* <code>''<Имя файла (STRING)''</code> - {{ByRef}} Переменная, в которой возвращается путь и имя выбранного пользователем файла; или список, элементами которого служат имена и пути файлов, если диалог открыт в режиме множественного выбора.
 * <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 (*.*)|*.*".
@@ Line 26: / Line 26: @@
 ** 0 -- Выбрать один файл (по умолчанию)
 ** 1 -- Выбрать один файл картинки (диалог приобретает несколько другой вид)
-** 2 -- Выбрать множество файлов, в случае использования такого режима, в переменного первого аргумента будет возвращен список, состоящий из имен файлов.
+** 2 -- Выбрать множество файлов, в случае использования такого режима, в переменной первого аргумента будет возвращен список, состоящий из имен файлов.
-** 3 -- Выбрать множество файлов картинок, в случае использования такого режима, в переменного первого аргумента будет возвращен список, состоящий из имен файлов.
+** 3 -- Выбрать множество файлов картинок, в случае использования такого режима, в переменной первого аргумента будет возвращен список, состоящий из имен файлов.
 * <code>''<Расширение по умолчанию (STRING)>''</code> - {{Optional}} задает расширение выбираемого файла по умолчанию.

← Older revision	Revision as of 06:52, 7 February 2021
(No difference)