螺钉孔径 · 螺钉孔径
螺钉孔孔径选择器 — 按孔类型和规格筛选，输出对应的孔径数值
📖 功能概述
LK_ValueList 是一个 GH_Param 类参数输入组件（非标准GH组件），以自定义下拉列表的形式呈现。它集成了螺钉孔标准规格数据库，用户可按孔类型和材料类型筛选，快速选取所需的孔径值输出到下游组件。
💡 核心特性：
- 双重筛选 — 先选孔类型（过孔 / 工艺孔 / 底孔），再选规格（M3~M16），两层级联
- 自定义 UI 渲染 — 画布上显示为带条形图的可视化列表，高亮当前选中项
- Exposure = secondary — 组件出现在 LK→Hole 的次级（折叠）标签中，减少主面板杂乱
- 状态持久化 — 选中的孔类型 + 规格通过 Write/Read 保存到 .gh 文件中
🎛️ 操作方式
右键菜单
右键点击组件，弹出菜单包含两个分组：
| 分组 | 选项 | 说明 |
|---|---|---|
| 孔类型 | 过孔 / 工艺孔 / 底孔 | 切换孔类型后，列表中的孔径值自动更新为对应类型的标准值 |
| 型材类型 | 铝型材 / 钢型材 | 切换型材材质后（目前影响 GKR 系列的取值来源） |
自定义 UI 双击选择
双击组件可展开自定义的面板 UI，以可视化的方式显示所有规格条目及其对应孔径的条形图，当前选中项高亮显示，点击即可切换。
📊 孔径规格表
组件包含以下标准螺钉规格和对应的孔径数据（数据源自 ScrewListClass）：
| 规格 | 过孔 GKR (mm) | 工艺孔 GYKR (mm) | 底孔 DKR (mm) |
|---|---|---|---|
| M3 | 3.2 | 3.2 | 2.5 |
| M4 | 4.3 | 4.3 | 3.3 |
| M5 | 5.3 | 5.3 | 4.2 |
| M6 | 6.4 | 6.4 | 5.0 |
| M8 | 8.4 | 8.4 | 6.8 |
| M10 | 10.5 | 10.5 | 8.5 |
| M12 | 13.0 | 13.0 | 10.2 |
| M14 | 15.0 | 15.0 | 12.0 |
| M16 | 17.0 | 17.0 | 14.0 |
💡 注意：切换"过孔"时列表使用 GKR，"工艺孔"使用 GYKR，"底孔"使用 DKR。上述数据为铝型材（Sid2=0）时的值，钢型材时可能使用 GKR2。
📤 输出数据
组件输出类型为 Generic (IGH_Goo)，当前选中项的 值部分（Value）以字符串形式输出到数据流中。输出值是孔径的字符串表示（如 "6.4"）。
数据收集时机：组件在
CollectVolatileData_Custom 阶段将 _items[SelectedItemIndex].Value 追加到输出数据，路径为 GH_Path(0)，单数据项。
🧪 典型使用场景
- 孔系列设计 — 选择标准螺钉孔径，输出到后续的孔生成组件（如 点转圆孔 / 螺钉孔）作为直径输入
- BOM 孔径标记 — 与文本串联组件配合，生成带规格的孔标注
- 工艺选择分支 — 在同一流程中快速切换孔径标准，观察不同规格对型材孔位的适配效果
⚠️ 注意事项
- 这是一个 输入参数组件（GH_Param），不是标准组件。在画布上它没有输入端口，只有一个输出端口，数据方向是从本组件流出到下游。
- 如果切换孔类型后选中的规格索引超出新列表范围，会自动适配为最后一个有效索引。
- 组件暴露等级为
secondary，在 Grasshopper 面板中位于 LK→Hole 的次级（折叠）区域，需展开才能看到。 - 右键菜单的"型材类型"选择目前记录状态但不影响 GKR 切换逻辑（GKR/GKR2 的切换由 Sid2 控制）。
📋 组件信息
| 名称 | 螺钉孔径 |
| 英文名 | 螺钉孔径 (LK_ValueList) |
| 分类 | LK → Hole (次级) |
| 基类 | GH_Param<IGH_Goo> |
| Exposure | secondary |
| GUID | {9C5509FC-1712-4DC8-89FF-18FF8A45D493} |
更新日期：2026-06-29