addUserActionEventHandler: Difference between revisions
Lou Montana (talk | contribs) (Add _thisEvent, thanks to NikkoJT) |
BrettMayson (talk | contribs) mNo edit summary |
||
| (One intermediate revision by one other user not shown) | |||
| Line 20: | Line 20: | ||
* {{hl|"Analog"}} | * {{hl|"Analog"}} | ||
|p3= expression: | |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
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.
- 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
Notes
-
Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord.
Only post proven facts here! Add Note