用键检索物件 · Filter By Key

📖 功能概述

在 Rhino 文档中，根据用户自定义属性的键（Key）检索包含该键的所有物件。可以指定仅搜索部分物件（通过输入物件 ID），也可以搜索整个文档。

Rhino 物件可以附加自定义数据（User Dictionary / User Text），本组件让你通过 Key 来过滤查找——例如：查找所有具有 "楼层" 标签键的物件。

📥 输入参数

📤 输出参数

🧩 典型使用场景

• 数据管理 — 从所有带自定义属性的物件中筛选出具有特定标签的物件
• 工作流配合 — 配合 SetUserValue 等写入组件，读取已标记的物件
• 条件选择 — 通过 Key 是否存在来区分物件类别

⚠️ 注意事项

• 输入的键名区分大小写，需与写入时完全一致。
• 输出的是物件的 GUID（唯一标识符），而非物件本身。如需获取物件对象，可配合 GH 的物件相关组件使用。
• 通过输入指定 ID 列表可以缩小搜索范围，提高性能。

📋 组件信息