根据键、值检索物件 · Filter By Key Value
根据物件的自定义字典键（Key）和值（Value）同时匹配，检索物件
📖 功能概述
在 Rhino 文档中，根据自定义属性的键（Key）和值（Value）同时匹配，检索符合条件的物件。例如查找 Key="类型" 且 Value="窗" 的所有窗构件。
相比 FilterByKey，这个组件可以更精确地筛选——既要有这个标签，值也要匹配。
💡 对比：FilterByKey 只检查是否有某个键，不关心值是什么；FilterByKeyValue 同时检查键和值是否都匹配。
📥 输入参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 键 (K) | Text | 必需 | 用来检索的信息键。 |
| 值 (V) | Text | 必需 | 用来检索的信息值，需要为数字类或字符类。 |
| ID (G) | Guid | 可选 | 要检索的物件 ID 列表。不输入则检索当前文档所有物件。 |
📤 输出参数
| 名称 | 类型 | 说明 |
|---|---|---|
| ID (G) | Guid | 符合条件的物件 GUID 列表。 |
🧩 典型使用场景
- 精确筛选 — 查找特定类型且特定值的物件，如 Key="材料" Value="钢"
- 条件过滤 — 批量操作前，筛选出满足某些属性的物件集合
- 数据导出 — 按属性条件提取物件用于报表或导出
⚠️ 注意事项
- 键名和值都区分大小写。
- 值的比较为精确字符串比较，不支持正则或通配符。
- 输出为 GUID 列表，如需获取物件对象需配合其他组件。
📋 组件信息
| 名称 | 根据键、值检索物件 |
| 英文名 | Filter By Key Value (FKV) |
| 分类 | LK → User |
| Exposure | secondary |
| GUID | FC328390-F8ED-4EB7-8DD2-673D0BADB459 |