Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


ColorField

Make a field for selecting a Color.
Read time 6 minutesLast updated 12 days ago

Definition

  • Type: Method
  • Namespace: UnityEditor
  • Assembly: UnityEditor

ColorField(Color, GUILayoutOption[])

Make a field for selecting a Color.
public static Color ColorField(Color value, params GUILayoutOption[] options)

Parameters

value

The color to edit.

An optional list of layout options that specify extra layout properties. Any values passed in here will override settings defined by the style.
Additional Resources: GUILayout.Width, GUILayout.Height, GUILayout.MinWidth, GUILayout.MaxWidth, GUILayout.MinHeight, GUILayout.MaxHeight, GUILayout.ExpandWidth, GUILayout.ExpandHeight.

Returns

Type

Description

ColorThe color selected by the user.

Remarks

MassiveColorChange (ColorField)
Change the color of the selected GameObjects.

Examples

using UnityEngine;using UnityEditor;// Change the color of the selected GameObjects.public class ExampleClass : EditorWindow{ Color matColor = Color.white; [MenuItem("Examples/Mass Color Change")] static void Init() { EditorWindow window = GetWindow(typeof(ExampleClass)); window.Show(); } void OnGUI() { matColor = EditorGUILayout.ColorField("New Color", matColor); if (GUILayout.Button("Change!")) ChangeColors(); } private void ChangeColors() { if (Selection.activeGameObject) foreach (GameObject t in Selection.gameObjects) { Renderer rend = t.GetComponent<Renderer>(); if (rend != null) rend.sharedMaterial.color = matColor; } }}

ColorField(string, Color, GUILayoutOption[])

Make a field for selecting a Color.
public static Color ColorField(string label, Color value, params GUILayoutOption[] options)

Parameters

label

Optional label to display in front of the field.

value

The color to edit.

An optional list of layout options that specify extra layout properties. Any values passed in here will override settings defined by the style.
Additional Resources: GUILayout.Width, GUILayout.Height, GUILayout.MinWidth, GUILayout.MaxWidth, GUILayout.MinHeight, GUILayout.MaxHeight, GUILayout.ExpandWidth, GUILayout.ExpandHeight.

Returns

Type

Description

ColorThe color selected by the user.

Remarks

MassiveColorChange (ColorField)
Change the color of the selected GameObjects.

Examples

using UnityEngine;using UnityEditor;// Change the color of the selected GameObjects.public class ExampleClass : EditorWindow{ Color matColor = Color.white; [MenuItem("Examples/Mass Color Change")] static void Init() { EditorWindow window = GetWindow(typeof(ExampleClass)); window.Show(); } void OnGUI() { matColor = EditorGUILayout.ColorField("New Color", matColor); if (GUILayout.Button("Change!")) ChangeColors(); } private void ChangeColors() { if (Selection.activeGameObject) foreach (GameObject t in Selection.gameObjects) { Renderer rend = t.GetComponent<Renderer>(); if (rend != null) rend.sharedMaterial.color = matColor; } }}

ColorField(GUIContent, Color, GUILayoutOption[])

Make a field for selecting a Color.
public static Color ColorField(GUIContent label, Color value, params GUILayoutOption[] options)

Parameters

Optional label to display in front of the field.

value

The color to edit.

An optional list of layout options that specify extra layout properties. Any values passed in here will override settings defined by the style.
Additional Resources: GUILayout.Width, GUILayout.Height, GUILayout.MinWidth, GUILayout.MaxWidth, GUILayout.MinHeight, GUILayout.MaxHeight, GUILayout.ExpandWidth, GUILayout.ExpandHeight.

Returns

Type

Description

ColorThe color selected by the user.

Remarks

MassiveColorChange (ColorField)
Change the color of the selected GameObjects.

Examples

using UnityEngine;using UnityEditor;// Change the color of the selected GameObjects.public class ExampleClass : EditorWindow{ Color matColor = Color.white; [MenuItem("Examples/Mass Color Change")] static void Init() { EditorWindow window = GetWindow(typeof(ExampleClass)); window.Show(); } void OnGUI() { matColor = EditorGUILayout.ColorField("New Color", matColor); if (GUILayout.Button("Change!")) ChangeColors(); } private void ChangeColors() { if (Selection.activeGameObject) foreach (GameObject t in Selection.gameObjects) { Renderer rend = t.GetComponent<Renderer>(); if (rend != null) rend.sharedMaterial.color = matColor; } }}

ColorField(GUIContent, Color, bool, bool, bool, ColorPickerHDRConfig, GUILayoutOption[])

Make a field for selecting a Color.
Warning
Deprecated. Use EditorGUILayout.ColorField(GUIContent label, Color value, bool showEyedropper, bool showAlpha, bool hdr, params GUILayoutOption[] options)
public static Color ColorField(GUIContent label, Color value, bool showEyedropper, bool showAlpha, bool hdr, ColorPickerHDRConfig hdrConfig, params GUILayoutOption[] options)

Parameters

Optional label to display in front of the field.

value

The color to edit.

showEyedropper

If true, the color picker should show the eyedropper control. If false, don't show it.

showAlpha

If true, allow the user to set an alpha value for the color. If false, hide the alpha component.

hdr

If true, treat the color as an HDR value. If false, treat it as a standard LDR value.


An optional list of layout options that specify extra layout properties. Any values passed in here will override settings defined by the style.
Additional Resources: GUILayout.Width, GUILayout.Height, GUILayout.MinWidth, GUILayout.MaxWidth, GUILayout.MinHeight, GUILayout.MaxHeight, GUILayout.ExpandWidth, GUILayout.ExpandHeight.

Returns

Type

Description

ColorThe color selected by the user.

Remarks

MassiveColorChange (ColorField)
Change the color of the selected GameObjects.

Examples

using UnityEngine;using UnityEditor;// Change the color of the selected GameObjects.public class ExampleClass : EditorWindow{ Color matColor = Color.white; [MenuItem("Examples/Mass Color Change")] static void Init() { EditorWindow window = GetWindow(typeof(ExampleClass)); window.Show(); } void OnGUI() { matColor = EditorGUILayout.ColorField("New Color", matColor); if (GUILayout.Button("Change!")) ChangeColors(); } private void ChangeColors() { if (Selection.activeGameObject) foreach (GameObject t in Selection.gameObjects) { Renderer rend = t.GetComponent<Renderer>(); if (rend != null) rend.sharedMaterial.color = matColor; } }}

ColorField(GUIContent, Color, bool, bool, bool, GUILayoutOption[])

Make a field for selecting a Color.
public static Color ColorField(GUIContent label, Color value, bool showEyedropper, bool showAlpha, bool hdr, params GUILayoutOption[] options)

Parameters

Optional label to display in front of the field.

value

The color to edit.

showEyedropper

If true, the color picker should show the eyedropper control. If false, don't show it.

showAlpha

If true, allow the user to set an alpha value for the color. If false, hide the alpha component.

hdr

If true, treat the color as an HDR value. If false, treat it as a standard LDR value.

An optional list of layout options that specify extra layout properties. Any values passed in here will override settings defined by the style.
Additional Resources: GUILayout.Width, GUILayout.Height, GUILayout.MinWidth, GUILayout.MaxWidth, GUILayout.MinHeight, GUILayout.MaxHeight, GUILayout.ExpandWidth, GUILayout.ExpandHeight.

Returns

Type

Description

ColorThe color selected by the user.

Remarks

MassiveColorChange (ColorField)
Change the color of the selected GameObjects.

Examples

using UnityEngine;using UnityEditor;// Change the color of the selected GameObjects.public class ExampleClass : EditorWindow{ Color matColor = Color.white; [MenuItem("Examples/Mass Color Change")] static void Init() { EditorWindow window = GetWindow(typeof(ExampleClass)); window.Show(); } void OnGUI() { matColor = EditorGUILayout.ColorField("New Color", matColor); if (GUILayout.Button("Change!")) ChangeColors(); } private void ChangeColors() { if (Selection.activeGameObject) foreach (GameObject t in Selection.gameObjects) { Renderer rend = t.GetComponent<Renderer>(); if (rend != null) rend.sharedMaterial.color = matColor; } }}