BIS fnc callScriptedEventHandler: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
(format)
Line 8: Line 8:
____________________________________________________________________________________________
____________________________________________________________________________________________


| <pre>/*
| Calls all the codes assigned to scripted event handler with given name. Since Arma 3 v1.67 the code receives current EH id in the special variable: <tt>_thisScriptedEventHandler</tt>|= Description
____________________________________________________________________________________________


Description:
|  [namespace, name, arguments, returnResults] call [[BIS_fnc_callScriptedEventHandler]] |= Syntax
Call scripted event handlers


Parameter(s):
|p1= namespace: [[Namespace]], [[Object]], [[Group]], [[Location]], [[Boolean]], [[Control]] or [[Display]] - namespace in which handler is saved|=
0: NAMESPACE, OBJECT, GROUP or LOCATION - namespace in which handler is saved
|p2= name: [[String]] - handler name|=
1: STRING - handler name
|p3= arguments: [[Array]] - array of arguments passed to he EH code |=
2: ARRAY - arguments passed to the 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]] |=
3 (Optional): BOOL - true to expect returned value from all codes


Returns:
| [[Array]] - array with EH results or empty array|= Return value
ARRAY - list of returned values
*/
</pre><small>''(Placeholder description extracted from the function header by [[BIS_fnc_exportFunctionsToWiki]])''</small> |= Description
____________________________________________________________________________________________
____________________________________________________________________________________________


| <!-- [] call [[BIS_fnc_callScriptedEventHandler]]; --> |= Syntax


|p1= |= Parameter 1
|x1= <code><nowiki>[</nowiki>[[missionNamespace]], "event", <nowiki>[</nowiki>[[player]], 123]] [[call]] [[BIS_fnc_callScriptedEventHandler]]; </code> |=  
 
| |= Return value
____________________________________________________________________________________________
____________________________________________________________________________________________
 
| [[BIS_fnc_addScriptedEventHandler]], [[BIS_fnc_removeScriptedEventHandler]], [[BIS_fnc_removeAllScriptedEventHandlers]] |= See also
|x1= <code></code> |=
____________________________________________________________________________________________
 
| [[BIS_fnc_addScriptedEventHandler]] |= See also


}}
}}
Line 50: Line 39:
[[Category:Functions|{{uc:callScriptedEventHandler}}]]
[[Category:Functions|{{uc:callScriptedEventHandler}}]]
[[Category:{{Name|arma3}}: Functions|{{uc:callScriptedEventHandler}}]]
[[Category:{{Name|arma3}}: Functions|{{uc:callScriptedEventHandler}}]]
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on May 15, 2016 - 19:29 (UTC)</dd>
<dt class="note">[[User:RageBone|RageBone]]</dt>
<dd class="note">
Example:<br>
<code>
[missionNamespace,"event",[]] call bis_fnc_callScriptedEventHandler;
</code><br>
Interestingly, the return value is always an empty array.<br>
</dd>
</dl>
<!-- DISCONTINUE Notes -->

Revision as of 19:41, 12 December 2016


Hover & click on the images for description

Description

Description:
Calls all the codes assigned to scripted event handler with given name. Since Arma 3 v1.67 the code receives current EH id in the special variable: _thisScriptedEventHandler
Execution:
call
Groups:
Uncategorised

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 he EH code
returnResults (Optional): Boolean - if true EH will place results from each code execution into an array using EH id as index. Default: false
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_addScriptedEventHandlerBIS_fnc_removeScriptedEventHandlerBIS_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

Notes

Bottom Section