addMissionEventHandler: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\|game([0-9])= *([^ ]+) * +\|version([0-9])= *([^ ]+) * " to "|game$1=$2 |version$3=$4 ")
m (Text replacement - "\|s1= +" to "|s1= ")
Line 10: Line 10:
|descr= Adds event handler attached to the current mission and returns event handler handle. For the list of available mission event handlers see: [[Arma 3: Mission Event Handlers]]
|descr= Adds event handler attached to the current mission and returns event handler handle. For the list of available mission event handlers see: [[Arma 3: Mission Event Handlers]]


|s1= [[addMissionEventHandler]]  [event, expression, arguments]
|s1= [[addMissionEventHandler]]  [event, expression, arguments]


|p1= event: [[String]] - event name
|p1= event: [[String]] - event name

Revision as of 15:32, 19 June 2021

Hover & click on the images for description

Description

Description:
Adds event handler attached to the current mission and returns event handler handle. For the list of available mission event handlers see: Arma 3: Mission Event Handlers
Groups:
Event Handlers

Syntax

Syntax:
addMissionEventHandler [event, expression, arguments]
Parameters:
event: String - event name
expression: Code or String - Expression that will be executed in missionNamespace when event handler fires.
  • If the event handler has some data to return upon activation they are stored in the _this variable
  • Since Arma 3 v1.64 the event handler handle is also stored in _thisEventHandler variable and is available during event handler code execution
  • Since Arma 3 v2.04 it is possible to pass additional arguments to the EH code via optional param. The args are stored in _thisArgs variable
args (Optional, default []): Array - Additional arguments to be passed to the EH code. Available during code execution via _thisArgs variable. Template:Since
Return Value:
Number - The index of the currently added mission event handler is returned

Examples

Example 1:
_id = addMissionEventHandler ["PlayerDisconnected", { systemChat str _this }];
Example 2:
_id = addMissionEventHandler ["EachFrame", { systemChat str [_thisArgs, time] }, [time]]; Template:Since

Additional Information

See also:
removeMissionEventHandlerremoveAllMissionEventHandlers

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