XChart P20d:外部访问的两条入口补上(Tool<T>/Element<T>),权威分工写进规范 §27
他问的是"能不能直接拿到圆柱渲染器,改属性就自动更新"。答案分两半: **入口早就有**(`chart.ToolManager.FindTool<ChartToolCylinder>()`),**自动置脏这半没有**—— 第二半已由前两笔补齐(P20a 抽象脏位协议、P20b 132 个旋钮全部设了就生效)。 这一笔补第一半的手感,并把"谁覆盖谁"这件事写成文字。 - `XChartBase.Tool<T>(toolName = null)`:`FindTool<T>` 的空安全简写。 为什么不直接让他写 `ToolManager.FindTool<T>()`——工具管理器还没建时那句抛 NRE, 而"图里现在有没有这一类"是现场状态,调用方要问得出"没有"这个答案(答 null,不抛)。 同类多条按名字点,名字就是 `ElementNameFor(i)` 那一个(面板上元素行印的也是它)。 - `XChartBase.Element<T>()`:按类型取表里第一份配置,走 `XChartElementTable.FirstOfKind`—— "哪一条是这一类"只许有这一个答法(默认元素去重、面板、外部读配置共用)。 规范 §27 里最要紧的是 **27.3 那条会咬人的分工**:配置是作者数据、工具是它的投影。 外部写进工具的值活到下一次 `ReapplyElements()` / `RebuildElements()`(面板动任一字段、 增删/停用元素、脚本重载、进 Play、`ResetRender()` 都走这条),那一次把配置整份重灌进工具 ⇒ 外部的写被静默覆盖。要活得过重建就得写配置,而**配置的公开写入口这一轮没开**(字段仍是 private;面板走 SerializedProperty 本来就不需要公开属性)——这条如实记在 27.6,是下一步。 顺手把 §25.9 那两条"还没做的"改成已被 §26 做掉(旧话写着"现在还是直线段""等逐顶点双色", 而这两条本轮之前就已经实现了)——对外文档按最新实现校准,不留过期主张。 判据:新源码门 dirty_gate.py(P20b 那笔已交)终态 knobs=132 takesEffect=132 findings=0、 七支变异各红在自己点名的断言上;本笔改的是 `XChartBase`(不在门覆盖里), 由离线编译门覆盖:runtime + player + editor + 3 支对照 GATE PASSED,chain_p20d.txt rc=0。 CHANGELOG 补 P20 一行。观感归他现场判(Ctrl+R 后的验收四条写在 27.7)。
This commit is contained in:
@@ -458,6 +458,16 @@ namespace XericUI.XChart
|
||||
|
||||
public void RemoveAllTools() => ToolManager?.RemoveAllTools();
|
||||
|
||||
/// <summary>
|
||||
/// 按类型取<b>已加载的元素实例</b>(同类多条时用 <paramref name="toolName"/> 点名,名字见
|
||||
/// <see cref="ElementNameFor"/>)。没初始化、没找到都答 null——不抛,因为"图里现在有没有这一类"
|
||||
/// 是现场状态,调用方要能问出"没有"这个答案。
|
||||
///
|
||||
/// <para>取到之后直接写它的公开旋钮就行:每个 setter 自己置脏(规范 §27),不用补 <c>MarkDirty()</c>。</para>
|
||||
/// </summary>
|
||||
public T Tool<T>(string toolName = null) where T : XChartToolBase
|
||||
=> ToolManager != null ? ToolManager.FindTool<T>(toolName) : null;
|
||||
|
||||
// ── 元素(配置路径) ──────────────────────────────────────
|
||||
|
||||
/// <summary>元素配置表([SerializeReference],Inspector 里逐项展开自己类型的字段)</summary>
|
||||
@@ -466,6 +476,14 @@ namespace XericUI.XChart
|
||||
/// <summary>当前已加载的元素实例(与配置表同序、只含启用的项)</summary>
|
||||
public IReadOnlyList<XChartToolBase> ElementTools => m_ElementTools;
|
||||
|
||||
/// <summary>
|
||||
/// 按类型取表里<b>第一份</b>这一类的配置,没有则 null。
|
||||
/// "哪一条是这一类"只许有这一个答法(与 <see cref="XChartElementTable.IndexOfKind"/> 同源),
|
||||
/// 面板、默认元素去重、外部写配置都读这一条。
|
||||
/// </summary>
|
||||
public T Element<T>() where T : XChartElementConfig
|
||||
=> XChartElementTable.FirstOfKind(m_Elements, typeof(T)) as T;
|
||||
|
||||
private readonly List<XChartToolBase> m_ElementTools = new List<XChartToolBase>();
|
||||
|
||||
/// <summary>
|
||||
|
||||
Reference in New Issue
Block a user