Editor

描述

从中派生自定义编辑器的基类。使用此类可为对象创建您自己的自定义检视面板和编辑器。

设想一个 MyPlayer 脚本，其中包含盔甲和伤害的变量，以及对枪支 GameObject 的引用。

using UnityEngine;
using System.Collections;

// This is not an editor script.
public class MyPlayer : MonoBehaviour {
    public int armor = 75;
    public int damage = 25;
    public GameObject gun;

    void Update () {
    // Update logic here...
    }
}

使用自定义编辑器时，可以在检视面板中更改脚本外观，正如下图所示：

\ 检视面板中的自定义编辑器。

您可以使用 CustomEditor 属性将编辑器附加到自定义组件。

可通过多种方式设计自定义编辑器。 如果您希望编辑器支持多对象编辑，可以使用 CanEditMultipleObjects 属性。 与直接修改脚本变量相比，使用 SerializedObject 和 SerializedProperty 系统进行编辑更为有利，因为这会自动处理多对象编辑、撤消和预制件重载。如果使用此方法，用户可以在层次结构窗口中选择多个资源并一次性更改所有资源的值。

using UnityEditor;
using UnityEngine;
using System.Collections;

// Custom Editor using SerializedProperties.
// Automatic handling of multi-object editing, undo, and prefab overrides.
[CustomEditor(typeof(MyPlayer))]
[CanEditMultipleObjects]
public class MyPlayerEditor : Editor {
    SerializedProperty damageProp;
    SerializedProperty armorProp;
    SerializedProperty gunProp;

    void OnEnable () {
        // Setup the SerializedProperties.
        damageProp = serializedObject.FindProperty ("damage");
        armorProp = serializedObject.FindProperty ("armor");
        gunProp = serializedObject.FindProperty ("gun");
    }

    public override void OnInspectorGUI() {
        // Update the serializedProperty - always do this in the beginning of OnInspectorGUI.
        serializedObject.Update ();

        // Show the custom GUI controls.
        EditorGUILayout.IntSlider (damageProp, 0, 100, new GUIContent ("Damage"));

        // Only show the damage progress bar if all the objects have the same damage value:
        if (!damageProp.hasMultipleDifferentValues)
            ProgressBar (damageProp.intValue / 100.0f, "Damage");

        EditorGUILayout.IntSlider (armorProp, 0, 100, new GUIContent ("Armor"));

        // Only show the armor progress bar if all the objects have the same armor value:
        if (!armorProp.hasMultipleDifferentValues)
            ProgressBar (armorProp.intValue / 100.0f, "Armor");

        EditorGUILayout.PropertyField (gunProp, new GUIContent ("Gun Object"));

        // Apply changes to the serializedProperty - always do this in the end of OnInspectorGUI.
        serializedObject.ApplyModifiedProperties ();
    }

    // Custom GUILayout progress bar.
    void ProgressBar (float value, string label) {
        // Get a rect for the progress bar using the same margins as a textfield:
        Rect rect = GUILayoutUtility.GetRect (18, 18, "TextField");
        EditorGUI.ProgressBar (rect, value, label);
        EditorGUILayout.Space ();
    }
}

或者，如果不需要自动处理多对象编辑、撤消 和预制件重载，可直接通过编辑器修改 脚本变量，而无需使用 SerializedObject 和 SerializedProperty 系统，如下例所示。

using UnityEditor;
using UnityEngine;
using System.Collections;


// Example script with properties.
public class MyPlayerAlternative : MonoBehaviour {
    public int damage;
    public int armor;
    public GameObject gun;

    // ...other code...
}


// Custom Editor the "old" way by modifying the script variables directly.
// No handling of multi-object editing, undo, and prefab overrides!
[CustomEditor (typeof(MyPlayerAlternative))]
public class MyPlayerEditorAlternative : Editor {

    public override void OnInspectorGUI () {
        MyPlayer mp = (MyPlayer)target;

        mp.damage = EditorGUILayout.IntSlider ("Damage", mp.damage, 0, 100);
        ProgressBar (mp.damage / 100.0f, "Damage");

        mp.armor = EditorGUILayout.IntSlider ("Armor", mp.armor, 0, 100);
        ProgressBar (mp.armor / 100.0f, "Armor");

        bool allowSceneObjects = !EditorUtility.IsPersistent (target);
        mp.gun = (GameObject)EditorGUILayout.ObjectField ("Gun Object", mp.gun, typeof(GameObject), allowSceneObjects);
    }

    // Custom GUILayout progress bar.
    void ProgressBar (float value, string label) {
        // Get a rect for the progress bar using the same margins as a textfield:
        Rect rect = GUILayoutUtility.GetRect (18, 18, "TextField");
        EditorGUI.ProgressBar (rect, value, label);
        EditorGUILayout.Space ();
    }
}

变量

公共函数

受保护的函数

静态函数

消息

继承的成员