Legacy Documentation: Version 4.5.0

Script language:

  • JS
  • C#
  • Boo
Script language

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

EditorGUI.BeginDisabledGroup

static function BeginDisabledGroup(disabled: bool): void;
static void BeginDisabledGroup(bool disabled);
static def BeginDisabledGroup(disabled as bool) as void

Parameters

disabledBoolean 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.

	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.