RemoveEventHandler: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
{{Server client function}}
{{Needs_Checking|Why do we have to specify what element was the handler attached to? --[[User:Jbeta|jbeta]] 07:34, 3 June 2007 (CDT)
{{Needs_Checking|Why do we have to specify what element was the handler attached to? --[[User:Jbeta|jbeta]] 07:34, 3 June 2007 (CDT)
*Because multiple elements might use the same event and function --[[User:Kevuwk|Kevuwk]] 20:49, 22 June 2007 (CDT) }}
*Because multiple elements might use the same event and function --[[User:Kevuwk|Kevuwk]] 20:49, 22 June 2007 (CDT) }}
Line 6: Line 7:
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool removeEventHandler ( string eventName, element attachedTo, string functionName )  
bool removeEventHandler ( string eventName, element attachedTo, function functionName )  
</syntaxhighlight>  
</syntaxhighlight>  


Line 12: Line 13:
*'''eventName:''' The name of the [[event]] you want to detach the handler function from.
*'''eventName:''' The name of the [[event]] you want to detach the handler function from.
*'''attachedTo:''' The [[element]] the handler was attached to.
*'''attachedTo:''' The [[element]] the handler was attached to.
*'''functionName:''' The name of the handler function that was attached.
*'''functionName:''' The handler function that was attached.


===Returns===
===Returns===
Line 18: Line 19:


==Example==
==Example==
This example...
 


==See Also==
==See Also==
{{Event_functions}}
{{Event_functions}}
[[Category:Incomplete]]
[[Category:Incomplete]]

Revision as of 17:26, 16 August 2007

Dialog-information.png This article needs checking.

Reason(s): Why do we have to specify what element was the handler attached to? --jbeta 07:34, 3 June 2007 (CDT)
  • Because multiple elements might use the same event and function --Kevuwk 20:49, 22 June 2007 (CDT)

This functions removes a handler function from an event, so that the function is not called anymore when the event is triggered. See event system for more information on how the event system works.

Syntax

bool removeEventHandler ( string eventName, element attachedTo, function functionName ) 

Required Arguments

  • eventName: The name of the event you want to detach the handler function from.
  • attachedTo: The element the handler was attached to.
  • functionName: The handler function that was attached.

Returns

Returns true if the event handler was removed successfully. Returns false if the specified event handler could not be found or invalid parameters were passed.

Example

See Also