removeEventHandler: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(add. ArmA2 classification)
(Add 2.10 group possibility)
 
(33 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| ofpr |= Game name
|game1= ofp
|version1= 1.85


|1.85|= Game version
|game2= ofpe
____________________________________________________________________________________________
|version2= 1.00


| Removes event handler added by [[addEventHandler]].  
|game3= arma1
|version3= 1.00


When any handler is removed, all handler indices higher than the deleted one should be decremented. |= Description
|game4= arma2
____________________________________________________________________________________________
|version4= 1.00


| objectName '''removeEventHandler''' [type, index]|= Syntax
|game5= arma2oa
|version5= 1.50


|p1= objectName: [[Object]] |= Parameter 1
|game6= tkoh
|p2= [type, index]: [[Array]] |= Parameter 2
|version6= 1.00
|p3= type: [[String]] |= Parameter 3
|p4= index: [[Number]]. Value returned from [[addEventHandler]] |= Parameter 4


|game7= arma3
|version7= 0.50


|gr1= Event Handlers


| [[Nothing]] |= Return value
|descr= Removes a given Event Handler that was added with [[addEventHandler]].
____________________________________________________________________________________________
 
|x1= <code>[[player]] removeEventHandler ["killed", 0]</code> |= Example 1
____________________________________________________________________________________________


| [[removeAllEventHandlers]], [[addEventHandler]] |= See also
|s1= target [[removeEventHandler]] [type, index]


}}
|p1= target: [[Object]] or {{GVI|arma3|2.10}} [[Group]]
 
|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]]


<h3 style="display:none">Notes</h3>
|r1= [[Nothing]]
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|x1= <sqf>player removeEventHandler ["Killed", 0];</sqf>
</dl>


<h3 style="display:none">Bottom Section</h3>
|x2= The [[Magic Variables]] <var>_thisEvent</var> and <var>_thisEventHandler</var> can be used to easily remove an Event Handler:
<sqf>player addEventHandler ["FiredNear", {
systemChat "This Event Handler is now removing itself!";
player removeEventHandler [_thisEvent, _thisEventHandler];
}];</sqf>


[[Category:Scripting Commands|REMOVEEVENTHANDLER]]
|seealso= [[addEventHandler]] [[removeAllEventHandlers]] [[removeMPEventHandler]] [[removeMissionEventHandler]] [[:Category:Event Handlers|Event Handlers]]
[[Category:Scripting Commands OFP 1.96|REMOVEEVENTHANDLER]]
}}
[[Category:Scripting Commands ArmA|REMOVEEVENTHANDLER]]
[[Category:Command_Group:_Activators|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]

Latest revision as of 11:52, 24 May 2022

Hover & click on the images for description

Description

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

Syntax

Syntax:
target removeEventHandler [type, index]
Parameters:
target: Object or Arma 3 logo black.png2.10 Group
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:
The Magic Variables _thisEvent and _thisEventHandler can be used to easily remove an Event Handler:
player addEventHandler ["FiredNear", { systemChat "This Event Handler is now removing itself!"; player removeEventHandler [_thisEvent, _thisEventHandler]; }];

Additional Information

See also:
addEventHandler removeAllEventHandlers removeMPEventHandler removeMissionEventHandler Event Handlers

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