AddEventHandler

This template is no longer in use as it results in poor readability. 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. The handler will only be called when the event it is attached to is triggered for this element, or one of its children. Often, this can be the root element (meaning the handler will be called when the event is triggered for any element).
• functionName: The name of the handler function you wish to call. This function should have the correct number of parameters defined for the event you are using, but it isn't required that it takes all of them.

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

This example sends a message to everyone in the server when a player spawns.

-- Get the root element
rootElement = getRootElement ()
-- Add an event handler to the onSpawnPointUse event (triggered when a player spawns at a spawnpoint)
addEventHandler ( "onSpawnpointUse", rootElement, "onSpawnpointUseHandler" )
-- Define our handler function
function onSpawnpointUseHandler( thePlayer )
	-- Get the player's name
	local playerName = getClientName( thePlayer )
	-- Output in the chat box that they've spawned
	outputChatBox ( playerName .. "has spawned!" )
end

See Also

• addEvent
• addEventHandler
• cancelEvent
• cancelLatentEvent
• getCancelReason
• getEventHandlers
• getLatentEventHandles
• getLatentEventStatus
• removeEventHandler
• triggerEvent
• triggerClientEvent
• triggerLatentClientEvent
• wasEventCancelled