addUserActionEventHandler: Difference between revisions

From Bohemia Interactive Community
(Add _thisEvent, thanks to NikkoJT)
mNo edit summary
 
(One intermediate revision by one other user not shown)
Line 20: Line 20:
* {{hl|"Analog"}}
* {{hl|"Analog"}}


|p3= expression: '''[[Code]]''' - expression that will be executed in [[missionNamespace]] when event handler fires.<br>
|p3= expression: [[Code]] - expression that will be executed in [[missionNamespace]] when event handler fires.<br>
The Event Handler index is available as {{hl|{{Link|Magic Variables#thisEvent|_thisEventHandler}}}} during Event Handler code execution.<br>
The Event Handler index is available as {{hl|{{Link|Magic Variables#thisEvent|_thisEventHandler}}}} during Event Handler code execution.<br>
The magic variable {{hl|{{Link|Magic Variables#thisEvent|_thisEvent}}}} is available in these event handlers but can only return one of these three values:
<spoiler text="Show _thisEvent information">
{{Feature|important
|The magic variable {{hl|{{Link|Magic Variables#thisEvent|_thisEvent}}}} is available in these event handlers but can only return one of these three values:
* {{hl|"KeyActivateEH"}}
* {{hl|"KeyActivateEH"}}
* {{hl|"KeyDeactivateEH"}}
* {{hl|"KeyDeactivateEH"}}
* {{hl|"KeyAnalogEH"}}
* {{hl|"KeyAnalogEH"}}
'''This is prone to change in {{arma3}} v2.20!'''
}}
</spoiler>


|r1= [[Number]] - the index of the currently added UserAction event handler is returned
|r1= [[Number]] - the index of the currently added UserAction event handler is returned

Latest revision as of 21:22, 31 December 2025

Hover & click on the images for description

Description

Description:
Adds a user action event handler to the current mission and returns its event handler index.
Groups:
Event Handlers

Syntax

Syntax:
addUserActionEventHandler [keyName, event, expression]
Parameters:
keyName: String - action key name - see inputAction/actions
event: String - event name - see UserAction Event Handlers. Can be one of:
  • "Activate"
  • "Deactivate"
  • "Analog"
expression: Code - expression that will be executed in missionNamespace when event handler fires.
The Event Handler index is available as _thisEventHandler during Event Handler code execution.
The magic variable _thisEvent is available in these event handlers but can only return one of these three values:
  • "KeyActivateEH"
  • "KeyDeactivateEH"
  • "KeyAnalogEH"
This is prone to change in Arma 3 v2.20!
Return Value:
Number - the index of the currently added UserAction event handler is returned

Examples

Example 1:
private _ehId = addUserActionEventHandler ["ReloadMagazine", "Activate", { systemChat "reloading!"; }];

Additional Information

See also:
removeUserActionEventHandler removeAllUserActionEventHandlers UserAction Event Handlers

Notes

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