wasEventCancelled | Multi Theft Auto: Wiki Skip to content
Multi Theft Auto: Wiki

wasEventCancelled

Client-side
Server-side
Shared

Manual Review Required

Please finish this page using the corresponding Old Wiki article. Go to Contribution guidelines for more information.

This function checks if the last completed event was cancelled. This is mainly useful for custom events created by scripts.

Syntax 

bool wasEventCancelled ( )

Returns

  • bool: value

Returns true if the event was cancelled, false if it wasn't or doesn't exist.

Code Examples

shared

This example implements a custom eventonFlagPickupthat would be triggered if anonMarkerHitevent was triggered on a marker whose parent was aflagelement. If the event isn't canceled then an element data value is set on the player.

addEvent ( "onFlagPickup", true )


function flagHitcheck ( thePlayer )
    parentElement = getElementParent ( source ) -- get the parent of the marker
    if ( getElementType ( parentElement ) == "flag" ) then -- if it was a flag element then
        triggerEvent ( "onFlagPickup", source, thePlayer ) -- trigger our onFlagPickup event


        if ( not wasEventCancelled() ) then -- if handlers for 'onFlagPickup' didn't cancel it then
            setElementData ( thePlayer, "hasFlag", true ) -- set that the player picked up the flag
        end
    end
end
addEventHandler ( "onMarkerHit", getRootElement(), flagHitCheck )

See Also

Event Functions
Reference