BIM学习高阶(Day 2).pdf

Revit API开发培训 （Day 2） 北京互联立方技术服务有限公司 上海比程信息技术有限公司 Agenda • Element 参数读取和修改 • Transaction API （事务） • 元素创建 • 导入、导出等 Element 参数 参数读取 Revit属性界面 二次开发出来的界面 四种参数类型 • 整形(枚举/布尔/数量) • 浮点(长度、面积…) • 文本(字符串) • 元素ID(类型，材质…) • 注：浮点数的单位始终是英制！ 四种参数类型 元素的参数集 • Element.Parameters可得到所有参数集。 • Parameter得到每一个参数的详细信息。 • Parameter.Definition定义参数名字、参数组。 读取一个参数 • 参数名字、类型、值 • AsDouble/AsInteger/AsString/AsElementId. • AsValueString 修改参数 • 只能修改参数的值 • Set(…)和SetValueString(…) 通过BuiltInParameter得参数 • 通过指定BuiltInParameter得到参数 • 接近3000个内建参数标识！ Parameter Element[BuiltInParameter parameterId] { get; } 通过名字得参数 • 可以指定参数名得到参数 Parameter Element[string paramName] { get; } 其他 • 长度单位始终为英制单位 • 枚举类型的参数实为整形参数 • 可以带单位设定setValueString() • 先判断IsReadOnly并指定匹配的值 * Family Parameters在另一章节 Element类别(Category) • Element都属于某一个Category • ElementType也属于同一个Category • Family/Symbol/Instance属于用一个Category • Category.Id标识类别信息 • 对应BuiltInCagetory的枚举值 EX1: Element及Parameter • 尝试得到某一元素所支持的BuiltInParameter。 • 将参数按ParameterGroup,可读、只读、共享等 分类。 • Optional: 尝试修改一个ElementId类型的参数 （如Level）。 Transaction （事务） 三种类型 • Transaction(T) - the main transaction class that guards changes to documents • TransactionGroup(TG) - optional class to manage several transactions at once • SubTransaction(ST) - optional class to scope tasks inside a transaction 说明1 T仅在修改Document时需要，ST/TG不是必须 的，只是为了更好的组织修改。 “Only Transactions are necessary in order to make changes to a document. Neither TG or ST are needed. They are only used to better “organize” the changes.” 说明2 修改的唯一性：Transaction不可嵌套。 “Transactions may not nests, which means that only one transaction per document at any time is allowed to be open 。” 说明3 ST必须在T启动后启动，必须在T关闭前关闭。 “A Sub-transaction can only be started in an open transaction and it must