onGroupIconClick: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " " to " ")
m (Some wiki formatting)
 
(44 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma2
|game1= arma2
|version1= 1.00


|1.00
|game2= arma2oa
|version2= 1.50
 
|game3= tkoh
|version3= 1.00
 
|game4= arma3
|version4= 0.50


|gr1= High Command
|gr1= High Command
Line 9: Line 17:
|gr2= Event Handlers
|gr2= Event Handlers


| Defines an action performed when player clicked on group marker (3D or in a map). The code executed once. This EH, unlike [[onGroupIconOverEnter]] and [[onGroupIconOverLeave]], has one more param which returns 1 if RMB was pressed, 0 otherwise. <br><br>
|descr= Defines an action performed when player clicked on group marker (3D or in a map). The code executed once.
{{Informative|Since '''Arma 3''' ''v1.57'' a stackable version of this EH is available: [[Arma_3:_Event_Handlers/addMissionEventHandler#GroupIconClick|GroupIconClick]]}}
This EH, unlike [[onGroupIconOverEnter]] and [[onGroupIconOverLeave]], has one more param which returns 1 if RMB was pressed, 0 otherwise.
{{Feature|arma3|Since {{arma3}} v1.58 a [[Arma 3: Mission Event Handlers#GroupIconClick|Mission Event Handler]] exists and should be used.}}


| '''onGroupIconClick''' command
|s1= [[onGroupIconClick]] command


|p1= command: [[String]] or [[Code]] - script
|p1= command: [[String]] or [[Code]] - script


|p2=
|r1= [[Nothing]]


|p3=
|x1= <sqf>
onGroupIconClick
{
// passed values for _this are:
params ["_is3D", "_group", "_wpID", "_posX", "_posY", "_shift", "_ctrl", "_alt"];


| [[Nothing]]
// before Arma 3
_is3D = _this select 0;
_group = _this select 1;
_wpID = _this select 2;
_RMB = _this select 3;
_posx = _this select 4;
_posy = _this select 5;
_shift = _this select 6;
_ctrl = _this select 7;
_alt = _this select 8;


|x1= <code>[[onGroupIconClick]]
_message = format ["____ Info ____"];
{
{_message = _message + format ["\n %1", _x]} forEach _this;
    // Passed values for _this are:
hint _message;
    _is3D = _this [[select]] 0;
};
    _group = _this [[select]] 1;
</sqf>
    _wpID = _this [[select]] 2;
    _RMB = _this [[select]] 3;
    _posx = _this [[select]] 4;
    _posy = _this [[select]] 5;
    _shift = _this [[select]] 6;
    _ctrl = _this [[select]] 7;
    _alt = _this [[select]] 8;


    _message = [[format]] ["____ Info ____"];
|seealso= [[addGroupIcon]] [[clearGroupIcons]] [[getGroupIcon]] [[getGroupIconParams]] [[groupIconSelectable]] [[groupIconsVisible]] [[removeGroupIcon]] [[setGroupIcon]] [[setGroupIconParams]] [[setGroupIconsSelectable]] [[setGroupIconsVisible]] [[onGroupIconOverEnter]] [[onGroupIconOverLeave]]
    {_message = _message + [[format]] ["\n %1",_x]} [[forEach]] _this;
    [[hint]] _message;
}</code>
 
| [[addGroupIcon]], [[clearGroupIcons]], [[getGroupIcon]], [[getGroupIconParams]], [[groupIconSelectable]], [[groupIconsVisible]], [[removeGroupIcon]], [[setGroupIcon]], [[setGroupIconParams]], [[setGroupIconsSelectable]], [[setGroupIconsVisible]], [[onGroupIconOverEnter]], [[onGroupIconOverLeave]]
}}
}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 19:19, 13 May 2022

Hover & click on the images for description

Description

Description:
Defines an action performed when player clicked on group marker (3D or in a map). The code executed once. This EH, unlike onGroupIconOverEnter and onGroupIconOverLeave, has one more param which returns 1 if RMB was pressed, 0 otherwise.
Arma 3
Since Arma 3 v1.58 a Mission Event Handler exists and should be used.
Groups:
High CommandEvent Handlers

Syntax

Syntax:
onGroupIconClick command
Parameters:
command: String or Code - script
Return Value:
Nothing

Examples

Example 1:
onGroupIconClick { // passed values for _this are: params ["_is3D", "_group", "_wpID", "_posX", "_posY", "_shift", "_ctrl", "_alt"]; // before Arma 3 _is3D = _this select 0; _group = _this select 1; _wpID = _this select 2; _RMB = _this select 3; _posx = _this select 4; _posy = _this select 5; _shift = _this select 6; _ctrl = _this select 7; _alt = _this select 8; _message = format ["____ Info ____"]; {_message = _message + format ["\n %1", _x]} forEach _this; hint _message; };

Additional Information

See also:
addGroupIcon clearGroupIcons getGroupIcon getGroupIconParams groupIconSelectable groupIconsVisible removeGroupIcon setGroupIcon setGroupIconParams setGroupIconsSelectable setGroupIconsVisible onGroupIconOverEnter onGroupIconOverLeave

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