获取物件图层 (OL) - LK Layer

📖 功能概述

接收一个 Rhino 物件的引用，从其属性中提取图层信息。通过右键菜单切换两种输出模式：

完整路径 — 输出图层的层级完整路径（如 ::建筑::外墙），可用于 图层信息 组件作为输入
图层名称 — 仅输出最后的图层名称（不包含父级层级）

💡 输入类型兼容：与 ObjectColor（获取物件颜色） 组件使用完全相同的 4 种输入类型解析链（IGH_GeometricGoo / RhinoObject / GH_Guid / GH_ObjectWrapper），支持从多种数据源直接获取物件引用。

🎛️ 右键菜单

选项	索引	说明
完整路径	0（默认）	输出图层的 `FullPath`，包含所有父级层级名称
图层名称	1	仅输出 `layer.Name`，只含本层显示名称

📥 输入参数

名称	类型	必填	说明
物件 (O)	Generic	必需	需要获取图层信息的 Rhino 物件。支持多种输入类型自动解析。空值报 Warning。

📤 输出参数

名称	类型	说明
图层 (L)	Text	物件的图层信息。列表输出。根据右键菜单选择的模式输出完整路径或仅名称。

🧠 运行流程

流程

读取输入 — 获取输入对象，null 时 Warning 返回
转换为 RhinoObject — 通过 4 种类型的解析链尝试还原为 RhinoObject
图层定位 — rhinoObject.Attributes.LayerIndex → doc.Layers[layerid]
模式输出 — SelectedIndex == 0 时输出 layer.FullPath，否则输出 layer.Name
异常保护 — try-catch 包裹图层操作，出错时报 Error 获取图层信息时出错: {message}

⚠️ 物件无图层时：如果 layer 为 null，报 Warning 物件没有关联的图层，不输出数据。

🧪 典型使用场景

验证物件归属 — 检查物件是否在目标图层中
图层迁移 — 配合 修改图层 组件，先读取原图层路径再迁移到新图层
物-层对应表 — 批量统计某文档中所有物件归属的图层分布

📋 组件信息

名称	获取物件图层
英文名	OL
分类	LK → Layer
基类	RighrClickComponent
右键菜单	完整路径 / 图层名称（双模式切换）
GUID	{5576A3B4-0BB6-4EEE-AF11-AAE6F0AF6BE1}

更新日期：2026-06-29