ctrlEnable: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "|Game version=" to "|Game version= |gr1= GUI Control |GROUP1= ")
m (Text replacement - "\] +\[" to "] [")
 
(42 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| ofp |Game name=
|game1= ofp
|version1= 1.75


|1.5|Game version=
|game2= ofpe
|version2= 1.00


|gr1= GUI Control |GROUP1=
|game3= arma1
|version3= 1.00


|game4= arma2
|version4= 1.00


|game5= arma2oa
|version5= 1.50


|arg= local |Multiplayer Arguments=
|game6= tkoh
|version6= 1.00


|eff= local |Multiplayer Effects=
|game7= arma3
|version7= 0.50


|gr1= GUI Control |=GROUP1
|arg= local
____________________________________________________________________________________________


| Enable or disable a control of the currently active user dialog. Disabled controls cannot be clicked onto.
|eff= local


Read [[Arma: GUI Configuration]] for more information about user dialogs and controls. |DESCRIPTION=
|gr1= GUI Control
____________________________________________________________________________________________


| '''ctrlEnable''' [idc, enable] |SYNTAX=
|descr= Enables or disables a control of the currently active user dialog.
Disabled controls cannot be clicked onto.
Read [[Arma: GUI Configuration]] for more information about user dialogs and controls.


|p1= [idc, enable]: [[Array]] |PARAMETER1=
|s1= [[ctrlEnable]] [idc, enable]


|p2= idc: [[Number]] - control ID |PARAMETER2=
|p1= idc: [[Number]] - control IDC


|p3= enable: [[Boolean]] - true to enable the control, false to disable it |PARAMETER3=
|p2= enable: [[Boolean]] - [[true]] to enable the control, [[false]] to disable it


| [[Nothing]] |RETURNVALUE=
|r1= [[Nothing]]
____________________________________________________________________________________________


|s2= controlName '''ctrlEnable''' enable |Alternative Syntax=
|s2= controlName [[ctrlEnable]] enable


|p21= controlName: [[Control]] |PARAMETER21=
|p21= controlName: [[Control]]


|p22= enable: [[Boolean]] |PARAMETER2=
|p22= enable: [[Boolean]]


|r2= [[Nothing]] |RETURNVALUE2=
|r2= [[Nothing]]
____________________________________________________________________________________________
 
|x1= <code>[[ctrlEnable]] [100, [[false]]]</code> |EXAMPLE1=


|x2= <code>_ctrl [[ctrlEnable]] [[false]]</code> |EXAMPLE2=
|x1= <sqf>ctrlEnable [100, false];</sqf>


____________________________________________________________________________________________
|x2= <sqf>_ctrl ctrlEnable false;</sqf>
 
| [[ctrlEnabled]] |SEEALSO=


|seealso= [[ctrlEnabled]]
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= Yuval
<!-- Note Section BEGIN -->
|timestamp= 20170720115900
 
|text= Please do note that enabled controls can gain focus upon click. Therefore do not enable background controls or else they will cover any controls on top of them.<br>
<!-- Note Section END -->
</dl>
 
<h3 style="display:none">Bottom Section</h3>
 
[[Category:Scripting Commands|CTRLENABLE]]
[[Category:Scripting Commands OFP 1.99|CTRLENABLE]]
[[Category:Scripting Commands OFP 1.96|CTRLENABLE]]
[[Category:Scripting Commands Armed Assault|CTRLENABLE]]
[[Category:Command_Group:_GUI_Control|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on July 20, 2017 - 11:59 (UTC)</dd>
<dt class="note">[[User:Yuval|Yuval]]</dt>
<dd class="note">
Please do note that enabled controls can gain focus upon click. Therefore do not enable background controls or else they will cover any controls on top of them.<br>
As a general rule of thumb, enabled controls should only be already on the top of the GUI.
As a general rule of thumb, enabled controls should only be already on the top of the GUI.
</dd>
}}
</dl>
<!-- DISCONTINUE Notes -->


 
{{Note
 
|user= R3vo
<!-- CONTINUE Notes -->
|timestamp= 20200907222600
<dl class="command_description">
|text= One can disable a control when it is loaded by using [[ctrlEnable]] in the [[User_Interface_Event_Handlers#onLoad|onLoad]] event handler.
<dd class="notedate">Posted on September 7, 2020 - 22:26 (UTC)</dd>
<syntaxhighlight lang="cpp">
<dt class="note">[[User:R3vo|R3vo]]</dt>
class MyDialog
<dd class="note">
One can disable a control when it is loaded by using [[ctrlEnable]] in the [[User_Interface_Event_Handlers#onLoad|onLoad]] event handler.
 
<code>class MyDialog
{
{
    class MyControl
class MyControl
    {
{
        [[User_Interface_Event_Handlers#onLoad|onLoad]] = "([[_this]] [[#]] 0) [[ctrlEnable]] [[false]];";
onLoad = "(_this # 0) ctrlEnable false;";
    };
};
};</code>
};
 
</syntaxhighlight>
</dd>
}}
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 11:46, 5 May 2024

Logo A0.png1.75ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
LALocalLELocal
Hover & click on the images for description

Description

Description:
Enables or disables a control of the currently active user dialog. Disabled controls cannot be clicked onto. Read Arma: GUI Configuration for more information about user dialogs and controls.
Groups:
GUI Control

Syntax

Syntax:
ctrlEnable [idc, enable]
Parameters:
idc: Number - control IDC
enable: Boolean - true to enable the control, false to disable it
Return Value:
Nothing

Alternative Syntax

Syntax:
controlName ctrlEnable enable
Parameters:
controlName: Control
enable: Boolean
Return Value:
Nothing

Examples

Example 1:
ctrlEnable [100, false];
Example 2:
_ctrl ctrlEnable false;

Additional Information

See also:
ctrlEnabled

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
Yuval - c
Posted on Jul 20, 2017 - 11:59 (UTC)
Please do note that enabled controls can gain focus upon click. Therefore do not enable background controls or else they will cover any controls on top of them.
As a general rule of thumb, enabled controls should only be already on the top of the GUI.
R3vo - c
Posted on Sep 07, 2020 - 22:26 (UTC)
One can disable a control when it is loaded by using ctrlEnable in the onLoad event handler. 
class MyDialog
{
	class MyControl
	{
		onLoad = "(_this # 0) ctrlEnable false;";
	};
};
Retrieved from "https://community.bistudio.com/wiki?title=ctrlEnable&oldid=364166"