创建弹出窗口

此示例演示如何使用UnityEditor.PopupWindow以创建弹出窗口。

示例概述

此示例创建一个弹出窗口，该窗口通过自定义编辑器窗口中的按钮显示。弹出窗口有三个切换开关，并在未聚焦时关闭。

您可以在此 GitHub 存储库中找到此示例创建的已完成文件。

先决条件

本指南适用于熟悉 Unity 编辑器、UI 工具包和 C# 脚本的开发人员。在开始之前，请熟悉以下内容：

• UXML的
• USS
• UnityEditor.PopupWindow

创建自定义编辑器窗口

创建带有按钮的自定义编辑器窗口。在UI文档（UXML文件）中定义按钮，并在USS文件中设置其样式。最后，在C#脚本中定义按钮逻辑，以便在单击按钮时显示弹出窗口。

1. 使用任何模板创建 Unity 项目。

2. 右键单击 项目（Project） 窗口，然后选择 创建>UI 工具包（Create UI Toolkit > 编辑器窗口（Editor Window） 。

3. 在“UI 工具包编辑器窗口创建器”窗口的“C#”框中，输入PopupExample.

4. 选择“确认”。这将创建三个文件：PopupExample.cs,PopupExample.uxml和PopupExample.uss.

5. 取代PopupExample.uxml内容如下：

          
   <ui:UXML xmlns:ui="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements" xsi="http://www.w3.org/2001/XMLSchema-instance" engine="UnityEngine.UIElements" editor="UnityEditor.UIElements" noNamespaceSchemaLocation="../../UIElementsSchema/UIElements.xsd" editor-extension-mode="True">
   <Style src="PopupExample.uss" />
   <ui:Button text="Popup Options" display-tooltip-when-elided="true" class="popup-button" />
   </ui:UXML>
        
   

6. 取代PopupExample.cs内容如下：

           
   using UnityEditor;
   using UnityEngine.UIElements;
   using PopupWindow = UnityEditor.PopupWindow;
       
   public class PopupExample : EditorWindow
   {
        //Add menu item
        [MenuItem("Examples/Popup Example")]
        static void Init()
        {
             EditorWindow window = EditorWindow.CreateInstance<PopupExample>();
             window.Show();
        }
       
        private void CreateGUI()
        {
             var visualTreeAsset = AssetDatabase.LoadAssetAtPath<VisualTreeAsset>("Assets/Editor/PopupExample.uxml");
             visualTreeAsset.CloneTree(rootVisualElement);
       
             var button = rootVisualElement.Q<Button>();
             button.clicked += () => PopupWindow.Show(button.worldBound, new PopupContentExample());
        }
   }
   

7. 取代PopupExample.uss内容如下：

   .popup-button {
       width: 200px;
   }
   

创建弹出窗口内容

创建一个UI文档（UXML文件）以定义弹出窗口中的内容。创建一个C#类来设置窗口大小并显示窗口。

1. 在Editor文件夹中，创建一个名为PopupWindowContent.uxml内容如下：

   <ui:UXML xmlns:ui="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements" xsi="http://www.w3.org/2001/XMLSchema-instance" engine="UnityEngine.UIElements" editor="UnityEditor.UIElements" noNamespaceSchemaLocation="../../../UIElementsSchema/UIElements.xsd" editor-extension-mode="True">
       <ui:Toggle label="Toggle 1" name="Toggle1"/>
       <ui:Toggle label="Toggle 2" />
       <ui:Toggle label="Toggle 3" />
   </ui:UXML>
   

2. 在Editor文件夹中，创建一个名为PopupContentExample.cs内容如下：

   using UnityEditor;
   using UnityEngine;
   using UnityEngine.UIElements;
       
   public class PopupContentExample : PopupWindowContent
   { 
       public override void OnOpen()
       {
           Debug.Log("Popup opened: " + this);
       }
       
       public override VisualElement CreateGUI()
       {
           var visualTreeAsset = AssetDatabase.LoadAssetAtPath<VisualTreeAsset>("Assets/Editor/PopupWindowContent.uxml");
           return visualTreeAsset.CloneTree();
       }
       
       public override void OnClose()
       {
           Debug.Log("Popup closed: " + this);
       }
   }
   

3. 要测试弹出窗口，请从菜单中选择示例>弹出窗口示例>弹出选项。