图层信息 · LI
输入图层完整路径，查询该图层的名称、颜色、锁定状态、显示状态和线型信息
📖 功能概述
输入一个图层完整路径字符串，通过 RhinoDoc.ActiveDoc.Layers.FindByFullPath() 查找对应的 Rhino 图层，并输出其 5 项基本信息：名称、颜色、锁定状态、可见性和线型。
💡 注意：输入必须是完整路径（如
::Default::Wall），不是仅图层名称。可使用 获取物件图层 组件的"完整路径"模式获得正确的路径字符串。
📥 输入参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 图层 (L) | Text | 必需 | 图层的完整路径。使用 :: 分隔父子层级。例如：::建筑::外墙。空值或无效则报错。 |
📤 输出参数
| 名称 | 类型 | 说明 |
|---|---|---|
| 名称 (N) | Text | 图层显示名称（不含父级路径）。如图层路径为 ::建筑::外墙，此处输出 外墙。 |
| 颜色 (C) | Color | 图层的颜色（foundLayer.Color）。 |
| 锁定状态 (L) | Bool | true = 图层锁定，false = 未锁定。 |
| 显示状态 (V) | Bool | true = 图层可见，false = 隐藏。 |
| 线型 (T) | Text | 图层的线型名称（如 Continuous、Hidden、Dots）。通过 doc.Linetypes[foundLayer.LinetypeIndex].Name 获取。 |
🧠 运行流程
- 输入检查 — 接收图层名称字符串，空值时直接返回
- 名称合法性校验 — 调用
Layer.IsValidComponentName(layerName)，无效时报错无效图层名称 - 查找图层索引 —
doc.Layers.FindByFullPath(layerName, -1)，返回 -1 表示未找到，报错当前文档不包含'{layerName}'图层 - 获取 Layer 对象 —
doc.Layers[layerIndex] - 逐项输出 — 从 Layer 对象提取 Name、Color、IsLocked、IsVisible、LinetypeIndex.Name 写入 5 个输出端口
⚠️ 查找失败：
FindByFullPath 对路径大小写敏感。输入前建议使用 物件图层 组件获取标准路径字符串，避免手工输入错误。🧪 典型使用场景
- 图层状态检查 — 判断图层是否锁定/隐藏，确保后续操作前解锁定/取消隐藏
- 图层色彩分析 — 获取图层颜色后统一分析图面配色方案
- 批量图档检查 — 结合
GetObjectByLayer组件逐个检查图层信息
📋 组件信息
| 名称 | 图层信息 |
| 英文名 | LI |
| 分类 | LK → Layer |
| 基类 | GH_Component |
| 特色 | 全路径查找、5属性输出、合法性校验 |
| GUID | {82D5B5FF-5E83-4F72-89A4-AAB38C0B229B} |
更新日期：2026-06-29