项选择器 · Selector
从预定义列表中选择一项，以参数形式输出到其他组件
📖 功能概述
这是一个特殊的参数输入组件（GH_Param），提供了一个下拉选择菜单，用户可从预定义的文本列表中选择一项，所选项会作为参数数据输出。与 Grasshopper 原生的 ValueList 组件不同，本组件支持动态更新列表内容——可通过代码或外部输入动态修改选择项，并在运行时通过 Shift 键双击 快速弹出选择窗口。
💡 特色功能：按住 Shift 键双击画布上的组件区域可快速弹出选择菜单，无需右键操作。
🎛️ 使用方式
方法一：右键菜单
- 右键点击组件，在弹出的菜单中可选择预设列表项
- 选择后组件自动更新输出值并触发重新求解
方法二：Shift + 双击
- 按住 Shift 键不放，双击组件区域
- 弹出选择对话框，从中选择一项
- 双击选择后自动确认并关闭对话框
数据输出
选择的当前值直接作为参数输出，可连接到其他组件：
| 名称 | 类型 | 说明 |
|---|---|---|
| 当前值 | Text | 当前选中的列表项文本值 |
⚙️ 工作方式
数据模式
- 组件使用
GH_ParamWireDisplay.hidden隐藏连线显示 - 通过
CollectData方法将当前选中的值收集到输出数据中 - 数据在
SolveInstance阶段输出，支持GH_ParamAccess.item单数据项
序列化持久化
组件通过 Write / Read 方法保存和恢复状态：
- 保存所有列表项（
_items） - 保存当前选中索引（
_selectedIndex） - 保存当前值（
_currentValue） - 下次打开 .gh 文件时自动恢复到上次的状态
🧪 典型使用场景
| 场景 | 说明 |
|---|---|
| 参数模板 | 在 LK 系统中预设多个型材规格、孔尺寸标准等，通过下拉菜单快速切换。 |
| 模式切换 | 作为自定义开关，在不同处理模式间切换，驱动下游组件执行不同的逻辑。 |
| 动态列表选择 | 配合 RemoteParam 组件，实现远程列表项管理和选择。 |
⚠️ 注意事项
- 本组件是 GH_Param 类型，在 Grasshopper 中表现为输入参数，放置在画布上不带输入端口。
- 其输出端口为 Generic 类型，可连接到任何接受文本或通用数据的组件输入端。
- 默认只有一项 "LK" 作为初始占位，实际使用前需通过代码添加更多列表项。
- 组件在
GH_ParamWireDisplay.hidden模式下显示为不透明的端口。 - 类名
LK_ItemSelector，位于LK.Component.LK_Telepathy命名空间。
📋 组件信息
| 名称 | 项选择器 |
| 英文名 | Selector |
| 分类 | LK → Telepathy |
| 基类 | GH_Param<IGH_Goo> |
| GUID | {1D50BD47-D4C8-4938-88CB-BA82B7D56A80} |