showCommandingMenu: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\<dt class\=\"note\"\>\'\'\'\[\[(.*)\]\]\'\'\'" to "<dt class="note">$1")
m (Some wiki formatting)
(33 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma2 |Game name=
|game1= arma2
|version1= 1.00


|1.00|Game version=
|game2= arma2oa
____________________________________________________________________________________________
|version2= 1.50


| Create the commanding menu described by the given config class or menu name. When the name is empty, the current menu is hidden.<br><br>
|game3= tkoh
If commanding menu has "expression" set up, the expression will receive the following arguments when user activated the menu item:
|version3= 1.00
* Local variable  <tt>_target</tt>: [[Object]] - Target under the cursor. This works in both 3D and 2D (when cursor is over the unit icon on the map).
 
* Local variable <tt>_pos</tt>: [[Array]] - Cursor position.
|game4= arma3
* Local variable <tt>_is3D</tt>: [[Boolean]] - [[false]] if cursor is over the map, otherwise [[true]].  |DESCRIPTION=
|version4= 0.50
____________________________________________________________________________________________


| '''showCommandingMenu''' name |SYNTAX=
|gr1= Interaction


|p1= name: [[String]] - Class name or user menu name (with "#USER:" prefix and "_#" page number suffix, where # is the page number starting with 0). |PARAMETER1=
|descr= Create the commanding menu described by the given config class or menu name. When the name is empty, the current menu is hidden.<br><br>
If commanding menu has "expression" set up, the expression will receive the following arguments when user activated the menu item:
* Local variable  {{hl|_target}}: [[Object]] - Target under the cursor. This works in both 3D and 2D (when cursor is over the unit icon on the map).
* Local variable {{hl|_pos}}: [[Array]] - Cursor position.
* Local variable {{hl|_is3D}}: [[Boolean]] - [[false]] if cursor is over the map, otherwise [[true]].


| [[Nothing]] |RETURNVALUE=
|s1= [[showCommandingMenu]] name


|x1= <code>[[showCommandingMenu]] "";</code>|EXAMPLE1=
|p1= name: [[String]] - Class name or user menu name (with "#USER:" prefix and "_#" page number suffix, where # is the page number starting with 0).
|x2= <code>[[showCommandingMenu]] "MyClassName";</code>|EXAMPLE2=
|x3= <code>[[showCommandingMenu]] "#USER:Tag_Menu_myMenu_0";</code>|EXAMPLE3=
|x4= <code>[[showCommandingMenu]] "RscMainMenu";</code>|EXAMPLE4=


____________________________________________________________________________________________
|r1= [[Nothing]]


| [[commandingMenu]], [[Arma_3_Communication_Menu]], [[BIS_fnc_createmenu]] |SEEALSO=  
|x1= <sqf>showCommandingMenu "";</sqf>
|x2= <sqf>showCommandingMenu "MyClassName";</sqf>
|x3= <sqf>showCommandingMenu "#USER:Tag_Menu_myMenu_0";</sqf>
|x4= <sqf>showCommandingMenu "RscMainMenu";</sqf>


| |MPBEHAVIOUR=  
|seealso= [[commandingMenu]] [[Arma 3: Communication Menu]] [[BIS_fnc_createMenu]]
____________________________________________________________________________________________
}}
}}


<h3 style='display:none'>Notes</h3>
<dl class="command_description">
<dl class='command_description'>


<!-- Note Section BEGIN -->
<dt><dt>
 
<dd class="notedate">Posted on July 22nd, 2012 - 15:37 (GMT+1)</dd>
<dd class="notedate">Posted on July 22nd, 2012 - 15:37 (GMT+1)
<dt class="note">[[User:LaKing|LaKing]]</dt>
<dt class="note">[[User:LaKing|LaKing]]
<dd class="note">  
<dd class="note">  
<pre>
<sqf>
//This script will create a custom menu, and display it once.
// This script will create a custom menu, and display it once.


MY_SUBMENU_inCommunication =
MY_SUBMENU_inCommunication =
[
[
["User submenu",true],
["User submenu", true],
["Option-1", [2], "", -5, [["expression", "player sidechat ""-1"" "]], "0", "0", "\ca\ui\data\cursor_support_ca"],
["Option-1", [2], "", -5, [["expression", "player sidechat ""-1"" "]], "0", "0", "\ca\ui\data\cursor_support_ca"],
["Option 0", [3], "", -5, [["expression", "player sidechat "" 0"" "]], "1", "0", "\ca\ui\data\cursor_support_ca"],
["Option 0", [3], "", -5, [["expression", "player sidechat "" 0"" "]], "1", "0", "\ca\ui\data\cursor_support_ca"],
Line 55: Line 55:
[
[
// First array: "User menu" This will be displayed under the menu, bool value: has Input Focus or not.
// First array: "User menu" This will be displayed under the menu, bool value: has Input Focus or not.
// Note that as to version Arma2 1.05, if the bool value set to false, Custom Icons will not be displayed.
// Note that as to version Template:arma2 1.05, if the bool value set to false, Custom Icons will not be displayed.
["User menu",false],
["User menu", false],
 
// Syntax and semantics for following array elements:
// Syntax and semantics for following array elements:
// ["Title_in_menu", [assigned_key], "Submenu_name", CMD, [["expression",script-string]], "isVisible", "isActive" <, optional icon path> ]
// ["Title_in_menu", [assigned_key], "Submenu_name", CMD, [["expression",script-string]], "isVisible", "isActive" <, optional icon path> ]
Line 73: Line 74:


showCommandingMenu "#USER:MY_MENU_inCommunication";
showCommandingMenu "#USER:MY_MENU_inCommunication";
</sqf>


// Appendix, list of optional argument strings
Appendix, list of optional argument strings:
HasRadio
{{Columns|4|
CanAnswer
* AmmoLow
IsLeader
* AreActions
IsAlone
* CanAnswer
IsAloneInVehicle
* CanDeselectTeamFromBar
IsCommander
* CanDeselectUnitFromBar
VehicleCommander
* CanDeselectVehicleFromBar
CommandsToGunner
* CanSelectTeamFromBar
CommandsToPilot
* CanSelectUnitFromBar
NotEmpty
* CanSelectVehicleFromBar
NotEmptySoldiers
* CommandsToGunner
NotEmptyCommanders
* CommandsToPilot
NotEmptyMainTeam
* CursorOnEmptyVehicle
NotEmptyRedTeam
* CursorOnEnemy
NotEmptyGreenTeam
* CursorOnFriendly
NotEmptyBlueTeam
* CursorOnGround
NotEmptyYellowTeam
* CursorOnGroupMember
NotEmptySubgroups
* CursorOnGroupMemberSelected
NotEmptyInVehicle
* CursorOnHoldingFire
SelectedTeam
* CursorOnNeedFirstAID
SelectedUnit
* CursorOnNeedHeal
FuelLow
* CursorOnNotEmptySubgroups
AmmoLow
* CursorOnVehicleCanGetIn
Injured
* FormationDiamond
Multiplayer
* FormationLine
AreActions
* FuelLow
CursorOnGroupMember
* HasRadio
CursorOnHoldingFire
* HCCanDeselectTeamFromBar
CursorOnEmptyVehicle
* HCCanDeselectUnitFromBar
CursorOnVehicleCanGetIn
* HCCanSelectTeamFromBar
CursorOnFriendly
* HCCanSelectUnitFromBar
CursorOnEnemy
* HCCursorOnIcon
CursorOnGround
* HCCursorOnIconenemy
CanSelectUnitFromBar
* HCCursorOnIconSelectable
CanDeselectUnitFromBar
* HCCursorOnIconSelectableSelected
CanSelectVehicleFromBar
* HCIsLeader
CanDeselectVehicleFromBar
* HCNotEmpty
CanSelectTeamFromBar
* Injured
CanDeselectTeamFromBar
* IsAlone
FormationLine
* IsAloneInVehicle
FormationDiamond
* IsCommander
SomeSelectedHoldingFire
* IsLeader
PlayableLeader
* IsSelectedToAdd
PlayableSelected
* IsTeamSwitch
IsWatchCommanded
* IsWatchCommanded
IsSelectedToAdd
* IsXbox
HCIsLeader
* Multiplayer
HCCursorOnIcon
* NotEmpty
HCCursorOnIconSelectable
* NotEmptyBlueTeam
HCCanSelectUnitFromBar
* NotEmptyCommanders
HCCanDeselectUnitFromBar
* NotEmptyGreenTeam
HCCanSelectTeamFromBar
* NotEmptyInVehicle
HCCanDeselectTeamFromBar
* NotEmptyMainTeam
HCNotEmpty
* NotEmptyRedTeam
PlayerVehicleCanGetIn
* NotEmptySoldiers
IsXbox
* NotEmptySubgroups
IsTeamSwitch
* NotEmptyYellowTeam
CursorOnNotEmptySubgroups
* PlayableLeader
SomeSelectedHaveTarget
* PlayableSelected
CursorOnGroupMemberSelected
* PlayerOwnRadio
HCCursorOnIconSelectableSelected
* PlayerVehicleCanGetIn
HCCursorOnIconenemy
* SelectedTeam
PlayerOwnRadio
* SelectedUnit
CursorOnNeedFirstAID
* SomeSelectedHaveTarget
CursorOnNeedHeal
* SomeSelectedHoldingFire
 
* VehicleCommander
</pre>
}}
<!-- Note Section END -->
</dd>
</dl>


<h3 style='display:none'>Bottom Section</h3>
<dt></dt>
 
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on July 23, 2016 - 14:40 (UTC)</dd>
<dd class="notedate">Posted on July 23, 2016 - 14:40 (UTC)</dd>
<dt class="note">[[User:SilentSpike|SilentSpike]]</dt>
<dt class="note">[[User:SilentSpike|SilentSpike]]</dt>
Line 159: Line 152:
You can combine the argument strings (see the above note) together to create OR conditions.
You can combine the argument strings (see the above note) together to create OR conditions.


Hence <code>"HasRadioIsLeader"</code> is true when the unit is a leader or has a radio.
Hence {{hl|"HasRadioIsLeader"}} is true when the unit is a leader or has a radio.
</dd>
</dd>
</dl>
</dl>
<!-- DISCONTINUE Notes -->

Revision as of 16:22, 13 May 2022

Hover & click on the images for description

Description

Description:
Create the commanding menu described by the given config class or menu name. When the name is empty, the current menu is hidden.

If commanding menu has "expression" set up, the expression will receive the following arguments when user activated the menu item:
  • Local variable _target: Object - Target under the cursor. This works in both 3D and 2D (when cursor is over the unit icon on the map).
  • Local variable _pos: Array - Cursor position.
  • Local variable _is3D: Boolean - false if cursor is over the map, otherwise true.
Groups:
Interaction

Syntax

Syntax:
showCommandingMenu name
Parameters:
name: String - Class name or user menu name (with "#USER:" prefix and "_#" page number suffix, where # is the page number starting with 0).
Return Value:
Nothing

Examples

Example 1:
showCommandingMenu "";
Example 2:
showCommandingMenu "MyClassName";
Example 3:
showCommandingMenu "#USER:Tag_Menu_myMenu_0";
Example 4:
showCommandingMenu "RscMainMenu";

Additional Information

See also:
commandingMenu Arma 3: Communication Menu BIS_fnc_createMenu

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
Posted on July 22nd, 2012 - 15:37 (GMT+1)
LaKing
// This script will create a custom menu, and display it once. MY_SUBMENU_inCommunication = [ ["User submenu", true], ["Option-1", [2], "", -5, [["expression", "player sidechat ""-1"" "]], "0", "0", "\ca\ui\data\cursor_support_ca"], ["Option 0", [3], "", -5, [["expression", "player sidechat "" 0"" "]], "1", "0", "\ca\ui\data\cursor_support_ca"], ["Option 1", [4], "", -5, [["expression", "player sidechat "" 1"" "]], "1", "CursorOnGround", "\ca\ui\data\cursor_support_ca"] ]; MY_MENU_inCommunication = [ // First array: "User menu" This will be displayed under the menu, bool value: has Input Focus or not. // Note that as to version Template:arma2 1.05, if the bool value set to false, Custom Icons will not be displayed. ["User menu", false], // Syntax and semantics for following array elements: // ["Title_in_menu", [assigned_key], "Submenu_name", CMD, "expression",script-string, "isVisible", "isActive" <, optional icon path> ] // Title_in_menu: string that will be displayed for the player // Assigned_key: 0 - no key, 1 - escape key, 2 - key-1, 3 - key-2, ... , 10 - key-9, 11 - key-0, 12 and up... the whole keyboard // Submenu_name: User menu name string (eg "#USER:MY_SUBMENU_NAME" ), "" for script to execute. // CMD: (for main menu:) CMD_SEPARATOR -1; CMD_NOTHING -2; CMD_HIDE_MENU -3; CMD_BACK -4; (for custom menu:) CMD_EXECUTE -5 // script-string: command to be executed on activation. (no arguments passed) // isVisible - Boolean 1 or 0 for yes or no, - or optional argument string, eg: "CursorOnGround" // isActive - Boolean 1 or 0 for yes or no - if item is not active, it appears gray. // optional icon path: The path to the texture of the cursor, that should be used on this menuitem. ["First", [0], "", -5, [["expression", "player sidechat ""First"" "]], "1", "1"], ["Second", [2], "", -5, [["expression", "player sidechat ""Second"" "]], "1", "1"], ["Submenu", [3], "#USER:MY_SUBMENU_inCommunication", -5, [["expression", "player sidechat ""Submenu"" "]], "1", "1"] ]; showCommandingMenu "#USER:MY_MENU_inCommunication";
Appendix, list of optional argument strings:
  • AmmoLow
  • AreActions
  • CanAnswer
  • CanDeselectTeamFromBar
  • CanDeselectUnitFromBar
  • CanDeselectVehicleFromBar
  • CanSelectTeamFromBar
  • CanSelectUnitFromBar
  • CanSelectVehicleFromBar
  • CommandsToGunner
  • CommandsToPilot
  • CursorOnEmptyVehicle
  • CursorOnEnemy
  • CursorOnFriendly
  • CursorOnGround
  • CursorOnGroupMember
  • CursorOnGroupMemberSelected
  • CursorOnHoldingFire
  • CursorOnNeedFirstAID
  • CursorOnNeedHeal
  • CursorOnNotEmptySubgroups
  • CursorOnVehicleCanGetIn
  • FormationDiamond
  • FormationLine
  • FuelLow
  • HasRadio
  • HCCanDeselectTeamFromBar
  • HCCanDeselectUnitFromBar
  • HCCanSelectTeamFromBar
  • HCCanSelectUnitFromBar
  • HCCursorOnIcon
  • HCCursorOnIconenemy
  • HCCursorOnIconSelectable
  • HCCursorOnIconSelectableSelected
  • HCIsLeader
  • HCNotEmpty
  • Injured
  • IsAlone
  • IsAloneInVehicle
  • IsCommander
  • IsLeader
  • IsSelectedToAdd
  • IsTeamSwitch
  • IsWatchCommanded
  • IsXbox
  • Multiplayer
  • NotEmpty
  • NotEmptyBlueTeam
  • NotEmptyCommanders
  • NotEmptyGreenTeam
  • NotEmptyInVehicle
  • NotEmptyMainTeam
  • NotEmptyRedTeam
  • NotEmptySoldiers
  • NotEmptySubgroups
  • NotEmptyYellowTeam
  • PlayableLeader
  • PlayableSelected
  • PlayerOwnRadio
  • PlayerVehicleCanGetIn
  • SelectedTeam
  • SelectedUnit
  • SomeSelectedHaveTarget
  • SomeSelectedHoldingFire
  • VehicleCommander
Posted on July 23, 2016 - 14:40 (UTC)
SilentSpike
You can combine the argument strings (see the above note) together to create OR conditions. Hence "HasRadioIsLeader" is true when the unit is a leader or has a radio.