RU/addEvent

Эта функция позволяет вам зарегистрировать свое собственное событие ( event ). Созданные вами события работают точно по такому же принципу, как и встроенные. Подробнее о системе событий в статье event system.

Синтаксис

bool addEvent ( string eventName [, bool allowRemoteTrigger = false ] )

Обязательные аргументы

eventName: Название создаваемого вами события.

Дополнительные аргументы

allowRemoteTrigger: Логическая (boolean) переменная, которая определяет, может ли это событие быть вызванным удаленно с помощью функций triggerClientEvent / triggerServerEvent или нет.

Вывод функции

Возвращает true если событие было успешно создано, false в противном случае.

Пример

В этом примере мы создадим новое событие под названием onSpecialEvent.

-- Добавить новое событие под названием "onSpecialEvent"
addEvent ( "onSpecialEvent", true )

-- Описываем функцию для обработки, которая принимает параметр "text" и выводит его в чат
function specialEventHandler ( text )
	outputChatBox ( text )
end

-- Добавляем эту функцию, как обработчик нашего нового события
addEventHandler ( "onSpecialEvent", getRootElement(), specialEventHandler )

Затем вы можете вызвать это событие с помощью функции triggerEvent:

	triggerEvent ( "onSpecialEvent", getRootElement(), "test" )

Это приведет к тому, что сработает обработчик события, и в чат будет выведен текст "test"

Смотрите также

Серверные функции

getCancelReason - получает причину отмены события
triggerClientEvent - позволяет вызвать срабатывание события, предварительно созданного на клиенте
triggerLatentClientEvent - аналог triggerClientEvent, но скорость передачи может быть ограничена

Клиентские функции

triggerLatentServerEvent - аналог triggerServerEvent, но скорость передачи может быть ограничена
triggerServerEvent - позволяет вызвать срабатывание события, предварительно созданного на сервере

Общие функции

addEvent - позволяет зарегистрировать своё собственное событие
addEventHandler - прикрепляет к событию обработчик
cancelEvent - останавливает автоматическую внутреннюю обработку события
cancelLatentEvent - останавливает автоматическую внутреннюю обработку скрытого события
getEventHandlers - получает прикреплённые функции из события и присоединённый элемент из текущего lua-скрипта
getLatentEventHandles - получает текущие скрытые события в очереди
getLatentEventStatus - получает состояние одного скрытого события в очереди
removeEventHandler - открепляет от события обработчик
triggerEvent - вызывает срабатывание указанного события для указанного элемента в дереве элементов
wasEventCancelled - проверяет, было ли отменено последнее завершённое событие