Version: 2017.3 (switch to 2017.4)
LanguageEnglish
  • C#
  • JS

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

EditorGUI.BeginDisabledGroup

public static void BeginDisabledGroup(bool disabled);

Parameters

disabled Boolean specifying if the controls inside the group should be disabled.

Description

Create a group of controls that can be disabled.

If disabled is true, the controls inside the group will be disabled. If false, the enabled/disabled state will not be changed.

Note: The use of EditorGUI.DisabledScope is usually preferred over EditorGUI.BeginDisabledGroup()/EditorGUI.EndDisabledGroup(), as it provides a safer, scoped mechanism. Please refer to the EditorGUI.DisabledScope documentation for more information.

canJump = EditorGUILayout.Toggle ("Can Jump", canJump);

// Disable the jumping height control if canJump is false: EditorGUI.BeginDisabledGroup (canJump == false); jumpHeight = EditorGUILayout.FloatField ("Jump Height", jumpHeight); EditorGUI.EndDisabledGroup ();

The group cannot be used to enable controls that would otherwise be disabled to begin with. The groups can be nested and the controls within a child group will be disabled both if that child group is itself disabled or if a parent group is.

Did you find this page useful? Please give it a rating: