122 lines
4.9 KiB
C#
122 lines
4.9 KiB
C#
using UnityEngine;
|
|
|
|
namespace XericUI.VisualForm
|
|
{
|
|
/// <summary>
|
|
/// 窗口条目数据 — 锚点窗口上每个窗口对象的配置集合。
|
|
/// 包含窗口对象引用、屏幕二维偏移量和激活状态。
|
|
/// 支持一个锚点同时生成多个定位窗口。
|
|
/// 运行时修改通过 AnchorWindow 的 SetEntryXxx 方法，自动同步到 WindowState。
|
|
/// </summary>
|
|
[System.Serializable]
|
|
public class WindowEntry
|
|
{
|
|
[SerializeField, Tooltip("窗口对象（可以是子项中的实例或预制体资源）")]
|
|
private GameObject m_WindowObject;
|
|
|
|
[SerializeField, Tooltip("屏幕二维偏移量")]
|
|
private Vector2 m_ScreenOffset;
|
|
|
|
[SerializeField, Tooltip("是否启用此窗口")]
|
|
private bool m_Enabled = true;
|
|
|
|
[SerializeField, Tooltip("超出安全区后是否钳制在安全区内")]
|
|
private bool m_ClampToSafeZone;
|
|
|
|
/// <summary>
|
|
/// 窗口对象引用（实例或预制体）
|
|
/// </summary>
|
|
public GameObject WindowObject
|
|
{
|
|
get => m_WindowObject;
|
|
set => m_WindowObject = value;
|
|
}
|
|
|
|
/// <summary>
|
|
/// 屏幕二维偏移量
|
|
/// </summary>
|
|
public Vector2 ScreenOffset
|
|
{
|
|
get => m_ScreenOffset;
|
|
set => m_ScreenOffset = value;
|
|
}
|
|
|
|
/// <summary>
|
|
/// 是否启用此窗口。代码修改请通过 AnchorWindow.SetEntryEnabled()
|
|
/// </summary>
|
|
public bool Enabled => m_Enabled;
|
|
|
|
/// <summary>
|
|
/// 超出安全区后是否钳制在安全区内。代码修改请通过 AnchorWindow.SetEntryClampToSafeZone()
|
|
/// </summary>
|
|
public bool ClampToSafeZone => m_ClampToSafeZone;
|
|
|
|
// --- 运行时状态（非序列化） ---
|
|
|
|
/// <summary>
|
|
/// 实际生成的窗口实例（原型或预制体实例）
|
|
/// </summary>
|
|
[System.NonSerialized]
|
|
public GameObject Instance;
|
|
|
|
/// <summary>
|
|
/// 此窗口对象是否被判定为预制体（不在坞子项中）
|
|
/// </summary>
|
|
[System.NonSerialized]
|
|
public bool IsPrefab;
|
|
|
|
/// <summary>
|
|
/// 当前帧的溢出状态（逐条目跟踪，用于检测变化触发事件）
|
|
/// </summary>
|
|
[System.NonSerialized]
|
|
public OverflowState CurrentOverflow;
|
|
|
|
// --- 内部方法（供 AnchorWindow 调用） ---
|
|
|
|
internal void SetEnabledInternal(bool value) => m_Enabled = value;
|
|
internal void SetClampToSafeZoneInternal(bool value) => m_ClampToSafeZone = value;
|
|
|
|
// --- 实例生命周期虚方法（重写以自定义窗口行为） ---
|
|
|
|
/// <summary>
|
|
/// 实例创建后回调 — 在实例从对象池取出或新实例化后调用。
|
|
/// 可重写以执行额外初始化（如获取组件引用、注册事件）。
|
|
/// </summary>
|
|
/// <param name="state">当前的WindowState中间类（提供锚点、坞、溢出状态等上下文）</param>
|
|
/// <param name="instance">新创建/复用的GameObject实例</param>
|
|
public virtual void OnInstanceCreated(WindowState state, GameObject instance) { }
|
|
|
|
/// <summary>
|
|
/// 实例激活回调 — 在锚点Enable、窗口条目应当显示时调用。
|
|
/// 可重写以实现自定义激活逻辑。
|
|
/// </summary>
|
|
/// <param name="state">当前的WindowState中间类</param>
|
|
/// <param name="instance">当前的实例GameObject（可能是原型对象或预制体实例）</param>
|
|
public virtual void OnInstanceEnable(WindowState state, GameObject instance) { }
|
|
|
|
/// <summary>
|
|
/// 实例隐藏回调 — 在锚点Disable、窗口条目应当隐藏时调用。
|
|
/// 可重写以实现自定义隐藏逻辑。
|
|
/// </summary>
|
|
/// <param name="state">当前的WindowState中间类</param>
|
|
/// <param name="instance">当前的实例GameObject</param>
|
|
public virtual void OnInstanceDisable(WindowState state, GameObject instance) { }
|
|
|
|
/// <summary>
|
|
/// 实例回收回调 — 在实例回收到对象池时调用。
|
|
/// 可重写以清理状态、移除事件监听等。
|
|
/// </summary>
|
|
/// <param name="state">当前的WindowState中间类</param>
|
|
/// <param name="instance">即将被回收的实例GameObject</param>
|
|
public virtual void OnInstanceRecycle(WindowState state, GameObject instance) { }
|
|
|
|
/// <summary>
|
|
/// 实例销毁回调 — 在实例即将被Destroy时调用。
|
|
/// 可重写以执行最终清理（通常情况下回收到对象池足矣）。
|
|
/// </summary>
|
|
/// <param name="state">当前的WindowState中间类</param>
|
|
/// <param name="instance">即将被销毁的实例GameObject</param>
|
|
public virtual void OnInstanceDestroy(WindowState state, GameObject instance) { }
|
|
}
|
|
}
|