ctrlEnable

1.751.001.001.001.501.000.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;";
	};
};