ctrlEnable: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " <!-- (DIS)?CONTINUE Notes -->" to "")
m (formatting)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| ofp
|game1= ofp


|
|version1= 1.75
 
|game2= ofpe
 
|version2= 1.00
 
|game3= arma1
 
|version3= 1.00
 
|game4= arma2
 
|version4= 1.00
 
|game5= arma2oa
 
|version5= 1.51
 
|game6= tkoh
 
|version6= 1.00
 
|game7= arma3
 
|version7= 0.50


|arg= local
|arg= local
Line 11: Line 35:
|gr1= GUI Control
|gr1= GUI Control


| Enable or disable a control of the currently active user dialog. Disabled controls cannot be clicked onto.
|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.


Read [[Arma: GUI Configuration]] for more information about user dialogs and controls.
|s1= '''ctrlEnable''' [idc, enable]


| '''ctrlEnable''' [idc, enable]
|p1= idc: [[Number]] - Control IDC


|p1= [idc, enable]: [[Array]]
|p2= enable: [[Boolean]] - [[true|True]] to enable the control, [[false]] to disable it


|p2= idc: [[Number]] - control ID
|r1 [[Nothing]]
 
|p3= enable: [[Boolean]] - true to enable the control, false to disable it
 
| [[Nothing]]


|s2= controlName '''ctrlEnable''' enable
|s2= controlName '''ctrlEnable''' enable
Line 39: Line 59:
|seealso= [[ctrlEnabled]]
|seealso= [[ctrlEnabled]]
}}
}}
{{GameCategory|arma1|Scripting Commands}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}


<dl class="command_description">
<dl class="command_description">
Line 56: Line 69:
</dd>
</dd>
</dl>
</dl>


<dl class="command_description">
<dl class="command_description">

Revision as of 18:45, 12 April 2021

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:
Return value needed

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
Posted on July 20, 2017 - 11:59 (UTC)
Yuval
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.
Posted on September 7, 2020 - 22:26 (UTC)
R3vo
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;"; }; };