2024-02-11 Unity 编辑器开发之编辑器拓展2 —— 自定义窗口

文章目录

  • [1 创建窗口类](#1 创建窗口类)
  • [2 显示窗口](#2 显示窗口)
  • [3 窗口事件回调函数](#3 窗口事件回调函数)
  • [4 窗口中常用的生命周期函数](#4 窗口中常用的生命周期函数)
  • [5 编辑器窗口类中的常用成员](#5 编辑器窗口类中的常用成员)
  • [6 小结](#6 小结)

1 创建窗口类

​ 当想为 Unity 拓展一个自定义窗口时,只需实现继承 EditorWindow 的类即可,并在该类的 OnGUI 函数中编写面板控件相关的逻辑。

  • 命名空间:UnityEditor
  • 类名:EditorWindow

2 显示窗口

​ 调用 EditorWindow.GetWindow() 添加自定义页签,用于开启窗口。创建窗口对象后,调用对象的 Show() 方法即可显示窗口。

​ 该方法有多种重载,主要参数一般有:

  • Type 或 T:窗口类的类型。
  • utility:为 true 可创建浮动实用程序窗口(可自由拖动、改变大小),设置为 false 可创建正常窗口。
  • title:窗口标题。
  • focus:是否为窗口提供焦点(如果已存在)。(如果 GetWindow 创建新窗口,则将始终获得焦点)。
  • desiredDockNextTo:窗口试图停靠到其上的 EditorWindow 类型的数组。
csharp 复制代码
public class Lesson2 : EditorWindow
{
    [MenuItem("Unity编辑器拓展/Lesson2/显示自定义面板")]
    private static void ShowWindow() {
        Lesson2 win = EditorWindow.GetWindow<Lesson2>("我的窗口");
        win.Show();
    }
}

3 窗口事件回调函数

​ 继承 EditorWindow 的窗口类自带一些事件回调函数,当触发对应事件时会自动进入。

  1. OnHierarchyChange():当场景中的层次结构(Hierarchy)发生变化时调用。

    例如,当游戏对象被创建、删除或重命名时触发。

  2. OnFocus():当窗口获得焦点时调用。

    在该方法中可以执行在窗口获得焦点时需要进行的操作。

  3. OnLostFocus():当窗口失去焦点时调用。

    通常在该方法中执行在窗口失去焦点时需要进行的清理工作。

  4. OnProjectChange():当项目资源发生变化时调用。

    例如,当添加、删除或修改项目中的文件时触发。

  5. OnInspectorUpdate():在检视器(Inspector)面板更新时调用。

    可以在这个方法中执行需要在检视器面板刷新时进行的逻辑,比如更新显示的信息。

  6. OnSelectionChange():当选择的对象发生变化时调用。

    在该方法中可以执行与所选对象相关的操作,以确保编辑器窗口的内容与当前选择保持同步。

4 窗口中常用的生命周期函数

  1. OnEnable():

    当窗口被激活时调用,通常在窗口创建时会调用一次。

    在该方法中可以进行初始化工作,例如注册事件监听器或设置初始变量。

  2. OnGUI():

    每帧都会调用此方法,用于绘制编辑器窗口的 GUI。

    在该方法中可以使用 GUILayout 或 EditorGUILayout 等类创建界面元素,以便用户与窗口进行交互。

  3. OnDestroy():

    当窗口被销毁时调用,通常在关闭编辑器或切换场景时触发。在这里进行最终的清理工作,确保没有未释放的资源。

  4. Update():

    在编辑器窗口每帧更新时调用。通常在这里执行需要在每帧进行的逻辑。

5 编辑器窗口类中的常用成员

​ Unity 官方文档有关于编辑器窗口类的 API 说明:https://docs.unity.cn/cn/2022.3/ScriptReference/EditorWindow.html。

  • 静态变量

    1. focusedWindow:当前已获得键盘焦点的 EditorWindow。(只读)
    2. mouseOverWindow:当前在鼠标光标下的 EditorWindow。(只读)
  • 静态函数

    1. CreateWindow:创建窗口,如果允许窗口有多个,可用该 API 创建窗口。
    2. GetWindow:创建一个窗口对象。
    3. GetWindowWithRect:返回一个指定位置、大小的窗口。
    4. HasOpenInstances:检查编辑器窗口是否打开。
  • 成员变量

    1. titleContent:窗口标题名。
    2. positon:窗口位置大小信息。
    3. wantsMouseEnterLeaveWindow:如果设置为 true,则每当鼠标进入或离开窗口时,该窗口都会收到一次 OnGUI 调用。
  • 成员函数

    1. Show:显示面板。
    2. Repaint:重绘窗口。
    3. Close:关闭窗口。

6 小结

​ 想要实现自定义窗口,只需继承 EditorWindow 类,主要工作是在 OnGUI 中利用 GUI 相关 API 绘制控件处理功能逻辑。

​ 使用对应的事件回调函数帮助监听一些特殊情况,用于处理对应逻辑。

相关推荐
广东帝工9 小时前
双预警防线,筑牢智慧航道水上安全屏障
编辑器
Solange__13 小时前
在线3D预览器、Blender和游戏引擎怎么选?按5类任务比较格式、隐私与编辑性
人工智能·游戏·3d·游戏引擎·blender·1024程序员节·关卡设计
sunshine22 girl13 小时前
copilot vscode 使用技巧
人工智能·vscode·编辑器
椒颜皮皮虾྅13 小时前
让文档不止于文字:DeploySharp + PP-Structure,打通版面分析与表格重建
开发语言·学习·c#·.net·cuda
Frag0ut13 小时前
Notepad++ 零基础入门:从记事本到代码编辑器的平滑过渡(2026最新版)
python·编辑器·html·json·notepad++·markdown·记事本
行走的陀螺仪14 小时前
Claude Code 从入门到实战(三):Hooks、Skills、SubAgents 高级扩展
linux·编辑器·vim
peter676815 小时前
unity2d游戏开发经验总结
unity
Dovis(誓平步青云)15 小时前
拖动关键帧角色就抽动,动画编辑器怎样补齐中间状态
开发语言·前端·javascript·机器学习·编辑器
郝学胜-神的一滴15 小时前
游戏设计:原型与开发 19:U3D工位布置与性格说明书
人工智能·算法·unity·unreal engine·游戏策划·游戏设计
椒颜皮皮虾྅15 小时前
一套 C# 接口,解锁四类视觉任务:DeploySharp 分类、分割、关键点与旋转框实战
开发语言·分类·c#