Admin: 1 revision imported

2026-04-01T09:59:03Z

1 revision imported

1>Admin at 16:19, 8 January 2026

2026-01-08T16:19:53Z

Admin: 1 revision imported

2025-01-22T06:53:44Z

1 revision imported

1>Admin: Created page with "{{infobox function |name=LinkEvent |object=Объект GI#Атрибуты и функции графических объектов|Графический объект о..."

2025-01-20T16:53:23Z

Created page with "{{infobox function |name=LinkEvent |object=Объект GI#Атрибуты и функции графических объектов|Графический объект о..."

New page

{{infobox function
|name=LinkEvent
|object=[[Объект GI#Атрибуты и функции графических объектов|Графический объект объекта GI]]
|caption=Функции графических объектов
|type=1
|status=2
|db=0
|exception=Неверные аргументы.
|visual=1}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект GI]]}}
Функция ассоциирует локальную функцию по ее имени со стандартным событием графического объекта. Также функции может передаваться один произвольный аргумент при ее вызове. На данный момент доступны следующие стандартные события объектов: '''OnDraw''', '''OnNewInput''', '''OnChange''', '''OnMove'''.

== Синтаксис ==
<code>
{{Grey|GIObject.}}'''LinkEvent'''(''<Имя события (STRING)>''{{OptionalByRef|,<Имя локальной функции (STRING)>,<Глубина поиска (INT)>{{Default|{{Eq}}0}},<Аргумент функции>}})
</code>

==== Аргументы ====
* <code>''<Имя события (STRING)>''</code> - Аргумент задает имя события для ассоциации. На данный момент доступны следующие имена событий:
** '''OnDraw''': Событие вызывается в момент необходимости нарисовать текущий объект. В нем можно разместить произвольный код для прорисовки и в нужный момент вызвать функцию [[GIObject.DrawObject|DrawObject]], которая выполняет саму прорисовку объекта. Локальная функция для вызова этого события должна содержать три аргумента -- объект GI, рисуемый графический объект и доп. параметр, заданный в этой функции, пример: <code>Function Прорисовка(aGI,аОбъект,ДопПараметр)</code>.
** '''OnNewInput''': {{Planned}} Событие будет вызываться в момент получения новой информации от внешних устройств ввода (клавиатура, мышь, контроллер), когда объект имеет фокус, либо в момент получения или потери фокуса объектом.
** '''OnChange''': {{Planned}} Событие будет вызываться в момент изменения статуса объекта или его определенных атрибутов.
** '''OnMove''': {{Planned}} Событие будет вызываться в момент движения, вращения или мастабирования объекта.
* <code>''<Имя локальной функции (STRING)>''</code> - Аргумент задает имя локальной или глобальной функции, которая будет вызываться при наступлении события.
* <code>''<Глубина поиска (INT)>''</code> - {{Optional}} Задает способ поиска локальной функции. Может принимать следующие значения:
** 0 (по умолчанию) -- выполнять поиск во всех модулях [[Общее описание языка#Вложенность функций и модулей, уровни вложенности|большего уровня вложенности]] (родительских) и во всех глобальных модулях.
** 1 -- выполнять поиск только внутри текущего модуля.
** 2 -- выполнять поиск только внутри родительского модуля.
** 3..x -- выполнять поиск только внутри родительского модуля указанного уровня (к примеру, для уровня 3, выполнять поиск только в родителе родителя текущего модуля).
* <code>''<Аргумент функции>''</code> - {{Optional}} Содержит произвольное значение, которое будет передано локальной функции третим аргументом при ее вызове.

== Примеры ==
<pre>
//Используется фрагмент из обработки tetris.sfo

Function OnDrawObject(aGI,aObj)
aGI.ShaderProgramSetVariable(лкПрограммы[2],"u_offset",,0,лкТекущаяФигура[5]*лкШиринаКвадрата);
aObj.DrawObject();
aGI.ShaderProgramSetVariable(лкПрограммы[2],"u_offset",,0,0);
EndFunction

...
аМодель:=GIModel.New();
аМодель.SimpleModel(Buffer.Create());
аОбъектФигуры:=aGI.AddObject();
аОбъектФигуры.Model(аМодель);
аОбъектФигуры.LinkEvent("ONDRAW","OnDrawObject",1);
лкОбъекты[2]:=аОбъектФигуры;

</pre>

← Older revision	Revision as of 09:59, 1 April 2026
(No difference)

@@ Line 28: / Line 28: @@
 * <code>''<Имя локальной функции (STRING)>''</code> - Аргумент задает имя локальной или глобальной функции, которая будет вызываться при наступлении события.
 * <code>''<Глубина поиска (INT)>''</code> - {{Optional}} Задает способ поиска локальной функции. Может принимать следующие значения:
 ** 0 (по умолчанию) -- выполнять поиск во всех модулях [[Общее описание языка#Вложенность функций и модулей, уровни вложенности|большего уровня вложенности]] (родительских) и во всех глобальных модулях.
 ** 1 -- выполнять поиск только внутри текущего модуля.

← Older revision	Revision as of 06:53, 22 January 2025
(No difference)

GIObject.LinkEvent - Revision history

Admin: 1 revision imported

1>Admin at 16:19, 8 January 2026

Admin: 1 revision imported

1>Admin: Created page with "{{infobox function |name=LinkEvent |object=Объект GI#Атрибуты и функции графических объектов|Графический объект о..."