Files
XericUIActionVessel/Runtime/VisualForm/WorldAnchor.cs
T
lrss3 4e760d59d1 refactor(注册路径): 调用点收进 XericRegistrationPaths,46 个文件只动注册属性行
10-27 那笔把表的根定成 XericLibrary,但 58 处 AddComponentMenu、4 处 CreateAssetMenu
和若干 MenuItem/ContextMenu 还各自写着 "Xeric UI Vessel/…"、"Xeric/XChart/…" 三套
旧字面量;那批转换一直停在工程里没提交。本笔只收这 46 个"除注册属性外没有别的改动"
的文件,路径出处从此只在表里一处。

工作区里另外 3 个文件(XericImage 的角偏移、IVisibility 接口、XericInfiniteVesselBase
的 region/注释)混着功能改动,不在本笔;Editor/OverrideUI/XericImageEditor.cs 与
Runtime/OverrideUI/XericImageDeform.cs 两个未入库新文件也不在。
2026-10-30 12:34:34 +08:00

87 lines
2.4 KiB
C#

using UnityEngine;
using XericUI.Core;
namespace XericUI.VisualForm
{
/// <summary>
/// 世界对象锚点 - 挂载在场景对象上,将世界空间位置传递给锚点坞进行屏幕空间定位
/// </summary>
[AddComponentMenu(XericRegistrationPaths.AnchorWindow + "/WorldAnchor")]
public class WorldAnchor : XvFormBase
{
[SerializeField, Tooltip("目标锚点坞,不填则自动在父级中查找")]
private AnchorDock m_TargetDock;
/// <summary>
/// 目标锚点坞引用
/// </summary>
public AnchorDock TargetDock
{
get => m_TargetDock;
set => m_TargetDock = value;
}
/// <summary>
/// 缓存Transform组件
/// </summary>
[System.NonSerialized]
private Transform _cachedTransform;
/// <summary>
/// 缓存Transform,避免重复GetComponent
/// </summary>
public Transform CachedTransform
{
get
{
if (_cachedTransform == null)
_cachedTransform = transform;
return _cachedTransform;
}
}
protected void OnEnable()
{
// 尝试自动查找锚点坞
if (m_TargetDock == null)
m_TargetDock = GetComponentInParent<AnchorDock>();
// 回退到静态单例
if (m_TargetDock == null)
m_TargetDock = AnchorDock.Main;
if (m_TargetDock != null)
{
m_TargetDock.AddAnchor(this);
}
else
{
// 暂存到全局待注册列表,等待坞就绪后处理
AnchorDock.s_PendingAnchors.Add(this);
}
}
protected void OnDisable()
{
UnregisterFromDock();
}
protected void OnDestroy()
{
UnregisterFromDock();
}
/// <summary>
/// 从锚点坞或待注册列表中注销此锚点。
/// OnDisable 和 OnDestroy 共用,确保所有退出路径都执行清理。
/// </summary>
private void UnregisterFromDock()
{
if (m_TargetDock != null)
m_TargetDock.RemoveAnchor(this);
else
AnchorDock.s_PendingAnchors.Remove(this);
}
}
}