工程文件 · 函数

IFC实体查询

使用 ifcopenshell 按类型查询 IFC 实体。

调用签名(模型, 实体类型: 'str')

IZHONGWEN
PYTHON

Chinese example

中文代码示例

# 案例：工程文件入口
设 功能 = 工程文件.IFC实体查询
打印(功能)

可直接放进 .cs / .中py 文件运行。转换器会把中文代码交给真实 Python 解释器。

Parameters

参数说明

2 个参数

参数类型 / 传入方式说明

模型可选 · 默认无

未声明位置参数或字段名=值

按函数业务含义传入模型;首次使用建议先打印(结果) 确认其作用。

常见错误：漏传或对象为 None 会报 TypeError/AttributeError;先调用对应的创建函数拿到模型再传入

实体类型可选 · 默认无

str位置参数或字段名=值

要创建或处理的对象类型，例如按钮、标签、表格、输入框。

常见错误：漏传会报 TypeError: missing required argument: '实体类型';检查调用是否漏了这行

Playbook

基础用法 · 进阶组合 · 错误排查

# 案例：工程文件入口
设 功能 = 工程文件.IFC实体查询
打印(功能)

# 进阶组合:IFC实体查询 配合 工程文件 业务流使用
设 图纸 = 工程文件.读取DXF("outputs/图纸.dxf")
设 结果 = 工程文件.IFC实体查询(
    模型=模型,  # 必填
    实体类型="示例",  # 必填
)
工程文件.保存DXF("outputs/修改后.dxf", 图纸)
打印(结果)

# 错误排查:覆盖 2 个必填参数

## 参数 1: 模型
# 错误:漏传会报 TypeError: missing required argument
# 设 结果 = 工程文件.IFC实体查询()  # TypeError
# 修复:补上必填字段
设 结果 = 工程文件.IFC实体查询(模型=模型)

## 参数 2: 实体类型
# 错误:类型名拼写错误会报 KeyError/ValueError
# 设 结果 = 工程文件.IFC实体查询(实体类型="不存在的类型")  # KeyError
# 修复:用 类型清单() 确认可用类型名
设 结果 = 工程文件.IFC实体查询(实体类型="示例")
打印(结果)