https://wiki.multitheftauto.com/wiki/RU/triggerEvent?action=history&feed=atom 2026-10-24T01:47:14Z Revision history for this page on the wiki MediaWiki 1.46.1 https://wiki.multitheftauto.com/index.php?title=RU/triggerEvent&diff=23981&oldid=prev 2010-07-08T21:39:39Z

<p>Created page with &#039;__NOTOC__ {{RU/Server client function}} Эта функция вызовет срабатывание указанного <a href="/wiki/Event" class="mw-redirect" title="Event">события</a> для указанного [[…&#039;</p> <p><b>New page</b></p><div>__NOTOC__<br /> {{RU/Server client function}}<br /> Эта функция вызовет срабатывание указанного [[event|события]] для указанного [[element|элемента]] в дереве элементов. Подробнее о работе системы событий см. [[event system]].<br /> <br /> Не следует вызывать срабатывание событий для корня ([[root element]]), если это не является необходимым, поскольку это приводит к срабатыванию события для всех элементов, что может сильно нагрузить CPU. Нужно стараться использовать как можно более конкретный элемент (т.е. ниже по дереву элементов).<br /> <br /> Также можно использовать значение, возвращаемое этой функцией, чтобы определить, было ли событие отменено одним из обработчиков. Реакция вашего скрипта на отмену события (если она предполагается) должна соответствовать назначению события. В общем случае, отмена события должна приводить к прекращению выполнения того кода, который зависит от вызывавшего событие. Например, если у вас есть событие на захват флага &#039;&#039;onFlagCapture&#039;&#039;, то предполагается, что его отмена должна делать невозможным захват флага. Аналогично, если вы вызываете при убийстве игрока событие &#039;&#039;onPlayerKill&#039;&#039;, то ожидаемая реакция при его отмене - либо невозможность убить игрока, либо, например, невозможность получить за это очки.<br /> <br /> ==Синтаксис== <br /> &lt;syntaxhighlight lang=&quot;lua&quot;&gt;<br /> bool triggerEvent ( string eventName, element baseElement, [ var argument1, ... ] ) <br /> &lt;/syntaxhighlight&gt; <br /> <br /> ===Обязательные аргументы=== <br /> *&#039;&#039;&#039;eventName:&#039;&#039;&#039; Название вызываемого события.<br /> *&#039;&#039;&#039;baseElement:&#039;&#039;&#039; Элемент, для которого будет вызвано событие. Подробнее о работе системы событий см. [[event system]].<br /> <br /> ===Дополнительные аргументы=== <br /> {{RU/OptionalArg}} <br /> *&#039;&#039;&#039;argument1:&#039;&#039;&#039; Первый аргумент, который получит обработчик после значения переменной &#039;&#039;baseElement&#039;&#039;.<br /> **&#039;&#039;Примечание:&#039;&#039; Обработчику можно передавать более одного аргумента, список аргументов разделяют запятыми.<br /> <br /> ===Вывод===<br /> * Возвращает &#039;&#039;&#039;nil&#039;&#039;&#039;, если событие не найдено, либо переданы некорректные аргументы. <br /> * Возвращает &#039;&#039;&#039;true&#039;&#039;&#039; если событие сработало успешно, и &#039;&#039;не&#039;&#039; было отменено с помощью [[cancelEvent]].<br /> * Возвращает &#039;&#039;&#039;false&#039;&#039;&#039; если событие сработало успешно, но было отменено с помощью [[cancelEvent]].<br /> <br /> ==Пример== <br /> Если вы создадите следующее событие:<br /> &lt;syntaxhighlight lang=&quot;lua&quot;&gt;<br /> -- Получение корня<br /> rootElement = getRootElement ()<br /> <br /> -- Создаем новое событие<br /> addEvent ( &quot;onSpecialEvent&quot;, true )<br /> -- Описываем функцию обработки<br /> function specialEventHandler ( text )<br /> outputChatBox ( text )<br /> end<br /> -- Добавляем обработчик<br /> addEventHandler ( &quot;onSpecialEvent&quot;, rootElement, specialEventHandler )<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Затем можно вызвать срабатывание этого события:<br /> &lt;syntaxhighlight lang=&quot;lua&quot;&gt;<br /> triggerEvent ( &quot;onSpecialEvent&quot;, rootElement, &quot;test&quot; )<br /> &lt;/syntaxhighlight&gt;<br /> В результате в чат будет отправлено сообщение &quot;test&quot;.<br /> ==Смотрите также==<br /> {{RU/Event_functions}}<br /> [[en:triggerEvent]]</div>

Damage22