addMissionEventHandler: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "<code>([^ ]*)\{\{cc\|([^ ]*)\}\}([^ ]*)<\/code>" to "<code>$1// $2$3</code>") |
Lou Montana (talk | contribs) m (Text replacement - "<code>([^<]*)\[\[Magic Variables#this\|(_this)\]\]([^<]*)<\/code>" to "<code>$1$2$3</code>") |
||
Line 25: | Line 25: | ||
|r1= [[Number]] - The index of the currently added mission event handler is returned | |r1= [[Number]] - The index of the currently added mission event handler is returned | ||
|x1= <code>_id = addMissionEventHandler ["PlayerDisconnected", { systemChat str | |x1= <code>_id = addMissionEventHandler ["PlayerDisconnected", { systemChat str _this }];</code> | ||
|x2= <code>_id = addMissionEventHandler ["EachFrame", { systemChat str <nowiki>[</nowiki>[[_thisArgs]], time] }, <nowiki>[</nowiki>time]]; // since {{arma3 v2.04}}</code> | |x2= <code>_id = addMissionEventHandler ["EachFrame", { systemChat str <nowiki>[</nowiki>[[_thisArgs]], time] }, <nowiki>[</nowiki>time]]; // since {{arma3 v2.04}}</code> |
Revision as of 09:27, 13 May 2022
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
- 1.64 the event handler's handle is stored in _thisEventHandler variable and is available during event handler code execution
- 2.04 it is possible to pass additional arguments to the EH code via optional param. The args are stored in _thisArgs variable
- 2.06 the event's name is available from _thisEvent variable
- since 2.04
- arguments (Optional, default
[]
): Array - Additional arguments to be passed to the EH code. Available during code execution via _thisArgs variable. - 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]]; // since Template:arma3 v2.04
Additional Information
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