RU/wasEventCancelled

Эта функция проверяет, было ли отменено последнее завершённое событие. Это в основном полезно для пользовательских событий, созданных сценариями.

События могут быть отменены с помощью cancelEvent, это указывает на то, что ресурс, который вызвал событие, должен сделать всё возможное, чтобы отменить любые изменения, внесённые тем, что вызвало событие. См. triggerEvent для более подробного объяснения этого.

Синтаксис

bool wasEventCancelled( )

Возвращаемые значения

true, если событие было отменено.
false, если:

событие не было отменено;
события не существует.

Пример использования

Пример 1. В этом примере проверяется, отменялось ли пользовательское событие "onFlagPickup".

addEvent( "onFlagPickup", true )

function flagHitcheck( thePlayer )
    parentElement = getElementParent( source ) -- получить родительский элемент маркера
    if ( getElementType( parentElement ) == "flag" ) then -- если это элемент флага, то
        triggerEvent ( "onFlagPickup", source, thePlayer ) -- запускаем наше событие "onFlagPickup" 
        if ( not wasEventCancelled() ) then -- если обработчик для события "onFlagPickup" не отменил его, то
            setElementData( thePlayer, "hasFlag", true ) -- установить, что игрок поднял флаг
        end
    end
end
addEventHandler( "onMarkerHit", getRootElement(), flagHitCheck )

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

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

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

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

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

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

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