actionParams: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (template:command argument fix)
m (template:command argument fix)
Line 27: Line 27:
| entity [[actionParams]] id |SYNTAX=
| entity [[actionParams]] id |SYNTAX=


|p1= entity: [[Object]] - entity with added user actions |= Parameter 1
|p1= entity: [[Object]] - entity with added user actions |PARAMETER1=
|p2= id: [[Number]] - id of existing user action (returned by [[addAction]] or [[actionIDs]]) |= Parameter 2
|p2= id: [[Number]] - id of existing user action (returned by [[addAction]] or [[actionIDs]]) |PARAMETER2=


| [[Array]] or [[Nothing]] - Array of action params or [[nil]] if doesn't exist |RETURNVALUE=
| [[Array]] or [[Nothing]] - Array of action params or [[nil]] if doesn't exist |RETURNVALUE=
____________________________________________________________________________________________
____________________________________________________________________________________________
|x1= <code>_params = [[player]] [[actionParams]] 0;</code> |= Example 1
|x1= <code>_params = [[player]] [[actionParams]] 0;</code> |EXAMPLE1=
____________________________________________________________________________________________
____________________________________________________________________________________________
| [[actionIDs]], [[addAction]], [[setUserActionText]], [[inGameUISetEventHandler]], [[showHUD]], [[inputAction]], [[removeAction]], [[removeAllActions]], [[action]] |SEEALSO=
| [[actionIDs]], [[addAction]], [[setUserActionText]], [[inGameUISetEventHandler]], [[showHUD]], [[inputAction]], [[removeAction]], [[removeAllActions]], [[action]] |SEEALSO=

Revision as of 15:27, 7 April 2019

Hover & click on the images for description

Description

Description:
Returns Array with params for given user action id (similar to addAction param array). The output array is of the following format: [title, script, arguments, priority, showWindow, hideOnUse, shortcut, condition, radius, unconscious, textWindowBackground, textWindowForeground, selection], where:
  • title: String - action title text
  • script: String - script file or script expression assigned to the action
  • arguments: Anything or nil - arguments passed to the action
  • priority: Number - action priority on the action menu
  • showWindow: Boolean - whether the action is shown in the center of the screen too
  • hideOnUse: Boolean - whether the action menu should close after selecting the action
  • shortcut: String - action bindings to some existing engine action if any
  • condition: String - expression returning true or nil for action to appear on the action menu
  • radius: Number - max distance to entity at which action becomes available. -1 means it is engine default (~15m)
  • unconscious: Boolean - whether the action is available to unconscious person
  • textWindowBackground: String - same as textWindowBackground in setUserActionText
  • textWindowForeground: String - same as textWindowForeground in setUserActionText
  • selection: String - named selection in Geometry LOD to which the action is attached
New array element selection is available since Arma 3 v1.69.140846
Groups:
Uncategorised

Syntax

Syntax:
entity actionParams id
Parameters:
entity: Object - entity with added user actions
id: Number - id of existing user action (returned by addAction or actionIDs)
Return Value:
Array or Nothing - Array of action params or nil if doesn't exist

Examples

Example 1:
_params = player actionParams 0;

Additional Information

See also:
actionIDsaddActionsetUserActionTextinGameUISetEventHandlershowHUDinputActionremoveActionremoveAllActionsaction

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

Notes

Bottom Section