ctrlSetFade: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
 
(added extra helpful informative feature about using "fade = 1" inside a control's config.)
(66 intermediate revisions by 16 users not shown)
Line 1: Line 1:
[[Category:Scripting Commands|CTRLSETFADE]]
{{RV|type=command
[[Category:Scripting Commands ArmA|CTRLSETFADE]]


|game1= arma1
|version1= 1.00


<h2 style="color:#000066">'''control '' ctrlSetFade ''fade'''''</h2>
|game2= arma2
|version2= 1.00


|game3= arma2oa
|version3= 1.50


'''Operand types:'''
|game4= tkoh
|version4= 1.00


'''control'''': [[Control]]
|game5= arma3
|version5= 0.50


'''fade''': [[Number]]
|gr1= GUI Control


'''Type of returned value:'''
|descr= Sets wanted transparency for control animation. Requires [[ctrlCommit]] to commit changes. To hide or show a control instantly, use [[ctrlShow]].
{{ Feature | Informative | Despite having <syntaxhighlight lang="cpp" inline>fade = 1;</syntaxhighlight> inside a control's config, <sqf inline>ctrlFade</sqf> will '''still report a fade of 0'''.<br>
Which results in <sqf inline>ctrlSetFade 0</sqf> '''doing nothing in that situation'''.<br>
To counter that, first use <sqf inline>ctrlSetFade 1</sqf>, then <sqf inline>ctrlCommit 0</sqf> ( to instantly apply it ), and then you can use [[ctrlSetFade]] to set the fade to any value you wish.}}
|s1= controlName [[ctrlSetFade]] fade


[[Nothing]]
|p1= controlName: [[Control]]


'''Compatibility:'''
|p2= fade: [[Number]]


Version 2.50 required.
|r1= [[Nothing]]


'''Description:'''
|x1= <sqf>_control ctrlSetFade 1;
_control ctrlCommit 5;</sqf>


Sets wanted transparency for control animation.
|seealso= [[ctrlFade]] [[cutFadeOut]] [[ctrlCommit]]
}}


'''Example''':
{{Note
   
|user= Nelis.75733126
_control '''ctrlSetFade''' 1
|timestamp= 20240416211007
|text= Unfortunately, in Arma 3 2.17, when <sqf inline>ctrlSetFade</sqf> is used on a CtrlToolbox or RscToolbox, it only has effect on the text of it.
}}

Revision as of 15:13, 21 April 2024

Hover & click on the images for description

Description

Description:
Sets wanted transparency for control animation. Requires ctrlCommit to commit changes. To hide or show a control instantly, use ctrlShow.
Despite having fade = 1; inside a control's config, ctrlFade will still report a fade of 0.

Which results in ctrlSetFade 0 doing nothing in that situation.

To counter that, first use ctrlSetFade 1, then ctrlCommit 0 ( to instantly apply it ), and then you can use ctrlSetFade to set the fade to any value you wish.
Groups:
GUI Control

Syntax

Syntax:
controlName ctrlSetFade fade
Parameters:
controlName: Control
fade: Number
Return Value:
Nothing

Examples

Example 1:
_control ctrlSetFade 1; _control ctrlCommit 5;

Additional Information

See also:
ctrlFade cutFadeOut ctrlCommit

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
Nelis.75733126 - c
Posted on Apr 16, 2024 - 21:10 (UTC)
Unfortunately, in Arma 3 2.17, when ctrlSetFade is used on a CtrlToolbox or RscToolbox, it only has effect on the text of it.