BIS fnc holdKey: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "<code>([^<]*)<nowiki>\[<\/nowiki>\[\[([a-zA-Z0-9_]+)\]\](.*)<\/code>" to "<code>$1$2$3</code>")
m (Some wiki formatting)
Line 10: Line 10:
|s1= [display, key, time, code, control] call [[BIS_fnc_holdKey]]
|s1= [display, key, time, code, control] call [[BIS_fnc_holdKey]]


|p1= display: [[Display]] - Display the event is attached to. By default it is the map display
|p1= display: [[Display]] - display the event is attached to. By default it is the map display


|p2= key: [[Number]] - What key to press. See [[DIK KeyCodes]]
|p2= key: [[Number]] - what key to press. See [[DIK KeyCodes]]


|p3= time: [[Number]] - How long the key has to be held down in seconds
|p3= time: [[Number]] - how long the key has to be held down in seconds


|p4= code: [[Code]] - Code to be executed when key is held down for long enough. [[canSuspend]] returns [[true]] inside the code
|p4= code: [[Code]] - code to be executed when key is held down for long enough. [[canSuspend]] returns [[true]] inside the code


|p5= control: [[Control]] - (Optional, default [[controlNull]] - Text control to be used in place of the default "Press X to skip" control.
|p5= control: [[Control]] - (Optional, default [[controlNull]] - Text control to be used in place of the default "Press X to skip" control.
Line 22: Line 22:
|r1= [[Nothing]]
|r1= [[Nothing]]


|x1= <code>findDisplay 46,36,5, {[[hint]] "Key 'J' pressed for 5 seconds"}] [[call]] [[BIS_fnc_holdKey]]; // Action is added to the mission display</code>
|x1= <sqf>[findDisplay 46, 36, 5, { hint "Key 'J' pressed for 5 seconds" }] call BIS_fnc_holdKey; // action is added to the mission display</sqf>


|seealso= [[BIS_fnc_holdActionAdd]] [[addAction]]
|seealso= [[BIS_fnc_holdActionAdd]] [[addAction]]
}}
}}

Revision as of 13:36, 13 July 2022

Hover & click on the images for description

Description

Description:
Function that executes a user-defined code when a key has been held down for a long enough time.
Execution:
call
Groups:
Interaction

Syntax

Syntax:
[display, key, time, code, control] call BIS_fnc_holdKey
Parameters:
display: Display - display the event is attached to. By default it is the map display
key: Number - what key to press. See DIK KeyCodes
time: Number - how long the key has to be held down in seconds
code: Code - code to be executed when key is held down for long enough. canSuspend returns true inside the code
control: Control - (Optional, default controlNull - Text control to be used in place of the default "Press X to skip" control.
Return Value:
Nothing

Examples

Example 1:
[findDisplay 46, 36, 5, { hint "Key 'J' pressed for 5 seconds" }] call BIS_fnc_holdKey; // action is added to the mission display

Additional Information

See also:
BIS_fnc_holdActionAdd addAction

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