actionKeys: Difference between revisions

Revision as of 01:36, 23 October 2021

1.00

1.50

1.00

0.50

Hover & click on the images for description

Description

Description:

Returns Array containing dikCodes of keys, buttons and combos assigned to the given user action. Action names could be found in config class ControllerSchemes or user action names or user profile, for example:

keyWatch[] = { 24 };

To retrieve the value, use the property name without 'key': actionKeys "Watch"; // 24

In addition, some of the actions are also listed in here: inputAction/actions

Groups:

Interaction

Syntax

Syntax:: actionKeys userAction
Parameters:: userAction: String
Return Value:: Array of Numbers

Examples

Example 1:: _array = actionKeys "ReloadMagazine"

Additional Information

See also:: actionKeysNames actionKeysNamesArray actionKeysImages actionName inputAction addUserActionEventHandler

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 May 11, 2016 - 02:36 (UTC)
AgentRev: If an action key is configured with a modifier (e.g. "Right Ctrl + M" for "MiniMapToggle"), the DIK code returned by this command has a weird value, equivalent to the following:
Left Ctrl + Key = 486539264 + DIK Left Shift + Key = 704643072 + DIK Left Alt + Key = 939524096 + DIK Right Ctrl + Key = -1660944384 + DIK Right Shift + Key = 905969664 + DIK Right Alt + Key = -1207959552 + DIK This increases the difficulty of accurately comparing key codes to actionKeys in UI event handlers. Those strange numbers are probably due to bit flags being added to the DIK value by the game engine for easier storage in the ArmaProfile.
In case of mouse buttons, actionKeys will also return values that are different from those in "MouseButton" UI events:
LMB: MouseButton 0 = actionKeys 65536 RMB: MouseButton 1 = actionKeys 65665 (65536 + 1 + 128) MMB: MouseButton 2 = actionKeys 65538 (65536 + 2) 4MB: MouseButton 3 = actionKeys 65539 (65536 + 3) 5MB: MouseButton 4 = actionKeys 65540 (65536 + 4) The values above are valid for a right-handed mouse configuration, and may or may not differ for a left-handed config.
Note edited by R3vo (talk) 13:04, 19 March 2021 (CET)

: Posted on August 6, 2016 - 12:24 (UTC)
Commy2: The values described by AgentRev cannot be compared reliably. All numbers in SQF are floats and those are only precise up to 7 digits.
486539264 + 19 == 486539264 + 20 // Returns true The DIK codes for LCtrl + R and LCtrl + T are indistinguishable.
Note edited by R3vo (talk) 13:04, 19 March 2021 (CET)

@@ Line 37: / Line 37: @@
 |x1= <code>_array = [[actionKeys]] "ReloadMagazine"</code>
-|seealso= [[actionKeysNames]], [[actionKeysNamesArray]], [[actionKeysImages]], [[actionName]], [[inputAction]]
+|seealso= [[actionKeysNames]], [[actionKeysNamesArray]], [[actionKeysImages]], [[actionName]], [[inputAction]], [[addUserActionEventHandler]]
 }}
@@ Line 53: / Line 53: @@
 Right Shift + Key = 905969664 + DIK
 Right Alt + Key = -1207959552 + DIK</code>
-This increases the difficulty of accurately comparing key codes to actionKeys in [[User_Interface_Event_Handlers|UI event handlers]]. Those strange numbers are probably due to bit flags being added to the DIK value by the game engine for easier storage in the ArmaProfile.<br>
+This increases the difficulty of accurately comparing key codes to actionKeys in [[User_Interface_Event_Handlers|UI event handlers]]. Those strange numbers are probably due to bit flags being added to the DIK value by the game engine for easier storage in the [[Profile|ArmaProfile]].<br>
 In case of mouse buttons, actionKeys will also return values that are different from those in "MouseButton" UI events:<br>
-<br>
 <code>LMB: MouseButton 0 = actionKeys 65536
 RMB: MouseButton 1 = actionKeys 65665 (65536 + 1 + 128)
@@ Line 69: / Line 68: @@
 <dt class="note">[[User:Commy2|Commy2]]</dt>
 <dd class="note">
-'''The method described by {{User|AgentRev}} does not work <u>reliably</u>.''' All numbers in SQF are floats and those are only precise up to 6...7 digits.<br>
+'''The values described by {{User|AgentRev}} cannot be compared <u>reliably</u>.''' All numbers in SQF are floats and those are only precise up to 7 digits.<br>
-<code>486539264 + 19 == 486539264 + 20{{cc|Returns [[true]]}}</code>
+<code>486539264 + 19 == 486539264 + 20 {{cc|Returns [[true]]}}</code>
 The DIK codes for <tt>LCtrl + R</tt> and <tt>LCtrl + T</tt> are indistinguishable.
 <br><small>''Note edited by [[User:R3vo|R3vo]] ([[User talk:R3vo|talk]]) 13:04, 19 March 2021 (CET)''</small>