Admin: 1 revision imported

2021-02-07T06:50:51Z

1 revision imported

Admin at 16:18, 17 August 2020

2020-08-17T16:18:06Z

New page

{{infobox function
|name=InvokeEvent
|object=[[Форма]]
|caption=Вызов визуального события
|type=1
|status=2
|db=0
|exception=Форма не визуальная или не загружена, невозможно превратить в строку, неверные параметры
|visual=1}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Форма]]}}
Функция инициирует выполнение указанного визуального события привязанного либо к визуальному элементу формы (если оный адресуется объектом, к примеру [[Студия/Визуальные события|''OnInitLine'']]), либо к самой форме (к примеру [[Студия/Визуальные события|''OnOpen'']]). Разработчик должен указать все переменные, участвующие в событие и задать их значения. Если какая-то из переменных не будет указана, при обращении к ней в момент выполнения события будет вызвано исключение. Событие выполняется в синхронном режиме (т.е. является прерывающим событием), управление не будет возвращено до тех пор, пока не закончится выполнение события. Изменения в переменных внутри события будут транслированы на переменные, переданные в виде аргументов события в момент окончания выполнения события. Некоторые события (к примеру, ''OnOpen'') могут быть вызваны несколько раз, если они заданы на вложенных формах макросов или закладках. Функция применяется к загруженной визуальной форме или ее элементу. Ниже дан краткий список возможных событий (описания и необходимый набор переменных см. в описании Студии):
* События, применяемые к форме: '''OnOpen''', '''OnClose''', '''OnTimer''', '''OnSaveRequest''', '''OnStatusChange''', '''OnTaskbarMenuClick''', '''OnMessage''', '''OnSaveSettings''', '''OnLoadSettings''', '''OnAfterLoadSettings'''
* События, применяемые к визуальным элементам формы: '''OnGetCaption''', '''OnClick''', '''OnDoubleClick''', '''OnRightClick''', '''OnKeyPress''', '''OnChangeOrClick''', '''OnBeforeChange''', '''OnAfterChange''', '''OnBeforeEditLine''', '''OnAfterEditLine''', '''OnBeforeEditCell''', '''OnAfterEditCell''', '''OnBeforeEdit''', '''OnAfterEdit''', '''OnGetLine''', '''OnGetVisualProperties''', '''OnGetCellVisualProperties''', '''OnGetFormNameForOperation''', '''OnChecking''', '''OnMoveToFolder''', '''OnSaveLoadObject''', '''OnSelectionChange''', '''OnAttachedButtons''', '''OnBeforeResize''', '''OnAfterResize''', '''OnEnter''', '''OnExit''', '''OnInitLine''', '''OnShowLine''', '''OnBeforeSelect''', '''OnGetRightClickMenu''', '''OnBeforeEditObject''', '''OnInitCombobox''', '''OnInitLeaf''', '''OnBeforeLoadElements''', '''OnAfterNewElementCreated''', '''OnBeforeElementSaved''', '''OnAfterElementSaved''', '''OnBeforeRefresh''', '''OnAfterFilterChange''', '''OnAfterSorting'''

== Синтаксис ==
<code>
{{Grey|Form.}}'''InvokeEvent'''(''<Имя события (STRING)>'',''<Имена переменных, передаваемых событию, через запятые (STRING)>''{{OptionalByRef|,<Значение переменной 1>,<Значение переменной 2>...}})
</code>

==== Аргументы ====
* <code>''<Имя события (STRING)>''</code> - Задает наименование события, исполнение которого нужно инициировать. Регистр наименования не имеет значения.
* <code>''<Имена переменных, передаваемых событию, через запятые (STRING)>''</code> - Задает наименования переменных, значения котороых будут переданы в вызываемое событие. Переменные задаются через запятую. Регистр написания наименований не имеет значения.
* <code>''<Значение переменной 1>'', ''<Значение переменной 2>''...</code> - {{Optional}} {{ByRef}} Задает аргументы, значениями которых будут заполнены переменные при вызове события. Если аргумент описывается переменной, а не выражением, после выполнения функции, значение переменной может быть обновлено, если оно было изменено внутри события.

== Примеры ==
<pre>
//Вызов события OnInitLine таблицы MainTab после программного изменения строк таблицы
Form.MainTab.InvokeEvent("OnInitLine","IndexFrom,IndexTo",1,aTab.Size());

//Привязка полей к реквизитам редактируемого объекта (к примеру, в макросах),
// и вызов события формы OnStatusChange для обновления общих параметров формы
Form.cName.BindToProperty("Name");
Form.cCode.BindToProperty("Code");
Form.InvokeEvent("OnStatusChange");
If Form.Object.Status()<0 Then
Form.cName.SetFocus();
Else
Form.bPanelClose.SetFocus();
Endif;
</pre>

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

Form.InvokeEvent - Revision history

Admin: 1 revision imported

Admin at 16:18, 17 August 2020