LoadModule - Revision history

Admin: 1 revision imported

2025-06-09T11:13:25Z

1 revision imported

1>Admin: /* Синтаксис */

2025-03-10T19:17:18Z

‎Синтаксис

Admin: 1 revision imported

2023-11-27T06:42:35Z

1 revision imported

1>Admin at 10:11, 25 November 2023

2023-11-25T10:11:23Z

Admin: 1 revision imported

2021-11-20T17:07:29Z

1 revision imported

1>Admin: /* Аргументы */

2021-09-16T06:43:09Z

‎Аргументы

Admin: 1 revision imported

2021-06-28T07:02:27Z

1 revision imported

1>Admin at 09:31, 26 May 2021

2021-05-26T09:31:24Z

Admin: 1 revision imported

2021-02-07T06:51:46Z

1 revision imported

Admin at 15:48, 2 June 2019

2019-06-02T15:48:05Z

New page

{{infobox function
|name=LoadModule
|object=[[Функции общего назначения]]
|caption=Загрузка модулей
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку или число, неверный путь, отсутствует заданный модуль
|visual=1}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
<p>Функция позволяет загружать и инициировать выполнение произвольного модуля с произвольной формой. Модуль может быть загружен как модально к текущему потоку (если текущий поток не является корневым), так и создавать новый поток, передавая ему два аргумента. В случае модального исполнения, функция не возвратит результат до тех пор, пока модуль не закончит работы, при этом, модуль может возвратить результат и изменить переданные параметры, если они представляли собой переменные. Для клиентов, работающих с сервером базы данных, путь должен представлять собой [[Имена файлов|серверный файловый путь]] (пример: '''Modules\FreeForms\Касса\Обработка доверенностей''') или наименование объекта базы данных в виде <code><Тип объекта>.<Вид объекта></code> (пример '''Ref.Номенклатура'''), система преобразовывает его в соответствующий путь. Для клиентов работающих локально (без подключения к серверу базы данных), функция принимает абсолютный файловый путь.</p>
По каждому указанному пути может находиться неограниченное число модулей, форм, табличных файлов, ini-файлов или любых других бинарных файлов. При открытии объектов модули по умолчанию для каждого из случаев (открытие папки, открытие элемента, открытие в режиме таблицы и пр.) задаются в [[Студия/Конфигурация данных проекта|Студии]]. При вызове данной функции указывается модуль, который обязательно должен существовать и форма, которая может отсутствовать, если модуль не будет визуальным. Загрузка модуля проходит следующие этапы:
{{Load module stages}}

== Синтаксис ==
<code>
'''LoadModule'''(''<Способ вызова (INT)>'',''<Путь или имя базы данных (STRING)>''{{OptionalByRef|,<Параметр>,<Опция>}}{{Optional|,<Имя модуля (STRING)>{{Default|{{Eq}}"Module"}},<Имя формы (STRING)>{{Default|{{Eq}}"SelectForm"}}}}):''<Результат модального выполнения>''
</code>
==== Аргументы ====
* <code>''<Способ вызова (INT)>''</code> - Способ вызова открываемого модуля. Возможны следующие значения:
** 0 -- модуль будет загружен модально, если вызов не происходит из корневого модуля. Модальные модули не возвращают управления до тех пор, пока их выполнение не будет завершено. Для визуальных клиентов, модальная форма открывается в той же группе закладок, в которой была открыта вызывавшая форма, при этом создает запрет на активацию последней, до тех пор, пока модальная форма не будет закрыта. Табличные формы, которые могла создать любая из форм, при этом, будут доступны.
** 1 -- модуль создает новый поток (для визуального клиента форма модуля будет помещена в новую группу закладок) в случае, если модуль с таким же путем, именем и именем формы (или объект с таким же идентификатором, при этом, все новые объекты одного вида имеют одинаковые идентификаторы) уже не открыт. Если подобный модуль уже открыт, будет произведена его визуальная активация на экране и вызов визуального события ''OnReopen''.
** 2 -- модуль создает новый поток (для визуального клиента форма модуля будет помещена в новую группу закладок).
** 10 -- модуль будет загружен модально к основному окну системы. При показе такой формы, доступ к любым формам любых потоков будет заблокирован до того момента, как данная форма будет закрыта. Последующие вызовы функций загрузки модулей ([[LoadModule]], [[OpenObject]] и пр.) не разрешены. Данный способ загрузки используется для простых диалоговых окон (которые могут иметь минимальные возможности для редактирования данных) и совпадает по поведению с окнами, получаемыми функциями типа [[Box]].
* <code>''<Путь или имя базы данных (STRING)>''</code> - Строковое представление данного аргумента может представлять собой путь к объекту базы данных, относительный путь к папке проекта на сервере, абсолютный путь к папке проекта на локальном компьютере. См. описание этой функции для более полной информации.
* <code>''<Параметр>,<Опция>''</code> - {{ByRef}} {{Optional}} Аргументы передаются в вызываемый модуль без изменения, и могут использоваться по усмотрению разработчика. Аргументы будут доступы начиная с первого вызова модуля под именами '''Param''' и '''Option'''. При открытии/загрузке объектов базы данных первый аргумент (''Param'') рекомендуется использовать для указания на родителя (Parent) текущего элемента или списка элемента справочников. Система сама может пытаться использовать по умолчанию значение этого аргумента, как родителя справочника при загрузке объектов (это поведение, однако, может быть изменено). Если аргументы представлены переменными и модуль вызывается в модальном режиме, вызываемая программа может изменить значения этих переменных и, после того, как вызываемый модуль закончит работу, измененные значения будут переданы в исходных переменных.
* <code>''<Имя модуля (STRING)>''</code> - {{Optional}} Имя загружаемого модуля, если этот параметр не указан, будет использовано имя '''Module'''.
* <code>''<Имя формы (STRING)>''</code> - {{Optional}} Имя загружаемой формы, если этот параметр не указан, будет использовано имя '''SelectForm'''. Если форма не будет использоваться (загруженный модуль будет закрыт, так как функция ''OnOpen'' возвратит 0, либо произойдет исключение и пр.), т.е. загрузка будет прервана до начала загрузки визуальной части, этот параметр не имеет значения.

==== Возвращаемое значение ====
Функция возвращает значение переменной '''ModalResult''', которая доступна для изменения в вызываемом модуле. Переменная будет возвращена только в случае, если модуль вызывается в модальном режиме.

== Примеры ==
<pre>
//Открывается журнал документов "Общий журнал" с именами модуля и формы по умолчанию, ему передается параметр Param в виде документа, на который требуется произвести позиционирование
//Журнал открывается в новом потоке, если он уже не открыт (в последнем случае, для его формы будет вызвано визуальное событие OnReopen)
LoadModule(1,"Jor.ОбщийЖурнал",аДок);

//Вызывается новая копия обработки "редактирование партий в документе", обработке передаются требуемые параметры
Сп:=List.Create();
Сп.SetByName("Документ",аДок);
Сп.SetByName("ТипВывода",1);
LoadModule(2,"Modules\FreeForms\Склад\Редактирование партий в документе",Сп,0,"Module","Form");

//Обработка "выбор адреса доставки" предлагает выбрать элемент списка, который возвращается, как элемент списка с именем "Ответ"
Сп:=List.Create();
Сп.SetByName("Список",спАдресаДоставки);
Сп.SetByName("ТорговыйПредставитель",аТорговыйПредставитель);
Сп.SetByName("Договор",аДоговор);
//При вызове модулю передан параметр Param в виде списка с доп. параметрами
LoadModule(10,"Modules\FreeForms\Выбор адреса доставки",Сп,0,"Module","Form");
Зн:=Сп.GetByName("Ответ");
If IsEmpty(Зн) Then
Exit;
EndIf;
//Зн -- возвращенный выбранный элемент списка
</pre>

@@ Line 28: / Line 28: @@
 ** 10 -- модуль будет загружен модально к основному окну системы. При показе такой формы, доступ к любым формам любых потоков будет заблокирован до того момента, как данная форма будет закрыта. Последующие вызовы функций загрузки модулей ([[LoadModule]], [[OpenObject]] и пр.) в режимах, не совпадающих с 10 или 11, не разрешены. Данный способ загрузки используется для простых диалоговых окон (которые могут иметь минимальные возможности для редактирования данных) и совпадает по поведению с окнами, получаемыми функциями типа [[Box]].
 ** 11 -- совпадает с режимом 10, только модуль будет загружен модально к основному окну системы в режиме развернутого окна (''maximized'').
 * <code>''<Путь или имя базы данных (STRING)>''</code> - Строковое представление данного аргумента может представлять собой путь к объекту базы данных, относительный путь к папке проекта на сервере, абсолютный путь к папке проекта на локальном компьютере. См. описание этой функции для более полной информации. Также можно указывать путь к внешнему объекту и путь внутри него (см. [[Имена файлов]]), если внешний объект уже присутствует в системе, повторная его загрузка  не будет выполнена. Для программного доступа к файлам внешних объектов см. группу функций работы с [[Функции общего назначения#Внешний загружаемый объект|внешними объектами]].
 * <code>''<Параметр>,<Опция>''</code> - {{ByRef}} {{Optional}} Аргументы передаются в вызываемый модуль без изменения, и могут использоваться по усмотрению разработчика. Аргументы будут доступы начиная с первого вызова модуля под именами '''Param''' и '''Option'''. При открытии/загрузке объектов базы данных первый аргумент (''Param'') рекомендуется использовать для указания на родителя (Parent) текущего элемента или списка элемента справочников. Система сама может пытаться использовать по умолчанию значение этого аргумента, как родителя справочника при загрузке объектов (это поведение, однако, может быть изменено). Если аргументы представлены переменными и модуль вызывается в модальном режиме, вызываемая программа может изменить значения этих переменных и, после того, как вызываемый модуль закончит работу, измененные значения будут переданы в исходных переменных.

@@ Line 28: / Line 28: @@
 ** 10 -- модуль будет загружен модально к основному окну системы. При показе такой формы, доступ к любым формам любых потоков будет заблокирован до того момента, как данная форма будет закрыта. Последующие вызовы функций загрузки модулей ([[LoadModule]], [[OpenObject]] и пр.) в режимах, не совпадающих с 10 или 11, не разрешены. Данный способ загрузки используется для простых диалоговых окон (которые могут иметь минимальные возможности для редактирования данных) и совпадает по поведению с окнами, получаемыми функциями типа [[Box]].
 ** 11 -- совпадает с режимом 10, только модуль будет загружен модально к основному окну системы в режиме развернутого окна (''maximized'').
-* <code>''<Путь или имя базы данных (STRING)>''</code> - Строковое представление данного аргумента может представлять собой путь к объекту базы данных, относительный путь к папке проекта на сервере, абсолютный путь к папке проекта на локальном компьютере. См. описание этой функции для более полной информации.
+* <code>''<Путь или имя базы данных (STRING)>''</code> - Строковое представление данного аргумента может представлять собой путь к объекту базы данных, относительный путь к папке проекта на сервере, абсолютный путь к папке проекта на локальном компьютере. См. описание этой функции для более полной информации. Также можно указывать путь к внешнему объекту и путь внутри него (см. [[Имена файлов]]), если внешний объект уже присутствует в системе, повторная его загрузка  не будет выполнена. Для программного доступа к файлам внешних объектов см. группу функций работы с [[Функции общего назначения#Внешний загружаемый объект|внешними объектами]].
 * <code>''<Параметр>,<Опция>''</code> - {{ByRef}} {{Optional}} Аргументы передаются в вызываемый модуль без изменения, и могут использоваться по усмотрению разработчика. Аргументы будут доступы начиная с первого вызова модуля под именами '''Param''' и '''Option'''. При открытии/загрузке объектов базы данных первый аргумент (''Param'') рекомендуется использовать для указания на родителя (Parent) текущего элемента или списка элемента справочников. Система сама может пытаться использовать по умолчанию значение этого аргумента, как родителя справочника при загрузке объектов (это поведение, однако, может быть изменено). Если аргументы представлены переменными и модуль вызывается в модальном режиме, вызываемая программа может изменить значения этих переменных и, после того, как вызываемый модуль закончит работу, измененные значения будут переданы в исходных переменных.
 * <code>''<Имя модуля (STRING)>''</code> - {{Optional}} Имя загружаемого модуля, если этот параметр не указан, будет использовано имя '''Module'''.

← Older revision	Revision as of 11:13, 9 June 2025
(No difference)

← Older revision	Revision as of 06:42, 27 November 2023
(No difference)

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

@@ Line 26: / Line 26: @@
 ** 1 -- модуль создает новый поток (для визуального клиента форма модуля будет помещена в новую группу закладок) в случае, если модуль с таким же путем, именем и именем формы (или объект с таким же идентификатором, при этом, все новые объекты одного вида имеют одинаковые идентификаторы) уже не открыт. Если подобный модуль уже открыт, будет произведена его визуальная активация на экране и вызов визуального события ''OnReopen''.
 ** 2 -- модуль создает новый поток (для визуального клиента форма модуля будет помещена в новую группу закладок).
-** 10 -- модуль будет загружен модально к основному окну системы. При показе такой формы, доступ к любым формам любых потоков будет заблокирован до того момента, как данная форма будет закрыта. Последующие вызовы функций загрузки модулей ([[LoadModule]], [[OpenObject]] и пр.) не разрешены. Данный способ загрузки используется для простых диалоговых окон (которые могут иметь минимальные возможности для редактирования данных) и совпадает по поведению с окнами, получаемыми функциями типа [[Box]].
+** 10 -- модуль будет загружен модально к основному окну системы. При показе такой формы, доступ к любым формам любых потоков будет заблокирован до того момента, как данная форма будет закрыта. Последующие вызовы функций загрузки модулей ([[LoadModule]], [[OpenObject]] и пр.) в режимах, не совпадающих с 10 или 11, не разрешены. Данный способ загрузки используется для простых диалоговых окон (которые могут иметь минимальные возможности для редактирования данных) и совпадает по поведению с окнами, получаемыми функциями типа [[Box]].
 * <code>''<Путь или имя базы данных (STRING)>''</code> - Строковое представление данного аргумента может представлять собой путь к объекту базы данных, относительный путь к папке проекта на сервере, абсолютный путь к папке проекта на локальном компьютере. См. описание этой функции для более полной информации.
 * <code>''<Параметр>,<Опция>''</code> - {{ByRef}} {{Optional}} Аргументы передаются в вызываемый модуль без изменения, и могут использоваться по усмотрению разработчика. Аргументы будут доступы начиная с первого вызова модуля под именами '''Param''' и '''Option'''. При открытии/загрузке объектов базы данных первый аргумент (''Param'') рекомендуется использовать для указания на родителя (Parent) текущего элемента или списка элемента справочников. Система сама может пытаться использовать по умолчанию значение этого аргумента, как родителя справочника при загрузке объектов (это поведение, однако, может быть изменено). Если аргументы представлены переменными и модуль вызывается в модальном режиме, вызываемая программа может изменить значения этих переменных и, после того, как вызываемый модуль закончит работу, измененные значения будут переданы в исходных переменных.

← Older revision	Revision as of 07:02, 28 June 2021
(No difference)

@@ Line 19: / Line 19: @@
 == Синтаксис ==
 <code>
-'''LoadModule'''(''<Способ вызова (INT)>'',''<Путь или имя базы данных (STRING)>''{{OptionalByRef|,<Параметр>,<Опция>}}{{Optional|,<Имя модуля (STRING)>{{Default|{{Eq}}"Module"}},<Имя формы (STRING)>{{Default|{{Eq}}"SelectForm"}}}}):''<Результат модального выполнения>''
+'''LoadModule'''(''<Способ вызова (INT)>'',''<Путь или имя базы данных (STRING)>''{{OptionalByRef|,<Параметр>,<Опция>}}{{Optional|,<Имя модуля (STRING)>{{Default|{{Eq}}"Module"}},<Имя формы (STRING)>{{Default|{{Eq}}"SelectForm"}}}}{{OptionalByRef|,<Серийный номер потока, в котором происходит исполнение (INT)>}}):''<Результат модального выполнения>''
 </code>
 ==== Аргументы ====
@@ Line 31: / Line 31: @@
 * <code>''<Имя модуля (STRING)>''</code> - {{Optional}} Имя загружаемого модуля, если этот параметр не указан, будет использовано имя '''Module'''.
 * <code>''<Имя формы (STRING)>''</code> - {{Optional}} Имя загружаемой формы, если этот параметр не указан, будет использовано имя '''SelectForm'''. Если форма не будет использоваться (загруженный модуль будет закрыт, так как функция ''OnOpen'' возвратит 0, либо произойдет исключение и пр.), т.е. загрузка будет прервана до начала загрузки визуальной части, этот параметр не имеет значения.
 ==== Возвращаемое значение ====

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