BIS fnc callScriptedEventHandler: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " |r1=[[" to " |r1= [[")
m (Some wiki formatting)
 
(5 intermediate revisions by the same user not shown)
Line 6: Line 6:
|gr1= Event Handlers
|gr1= Event Handlers


|descr= Calls all the codes assigned to scripted event handler with given name. Since {{GVI|arma3|1.68}} the code receives current EH id in the special variable: <tt>_thisScriptedEventHandler</tt>
|descr= Calls all the codes assigned to scripted event handler with given name. Since {{GVI|arma3|1.68}} the code receives current EH id in the special variable: {{hl|_thisScriptedEventHandler}}


|s1=[namespace, name, arguments, returnResults] call [[BIS_fnc_callScriptedEventHandler]]
|s1= [namespace, name, arguments, returnResults] call [[BIS_fnc_callScriptedEventHandler]]


|p1= namespace: [[Namespace]], [[Object]], [[Group]], [[Location]], [[Boolean]], [[Control]] or [[Display]] - namespace in which handler is saved
|p1= namespace: [[Namespace]], [[Object]], [[Group]], [[Location]], [[Boolean]], [[Control]] or [[Display]] - namespace in which handler is saved
Line 16: Line 16:
|p3= arguments: [[Array]] - array of arguments passed to the EH code
|p3= arguments: [[Array]] - array of arguments passed to the EH code


|p4= returnResults (Optional): [[Boolean]] - if [[true]] EH will place results from each code execution into an array using EH id as index. Default: [[false]]
|p4= returnResults: [[Boolean]] - (Optional, default [[false]]) if [[true]] EH will place results from each code execution into an array using EH id as index


|r1= [[Array]] - array with EH results or empty array
|r1= [[Array]] - array with EH results or empty array


|x1= <code><nowiki>[</nowiki>[[missionNamespace]], "event", [<nowiki/>[[player]], 123]] [[call]] [[BIS_fnc_callScriptedEventHandler]];</code>
|x1= <sqf>[missionNamespace, "event", [player, 123]] call BIS_fnc_callScriptedEventHandler;</sqf>
|seealso= [[BIS_fnc_addScriptedEventHandler]], [[BIS_fnc_removeScriptedEventHandler]], [[BIS_fnc_removeAllScriptedEventHandlers]]
 
|seealso= [[BIS_fnc_addScriptedEventHandler]] [[BIS_fnc_removeScriptedEventHandler]] [[BIS_fnc_removeAllScriptedEventHandlers]]
}}
}}

Latest revision as of 14:24, 13 July 2022

Hover & click on the images for description

Description

Description:
Calls all the codes assigned to scripted event handler with given name. Since Arma 3 logo black.png1.68 the code receives current EH id in the special variable: _thisScriptedEventHandler
Execution:
call
Groups:
Event Handlers

Syntax

Syntax:
[namespace, name, arguments, returnResults] call BIS_fnc_callScriptedEventHandler
Parameters:
namespace: Namespace, Object, Group, Location, Boolean, Control or Display - namespace in which handler is saved
name: String - handler name
arguments: Array - array of arguments passed to the EH code
returnResults: Boolean - (Optional, default false) if true EH will place results from each code execution into an array using EH id as index
Return Value:
Array - array with EH results or empty array

Examples

Example 1:
[missionNamespace, "event", [player, 123]] call BIS_fnc_callScriptedEventHandler;

Additional Information

See also:
BIS_fnc_addScriptedEventHandler BIS_fnc_removeScriptedEventHandler BIS_fnc_removeAllScriptedEventHandlers

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