ctrlSetFade: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(added extra helpful informative feature about using "fade = 1" inside a control's config.)
(Added informative note about very specific behavior related to this command. And changed other feature to warning. And changed my own note slightly.)
Line 19: Line 19:


|descr= Sets wanted transparency for control animation. Requires [[ctrlCommit]] to commit changes. To hide or show a control instantly, use [[ctrlShow]].
|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>
{{ Feature | Warning| Despite having <syntaxhighlight lang="cpp" inline>fade = 1;</syntaxhighlight> inside the config of a control, <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>
Which results in <sqf inline>ctrlSetFade 0</sqf> '''doing nothing'''.<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.}}
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.}}
{{ Feature | Informative | If there are multiple (interact-able) controls on top of each other but the top-most is faded using <sqf inline>ctrlSetFade 1</sqf>, the top-most control will interfere with controls that were defined earlier and in the exact same position. To counter that, the faded control '''needs to be disabled''' with [[ctrlEnable]].}}
|s1= controlName [[ctrlSetFade]] fade
|s1= controlName [[ctrlSetFade]] fade


Line 39: Line 40:
|user= Nelis.75733126
|user= Nelis.75733126
|timestamp= 20240416211007
|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.
|text=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:03, 22 May 2024

Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
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 the config of a control, ctrlFade will still report a fade of 0.

Which results in ctrlSetFade 0 doing nothing.

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.
ⓘ
If there are multiple (interact-able) controls on top of each other but the top-most is faded using ctrlSetFade 1, the top-most control will interfere with controls that were defined earlier and in the exact same position. To counter that, the faded control needs to be disabled with ctrlEnable.
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)
in Arma 3 2.17, when ctrlSetFade is used on a CtrlToolbox or RscToolbox, it only has effect on the text of it.
Retrieved from "https://community.bistudio.com/wiki?title=ctrlSetFade&oldid=364619"