AddEventHandler

This function will add an event handler. An event handler is a function that will be called when an event is triggered. See event system for more information on how the event system works.

Syntax

bool addEventHandler ( string eventName, element attachedTo, string functionName )    

Required Arguments

• eventName: The name of the event you want to attach the handler function to
• attachedTo: The element you wish to attach the handler to. Often this can be the root element.
• functionName: The name of the function you wish to call. This function should have the correct number of parameters defined for the event you are using.

Returns

Returns true if the event handler was attached successfully. Returns false if the event specified could not be found or the attachedTo element specified is invalid.

Example

-- Get the root map element
rootElement = getRootElement ()
-- Add an event handler to the onSpawnPointUse event (triggered when a player spawns)
addEventHandler ( "onSpawnpointUse", rootElement, "spawn" )
-- Define our handler function
function spawn( thePlayer )
	-- Tell them in the chat box that they've spawned
	outputChatBox ( "You've spawned!", thePlayer )
end

See Also

• addEvent
• addEventHandler
• cancelEvent
• cancelLatentEvent
• getEventHandlers
• getLatentEventHandles
• getLatentEventStatus
• removeEventHandler
• triggerEvent
• wasEventCancelled