BIS fnc addCommMenuItem: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (Some wiki formatting)
 
(44 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Function|= Comments
{{RV|type=function
____________________________________________________________________________________________


| arma3 |= Game name
|game1= arma3
|version1= 0.50


|0.50|= Game version
|eff= local
|arg= local


|eff= local |=
|gr1= Communication Menu
____________________________________________________________________________________________


| Add [[Arma_3_Communication_Menu|communication menu]] to the given unit.
|descr= Add [[Arma 3: Communication Menu|communication menu]] to the given unit.


The item will be available in the Communication menu and visualized in comm menu icon area.|= Description
The item will be available in the Communication menu and visualized in comm menu icon area.
____________________________________________________________________________________________


| [owner,itemClass] call [[BIS_fnc_addCommMenuItem]]; |= Syntax
|s1= [owner, itemClass, textArguments, expressionArguments, notification] call [[BIS_fnc_addCommMenuItem]]


|p1= '''owner''': [[Object]] - object to which the item belongs to |=
|p1= '''owner''': [[Object]] - object to which the item belongs to
|p2= '''itemClass''': [[String]] - CfgCommunicationMenu class |=


| [[Number]] - item ID, used in [[BIS_fnc_removeCommMenuItem]] |= Return value
|p2= '''itemClass''': [[String]] - {{hl|CfgCommunicationMenu}} class
____________________________________________________________________________________________
 
|x1= <code>_supportHeli = <nowiki>[</nowiki>[[player]],"Support_Request_CAS_Heli"] [[call]] [[BIS_fnc_addCommMenuItem]];</code> |=
____________________________________________________________________________________________


| [[BIS_fnc_removeCommMenuItem]], [[Arma 3 Communication_Menu]] |= See also
|p3= '''textArguments''': [[Anything]] - (Optional) additional info to display in the {{hl|text}} attribute. {{hl|%1}} will be replaced by the first array element, {{hl|%2}} with the second and so on.


}}
|p4= '''expressionArguments''': [[Anything]] - (Optional) similar to '''textArguments''', just this time in the {{hl|expression}} attribute.


<h3 style="display:none">Notes</h3>
|p5= '''notification''': [[String]] - (Optional) notification class from {{hl|CfgNotifications}}. Empty string will disabled the notification.
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|r1= [[Number]] - item ID, used in [[BIS_fnc_removeCommMenuItem]]
</dl>


<h3 style="display:none">Bottom Section</h3>
|x1= <sqf>
private _supportHeli = [player,"Support_Request_CAS_Heli"] call BIS_fnc_addCommMenuItem;
_supportHeli = [player,"Support_Request_CAS_Heli",nil,nil,""] call BIS_fnc_addCommMenuItem; // don't show notification
</sqf>


[[Category:Arma 3:_Functions|addCommMenuItem]]
|seealso= [[BIS_fnc_removeCommMenuItem]] [[Arma 3: Communication Menu]]
}}

Latest revision as of 13:26, 27 July 2022

Hover & click on the images for description

Description

Description:
Add communication menu to the given unit. The item will be available in the Communication menu and visualized in comm menu icon area.
Execution:
call
Groups:
Communication Menu

Syntax

Syntax:
[owner, itemClass, textArguments, expressionArguments, notification] call BIS_fnc_addCommMenuItem
Parameters:
owner: Object - object to which the item belongs to
itemClass: String - CfgCommunicationMenu class
textArguments: Anything - (Optional) additional info to display in the text attribute. %1 will be replaced by the first array element, %2 with the second and so on.
expressionArguments: Anything - (Optional) similar to textArguments, just this time in the expression attribute.
notification: String - (Optional) notification class from CfgNotifications. Empty string will disabled the notification.
Return Value:
Number - item ID, used in BIS_fnc_removeCommMenuItem

Examples

Example 1:
private _supportHeli = [player,"Support_Request_CAS_Heli"] call BIS_fnc_addCommMenuItem; _supportHeli = [player,"Support_Request_CAS_Heli",nil,nil,""] call BIS_fnc_addCommMenuItem; // don't show notification

Additional Information

See also:
BIS_fnc_removeCommMenuItem Arma 3: Communication Menu

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