|
|
| Line 1: |
Line 1: |
| __NOTOC__
| |
| {{RU/Server_client_function}}
| |
| Эта функция позволяет вам зарегистрировать свое собственное событие ( [[event]] ). Созданные вами события работают точно по такому же принципу, как и встроенные. Подробнее о системе событий в статье [[event system]].
| |
|
| |
|
| ==Синтаксис==
| |
| <syntaxhighlight lang="lua">
| |
| bool addEvent ( string eventName [, bool allowRemoteTrigger = false ] )
| |
| </syntaxhighlight>
| |
|
| |
| ===Обязательные аргументы===
| |
| *'''eventName:''' Название создаваемого вами события.
| |
|
| |
| ===Дополнительные аргументы===
| |
| *'''allowRemoteTrigger:''' Логическая (boolean) переменная, которая определяет, может ли это событие быть вызванным удаленно с помощью функций [[RU/triggerClientEvent|triggerClientEvent]] / [[RU/triggerServerEvent|triggerServerEvent]] или нет.
| |
|
| |
| ===Вывод функции===
| |
| Возвращает ''true'' если событие было успешно создано, ''false'' в противном случае.
| |
|
| |
| ==Пример==
| |
| В этом примере мы создадим новое событие под названием ''onSpecialEvent''.
| |
| <syntaxhighlight lang="lua">
| |
| -- Добавить новое событие под названием "onSpecialEvent"
| |
| addEvent ( "onSpecialEvent", true )
| |
|
| |
| -- Описываем функцию для обработки, которая принимает параметр "text" и выводит его в чат
| |
| function specialEventHandler ( text )
| |
| outputChatBox ( text )
| |
| end
| |
|
| |
| -- Добавляем эту функцию, как обработчик нашего нового события
| |
| addEventHandler ( "onSpecialEvent", getRootElement(), specialEventHandler )
| |
| </syntaxhighlight>
| |
|
| |
| Затем вы можете вызвать это событие с помощью функции triggerEvent:
| |
| <syntaxhighlight lang="lua">
| |
| triggerEvent ( "onSpecialEvent", getRootElement(), "test" )
| |
| </syntaxhighlight>
| |
|
| |
| Это приведет к тому, что сработает обработчик события, и в чат будет выведен текст "test"
| |
|
| |
| ==Смотрите также==
| |
| {{RU/Event functions}}
| |
|
| |
| [[en:addEvent]]
| |