removeEventHandler: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[Category:Scripting Commands OFP 1.[4-9]{2}(\|(\{\{uc:\{\{PAGENAME\}\}\}\}|#))?\]\] " to "")
m (formatting)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| ofpr
|game1= ofp


|1.85
|version1= 1.85
 
|game2= ofpe
 
|version2= 1.00
 
|game3= arma1
 
|version3= 1.00
 
|game4= arma2
 
|version4= 1.00
 
|game5= arma2oa
 
|version5= 1.51
 
|game6= tkoh
 
|version6= 1.00
 
|game7= arma3
 
|version7= 0.50


|gr2= Event Handlers
|gr2= Event Handlers
Line 11: Line 35:
|s1= object [[removeEventHandler]] [type, index]
|s1= object [[removeEventHandler]] [type, index]


|p1= '''object''': [[Object]]
|p1= object: [[Object]]


|p2= '''type''': [[String]] - See [[:Category:Event Handlers|Event Handlers]] for the full list of available options.
|p2= type: [[String]] - See [[:Category:Event Handlers|Event Handlers]] for the full list of available options


|p3= '''index''': [[Number]] - The value originally returned by [[addEventHandler]].
|p3= index: [[Number]] - The value originally returned by [[addEventHandler]]


|r1= [[Nothing]]
|r1= [[Nothing]]
Line 21: Line 45:
|x1= <code>[[player]] [[removeEventHandler]] ["Killed", 0];</code>
|x1= <code>[[player]] [[removeEventHandler]] ["Killed", 0];</code>


|x2= Since Arma 3 v.1.63.137807 the Event Handler index is available as <tt>_thisEventHandler</tt> during Event Handler code execution and can be used to easily remove the Event Handler:
|x2= Since Arma 3 v1.64 the Event Handler index is available as <tt>_thisEventHandler</tt> during Event Handler code execution and can be used to easily remove the Event Handler:
<code>[[player]] [[addEventHandler]] ["FiredNear", {
<code>[[player]] [[addEventHandler]] ["FiredNear",
{
[[systemChat]] "This Event Handler is now removing itself!";
[[systemChat]] "This Event Handler is now removing itself!";
[[player]] [[removeEventHandler]] ["FiredNear", _thisEventHandler];
[[player]] [[removeEventHandler]] ["FiredNear", _thisEventHandler];
Line 29: Line 54:
|seealso= [[addEventHandler]] [[:Category:Event Handlers|Event Handlers]] [[removeAllEventHandlers]] [[removeMPEventHandler]] [[removeMissionEventHandler]]
|seealso= [[addEventHandler]] [[:Category:Event Handlers|Event Handlers]] [[removeAllEventHandlers]] [[removeMPEventHandler]] [[removeMissionEventHandler]]
}}
}}
{{GameCategory|arma1|Scripting Commands}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}

Revision as of 11:33, 27 March 2021

Hover & click on the images for description

Description

Description:
Removes a given Event Handler that was added with addEventHandler.
Groups:
Event Handlers

Syntax

Syntax:
object removeEventHandler [type, index]
Parameters:
object: Object
type: String - See Event Handlers for the full list of available options
index: Number - The value originally returned by addEventHandler
Return Value:
Nothing

Examples

Example 1:
player removeEventHandler ["Killed", 0];
Example 2:
Since Arma 3 v1.64 the Event Handler index is available as _thisEventHandler during Event Handler code execution and can be used to easily remove the Event Handler: player addEventHandler ["FiredNear", { systemChat "This Event Handler is now removing itself!"; player removeEventHandler ["FiredNear", _thisEventHandler]; }];

Additional Information

See also:
addEventHandler Event Handlers removeAllEventHandlers removeMPEventHandler removeMissionEventHandler

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note