3.1 Inventor API 的架构设计
Inventor API 采用COM 组件架构,基于面向对象的设计思想,所有操作都通过对对象的调用实现。其核心架构可分为三层:
- 应用层(Application):代表 Inventor 应用程序本身,是所有对象的根节点;
- 文档层(Document):包括零件文档、装配体文档、工程图文档等,是模型数据的容器;
- 对象层(Object):包括实体、特征、参数、尺寸等具体的模型对象。
3.2 核心对象与命名空间
3.2.1 常用命名空间
Inventor API 的核心命名空间为Inventor,其中包含了所有的类和枚举:
Inventor.Application:应用程序对象,全局唯一;Inventor.Document:文档基类,派生为PartDocument、AssemblyDocument、DrawingDocument等;Inventor.ComponentDefinition:组件定义,包含零件或装配体的核心模型数据;Inventor.Feature:特征对象,如拉伸、旋转、孔特征等。
3.2.2 核心对象的层次关系
Inventor 对象模型的核心层次如下:
Application(应用程序) ├── Documents(文档集合) │ ├── PartDocument(零件文档) │ │ ├── ComponentDefinition(组件定义) │ │ │ ├── Features(特征集合) │ │ │ ├── WorkPlanes(工作平面集合) │ │ │ └── Parameters(参数集合) │ │ └── ModelGeometry(模型几何) │ ├── AssemblyDocument(装配体文档) │ │ ├── ComponentDefinition │ │ │ ├── Occurrences(零部件实例集合) │ │ │ └── Constraints(约束集合) │ └── DrawingDocument(工程图文档) │ ├── Sheets(图纸集合) │ └── Views(视图集合) └── UserInterfaceManager(用户界面管理器) ├── Ribbons(功能区集合) └── CommandManager(命令管理器)3.3 对象的创建与访问方式
在 Inventor API 中,对象的访问和创建主要有三种方式:
3.3.1 通过集合对象创建
集合对象(如Features、WorkPlanes)通常提供AddXXX()方法,用于创建新对象:
// 在零件文档中创建拉伸特征 PartDocument partDoc = (PartDocument)_inventorApp.ActiveDocument; // 获取草图(假设已创建草图) PlanarSketch sketch = partDoc.ComponentDefinition.Sketches[1]; // 创建拉伸特征 ExtrusionFeature extrusion = partDoc.ComponentDefinition.Features.ExtrusionFeatures.Add( sketch.Profiles[1], // 轮廓 10, // 拉伸距离 PartFeatureOperationEnum.kJoinOperation // 操作类型 );3.3.2 通过索引或名称访问
集合对象支持通过索引(从 1 开始)或名称访问已有对象:
// 通过索引访问第一个工作平面 WorkPlane wp = partDoc.ComponentDefinition.WorkPlanes[1]; // 通过名称访问参数 Parameter param = partDoc.ComponentDefinition.Parameters["Length"];3.3.3 通过遍历集合访问
使用循环遍历集合,可批量处理对象:
// 遍历零件中的所有特征 foreach (Feature feature in partDoc.ComponentDefinition.Features) { _inventorApp.UserInterfaceManager.MessageBox.Show("特征名称:" + feature.Name); }3.4 枚举类型的使用
Inventor API 大量使用枚举类型(Enum)来定义操作类型、对象状态等,常用枚举包括:
PartFeatureOperationEnum:零件特征操作类型(如 kJoinOperation、kCutOperation);DocumentTypeEnum:文档类型(如 kPartDocumentObject、kAssemblyDocumentObject);SketchEntityTypeEnum:草图实体类型(如 kLineSketchEntity、kCircleSketchEntity)。
使用枚举时,需引入Inventor命名空间,直接通过枚举名访问:
// 定义拉伸操作类型为“切割” PartFeatureOperationEnum opType = PartFeatureOperationEnum.kCutOperation;3.5 事务与撤销操作
Inventor API 支持事务(Transaction)管理,可将多个操作封装为一个事务,实现一次性撤销:
// 创建事务 Transaction trans = _inventorApp.TransactionManager.CreateTransaction(partDoc, "创建拉伸和孔特征"); // 启动事务 trans.Start(); // 执行多个操作 ExtrusionFeature extrusion = partDoc.ComponentDefinition.Features.ExtrusionFeatures.Add(...); HoleFeature hole = partDoc.ComponentDefinition.Features.HoleFeatures.Add(...); // 提交事务 trans.End(); // 撤销事务(可选) // trans.Undo();3.6 API 中的数据类型
Inventor API 使用的核心数据类型包括:
- 数值类型:double(用于距离、角度等)、int(用于索引);
- 几何类型:Point(点)、Vector(向量)、Matrix(矩阵)、Rectangle(矩形);
- 字符串类型:string(用于名称、路径等);
- 布尔类型:bool(用于状态判断)。
其中,几何类型是建模的核心,例如:
// 创建一个点(坐标X=0,Y=0,Z=0) Point origin = _inventorApp.TransientGeometry.CreatePoint(0, 0, 0); // 创建一个向量(X方向) Vector xVec = _inventorApp.TransientGeometry.CreateVector(1, 0, 0);