[重构](UIManager): 重构和抽象UI管理器到基类

Author: AlianBlank

Runtime/BaseUIManager.Close.cs

@@ -0,0 +1,187 @@
+//------------------------------------------------------------
+// Game Framework
+// Copyright © 2013-2021 Jiang Yin. All rights reserved.
+// Homepage: https://gameframework.cn/
+// Feedback: mailto:ellan@gameframework.cn
+//------------------------------------------------------------
+
+using System;
+using System.Collections.Generic;
+using GameFrameX.Runtime;
+
+namespace GameFrameX.UI.Runtime
+{
+    /// <summary>
+    /// 界面管理器。
+    /// </summary>
+    public partial class BaseUIManager
+    {
+        protected EventHandler<CloseUIFormCompleteEventArgs> m_CloseUIFormCompleteEventHandler;
+
+        /// <summary>
+        /// 关闭界面完成事件。
+        /// </summary>
+        public event EventHandler<CloseUIFormCompleteEventArgs> CloseUIFormComplete
+        {
+            add { m_CloseUIFormCompleteEventHandler += value; }
+            remove { m_CloseUIFormCompleteEventHandler -= value; }
+        }
+
+        /// <summary>
+        /// 回收界面实例对象。
+        /// </summary>
+        /// <param name="uiForm"></param>
+        /// <param name="isDispose">是否销毁释放</param>
+        protected abstract void RecycleUIForm(IUIForm uiForm, bool isDispose = false);
+
+        /// <summary>
+        /// 关闭界面。
+        /// </summary>
+        /// <param name="serialId">要关闭界面的序列编号。</param>
+        /// <param name="isNowRecycle">是否立即回收界面,默认是否</param>
+        public void CloseUIForm(int serialId, bool isNowRecycle = false)
+        {
+            CloseUIForm(serialId, null, isNowRecycle);
+        }
+
+        /// <summary>
+        /// 关闭界面。
+        /// </summary>
+        /// <param name="serialId">要关闭界面的序列编号。</param>
+        /// <param name="userData">用户自定义数据。</param>
+        /// <param name="isNowRecycle">是否立即回收界面,默认是否</param>
+        public void CloseUIForm(int serialId, object userData, bool isNowRecycle = false)
+        {
+            if (IsLoadingUIForm(serialId))
+            {
+                m_UIFormsToReleaseOnLoad.Add(serialId);
+                m_UIFormsBeingLoaded.Remove(serialId);
+                return;
+            }
+
+            IUIForm uiForm = GetUIForm(serialId);
+            if (uiForm == null)
+            {
+                throw new GameFrameworkException(Utility.Text.Format("Can not find UI form '{0}'.", serialId));
+            }
+
+            CloseUIForm(uiForm, userData, isNowRecycle);
+        }
+
+        /// <summary>
+        /// 关闭界面。
+        /// </summary>
+        /// <param name="uiForm">要关闭的界面。</param>
+        /// <param name="isNowRecycle">是否立即回收界面,默认是否</param>
+        public void CloseUIForm(IUIForm uiForm, bool isNowRecycle = false)
+        {
+            CloseUIForm(uiForm, null, isNowRecycle);
+        }
+
+        /// <summary>
+        /// 关闭界面。
+        /// </summary>
+        /// <param name="userData">用户自定义数据。</param>
+        /// <param name="isNowRecycle">是否立即回收界面,默认是否</param>
+        /// <typeparam name="T"></typeparam>
+        public void CloseUIForm<T>(object userData, bool isNowRecycle = false) where T : IUIForm
+        {
+            var fullName = typeof(T).FullName;
+            IUIForm[] uiForms = GetAllLoadedUIForms();
+            foreach (IUIForm uiForm in uiForms)
+            {
+                if (uiForm.FullName != fullName)
+                {
+                    continue;
+                }
+
+                if (!HasUIFormFullName(uiForm.FullName))
+                {
+                    continue;
+                }
+
+                CloseUIForm(uiForm, userData, isNowRecycle);
+                break;
+            }
+        }
+
+        /// <summary>
+        /// 关闭界面。
+        /// </summary>
+        /// <param name="uiForm">要关闭的界面。</param>
+        /// <param name="userData">用户自定义数据。</param>
+        /// <param name="isNowRecycle">是否立即回收界面,默认是否</param>
+        public void CloseUIForm(IUIForm uiForm, object userData, bool isNowRecycle = false)
+        {
+            GameFrameworkGuard.NotNull(uiForm, nameof(uiForm));
+            GameFrameworkGuard.NotNull(uiForm.UIGroup, nameof(uiForm.UIGroup));
+            UIGroup uiGroup = (UIGroup)uiForm.UIGroup;
+            var serialId = uiForm.SerialId;
+            uiGroup.RemoveUIForm(uiForm);
+            uiForm.OnClose(m_IsShutdown, userData);
+            uiGroup.Refresh();
+            if (IsLoadingUIForm(serialId))
+            {
+                m_UIFormsToReleaseOnLoad.Add(serialId);
+                m_UIFormsBeingLoaded.Remove(serialId);
+            }
+
+            bool isRecycled = false;
+            if (isNowRecycle && !uiForm.IsDisableRecycling)
+            {
+                isRecycled = true;
+                RecycleUIForm(uiForm, true);
+            }
+
+            if (uiForm.IsDisableRecycling == false && isRecycled == false)
+            {
+                m_RecycleQueue.Enqueue(uiForm);
+            }
+
+            if (m_CloseUIFormCompleteEventHandler != null)
+            {
+                CloseUIFormCompleteEventArgs closeUIFormCompleteEventArgs = CloseUIFormCompleteEventArgs.Create(uiForm.SerialId, uiForm.UIFormAssetName, uiGroup, userData);
+                m_CloseUIFormCompleteEventHandler(this, closeUIFormCompleteEventArgs);
+            }
+        }
+
+        /// <summary>
+        /// 关闭所有已加载的界面。
+        /// </summary>
+        public void CloseAllLoadedUIForms()
+        {
+            CloseAllLoadedUIForms(null);
+        }
+
+        /// <summary>
+        /// 关闭所有已加载的界面。
+        /// </summary>
+        /// <param name="userData">用户自定义数据。</param>
+        public void CloseAllLoadedUIForms(object userData)
+        {
+            IUIForm[] uiForms = GetAllLoadedUIForms();
+            foreach (IUIForm uiForm in uiForms)
+            {
+                if (!HasUIForm(uiForm.SerialId))
+                {
+                    continue;
+                }
+
+                CloseUIForm(uiForm, userData);
+            }
+        }
+
+        /// <summary>
+        /// 关闭所有正在加载的界面。
+        /// </summary>
+        public void CloseAllLoadingUIForms()
+        {
+            foreach (KeyValuePair<int, string> uiFormBeingLoaded in m_UIFormsBeingLoaded)
+            {
+                m_UIFormsToReleaseOnLoad.Add(uiFormBeingLoaded.Key);
+            }
+
+            m_UIFormsBeingLoaded.Clear();
+        }
+    }
+}