AddEvent

From Multi Theft Auto: Wiki
Revision as of 15:32, 30 July 2007 by Jbeta (talk | contribs) (Removed references to obsolete parameters)
Jump to navigation Jump to search

This function allows you to register a custom event. Custom events function exactly like the built in events. See event system for more information on the event system.

Syntax

bool addEvent ( string eventName )   

Required Arguments

  • eventName: The name of the event you wish to create.

Returns

Returns true if the event was added successfully, false otherwise.

Example

This example will define a new event called onSpecialEvent.

-- Get the global root element
rootElement = getRootElement ()

-- Add a new event called onSpecialEvent
addEvent ( "onSpecialEvent" )

-- Define our handler function, that takes a "text" parameter
function specialEventHandler ( text )
	outputChatBox ( text )
end

-- Add it as a handler for our event
addEventHandler ( "onSpecialEvent", rootElement, specialEventHandler )

You can then trigger this event later on using:

	triggerEvent ( "onSpecialEvent", rootElement, "test" )

See Also

Shared