Admin: 1 revision imported

2021-02-07T06:52:12Z

1 revision imported

Admin at 15:03, 17 August 2020

2020-08-17T15:03:56Z

New page

{{infobox function
|name=OnOpen
|object=
|caption=События форм
|type=1
|status=2
|db=0
|location=Текущий локальный модуль
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Предопределенные события]]}}
<p>Событие, возникающее в модуле после его загрузки в память, до инициализации формы (если таковая присутствует). Подобное событие можно также описать в событиях, привязанных к форме, а не модулю, однако, последнее будет вызвано уже после начальной инициализации формы. Если функция возвратит 0 (или внутри функции произойдет исключение), форма не будет загружена и работа модуля будет завершена. Для создания модулей без форм, обработчик модуля размещается внутри этого события. Может использоваться, к примеру, для печати форм документов или для консольных клиентов при автоматической выгрузке, тогда как в визуальном клиенте будет показана форма с набором установок. Существует возможность изменить имя загружаемой формы непосредственно внутри этой функции.</p>
Несмотря на то, что на момент работы этой функции, форма еще не была инициализирована, некоторые исключительные обращения к объекту формы допустимы (к примеру, '''[[Form.Object]]''' или '''[[Form.Type]]''').

== Синтаксис ==
<code>
'''OnOpen'''({{OptionalByRef|''<Имя загружаемой формы (STRING,OUT)>''}}):<Продолжить загрузку формы (INT)>
</code>
==== Аргументы ====
* <code>''<Имя загружаемой формы (STRING,OUT)>''</code> - {{Optional}} {{ByRef}} Наименование формы, которая будет загружена после окончания работы этого события, если оно не запретит дальнейшую загрузку. Функция может изменить наименование формы, это полезно, к примеру, если документ имеет несколько форм в зависимости от его типа, описание выбора нужной формы будет находиться в самом документе, формы будет выбрана до начала загрузки визуальных элементов.
==== Возвращаемое значение ====
Функция должна возвратить единицу (переменная ''Result'' при вызове инициализирована единицей), чтобы продолжить загрузку формы, либо ноль, чтобы отказаться от загрузки (если, к примеру, обработка вывела печатную форму в теле данной функции и необходимо вернуться в вызвавший модуль для продолжения работы).

== Примеры ==
<pre>
Function OnOpen(ByRef FormName)
aEl:=Form.Object;
If aEl.Selected()<0 Then
If aEl.КодОперации.Selected()=0 Then
aEl.КодОперации:=Enum.коОсновныеСредства.ПоступлениеОсновныхСредств;
EndIf;
EndIf;
FormName:="Form";
If (aEl.КодОперации=Enum.коОсновныеСредства.СписаниеОсновныхСредств)Or(aEl.КодОперации=Enum.коОсновныеСредства.ВводВЭксплуатациюОсновныхСредств)
Or(aEl.КодОперации=Enum.коОсновныеСредства.РеализацияОсновныхСредств) Then
FormName:="ФормаСписание";
ElseIf aEl.КодОперации=Enum.коОсновныеСредства.ИнвентаризацияОсновныхСредств Then
FormName:="ФормаИнвентаризация";
ElseIf aEl.КодОперации=Enum.коОсновныеСредства.ПеремещениеОсновныхСредств Then
FormName:="ФормаПеремещения";
EndIf;
EndFunction
</pre>

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

OnOpen - Revision history

Admin: 1 revision imported

Admin at 15:03, 17 August 2020