BIS fnc addCommMenuItem: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " \| *(\[[^ ]+\] (call|spawn) ('''|\[\[)BI(N|S)_fnc_[a-zA-Z0-9_]+('''|\]\]));? \| *p1 *=" to " |s1=$1 |p1=")
m (Some wiki formatting)
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{RV|type=function
{{RV|type=function


| arma3
|game1= arma3
 
|version1= 0.50
|0.50


|eff= local
|eff= local
Line 10: Line 9:
|gr1= Communication Menu
|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.
The item will be available in the Communication menu and visualized in comm menu icon area.


|s1=[owner,itemClass,textArguments,expressionArguments,notification] call [[BIS_fnc_addCommMenuItem]]
|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


|p3= '''textArguments''' (Optional): [[Anything]] - Additional info to display in the {{ic|text}} attribute. {{ic|%1}} will be replaced by the first array element, {{ic|%2}} with the second and so on.
|p2= '''itemClass''': [[String]] - {{hl|CfgCommunicationMenu}} class
 
|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''' (Optional): [[Anything]] - Similar to '''textArguments''', just this time in the {{ic|expression}} attribute.
|p4= '''expressionArguments''': [[Anything]] - (Optional) similar to '''textArguments''', just this time in the {{hl|expression}} attribute.


|p5= '''notification''' (Optional): [[String]] - notification class from CfgNotifications. Empty string will disabled the notification.
|p5= '''notification''': [[String]] - (Optional) notification class from {{hl|CfgNotifications}}. Empty string will disabled the notification.


|r1=[[Number]] - item ID, used in [[BIS_fnc_removeCommMenuItem]]
|r1= [[Number]] - item ID, used in [[BIS_fnc_removeCommMenuItem]]


|x1= <code>_supportHeli = [<nowiki/>[[player]],"Support_Request_CAS_Heli"] [[call]] [[BIS_fnc_addCommMenuItem]];
|x1= <sqf>
_supportHeli = [<nowiki/>[[player]],"Support_Request_CAS_Heli",nil,nil,""] [[call]] [[BIS_fnc_addCommMenuItem]]; {{codecomment|// don't show notification}}</code>
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>


|seealso= [[BIS_fnc_removeCommMenuItem]], [[Arma 3: Communication Menu]]
|seealso= [[BIS_fnc_removeCommMenuItem]] [[Arma 3: Communication Menu]]
}}
}}

Latest revision as of 14: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