Inventor 二次开发从入门到精通（4）

4.1 Application 对象：Inventor 的入口

Application对象是 Inventor API 的根对象，所有操作都从这里开始。其核心功能包括：

• 管理文档（创建、打开、保存、关闭）；
• 访问用户界面（功能区、命令、对话框）；
• 提供几何工具（创建点、向量、矩阵等）；
• 控制 Inventor 的运行状态（可见性、自动更新等）。

4.1.1 获取 Application 对象的两种方式

方式 1：连接已运行的 Inventor 实例

private Application GetInventorApp() { Application invApp = null; try { // 尝试连接已运行的Inventor invApp = (Application)System.Runtime.InteropServices.Marshal.GetActiveObject("Inventor.Application"); } catch (Exception ex) { // 若未运行，抛出异常或启动新实例 throw new Exception("未找到运行的Inventor实例：" + ex.Message); } return invApp; }

方式 2：启动新的 Inventor 实例

private Application StartInventorApp() { Application invApp = null; try { // 获取Inventor的类型 Type invType = Type.GetTypeFromProgID("Inventor.Application"); // 创建实例 invApp = (Application)Activator.CreateInstance(invType); // 显示界面 invApp.Visible = true; // 禁用自动更新（提升性能） invApp.ScreenUpdating = false; } catch (Exception ex) { throw new Exception("启动Inventor失败：" + ex.Message); } return invApp; }

4.1.2 Application 对象的常用属性和方法

4.2 文档的基本操作

4.2.1 创建新文档

Inventor 支持创建多种类型的文档，通过Documents.Add()方法实现：

// 创建零件文档 Document partDoc = _inventorApp.Documents.Add(DocumentTypeEnum.kPartDocumentObject); // 创建装配体文档 Document assyDoc = _inventorApp.Documents.Add(DocumentTypeEnum.kAssemblyDocumentObject); // 创建工程图文档 Document drawDoc = _inventorApp.Documents.Add(DocumentTypeEnum.kDrawingDocumentObject); // 创建表达视图文档 Document presentationDoc = _inventorApp.Documents.Add(DocumentTypeEnum.kPresentationDocumentObject);

4.2 文档的基本操作

4.2.1 创建新文档

Inventor 支持创建多种类型的文档，通过Documents.Add()方法实现：

// 创建零件文档 Document partDoc = _inventorApp.Documents.Add(DocumentTypeEnum.kPartDocumentObject); // 创建装配体文档 Document assyDoc = _inventorApp.Documents.Add(DocumentTypeEnum.kAssemblyDocumentObject); // 创建工程图文档 Document drawDoc = _inventorApp.Documents.Add(DocumentTypeEnum.kDrawingDocumentObject); // 创建表达视图文档 Document presentationDoc = _inventorApp.Documents.Add(DocumentTypeEnum.kPresentationDocumentObject);

4.2.2 打开现有文档

使用Documents.Open()方法打开本地文档：

// 定义文档路径 string docPath = @"D:\InventorFiles\Sample.part"; // 打开文档（只读模式） Document doc = _inventorApp.Documents.Open(docPath, false);

注意：路径需使用绝对路径，且需保证文件存在，否则会抛出异常。

4.2.3 保存文档

文档的保存分为Save()（保存当前文档）和SaveAs()（另存为）：

// 保存当前文档 _inventorApp.ActiveDocument.Save(); // 另存为新文件 string newPath = @"D:\InventorFiles\NewSample.part"; _inventorApp.ActiveDocument.SaveAs(newPath, false);

4.2.4 关闭文档

使用Document.Close()方法关闭文档，可指定是否保存更改：

// 关闭文档并保存更改 _inventorApp.ActiveDocument.Close(true); // 关闭文档不保存更改 _inventorApp.ActiveDocument.Close(false);

4.2.5 遍历所有打开的文档

foreach (Document doc in _inventorApp.Documents) { string info = $"文档名称：{doc.DisplayName}，类型：{doc.DocumentType}"; _inventorApp.UserInterfaceManager.MessageBox.Show(info); }

4.3 几何对象的创建与操作

Inventor 的TransientGeometry对象提供了创建临时几何对象的方法，这些对象不存储在文档中，仅用于计算和建模。

4.3.1 点（Point）的创建

// 创建三维点 Point p1 = _inventorApp.TransientGeometry.CreatePoint(10, 20, 30); // 创建二维点（Z坐标为0） Point p2 = _inventorApp.TransientGeometry.CreatePoint(50, 50, 0); // 获取点的坐标 double x = p1.X; double y = p1.Y; double z = p1.Z;

4.3.2 向量（Vector）的创建与运算

// 创建向量 Vector v1 = _inventorApp.TransientGeometry.CreateVector(1, 0, 0); Vector v2 = _inventorApp.TransientGeometry.CreateVector(0, 1, 0); // 向量相加 Vector v3 = v1.Add(v2); // 向量点乘 double dot = v1.DotProduct(v2); // 向量叉乘 Vector cross = v1.CrossProduct(v2); // 向量归一化 v1.Normalize();

4.3.3 矩阵（Matrix）的创建与变换

矩阵用于实现几何对象的平移、旋转、缩放等变换：

// 创建单位矩阵 Matrix matrix = _inventorApp.TransientGeometry.CreateMatrix(); // 平移变换（沿X轴移动10） matrix.SetTranslation(_inventorApp.TransientGeometry.CreateVector(10, 0, 0)); // 旋转变换（绕Z轴旋转90度） matrix.SetRotation(_inventorApp.TransientGeometry.CreateVector(0, 0, 1), Math.PI / 2);

4.4 参数的管理与修改

参数是 Inventor 参数化建模的核心，通过 API 可实现参数的创建、修改和查询。

4.4.1 访问现有参数

PartDocument partDoc = (PartDocument)_inventorApp.ActiveDocument; // 获取参数集合 Parameters paramsCollection = partDoc.ComponentDefinition.Parameters; // 通过名称访问尺寸参数 ModelParameter lengthParam = (ModelParameter)paramsCollection["Length"]; // 修改参数值 lengthParam.Value = 150; // 通过类型筛选参数 foreach (Parameter param in paramsCollection) { if (param.Type == ParameterTypeEnum.kModelParameter) { _inventorApp.UserInterfaceManager.MessageBox.Show($"参数名：{param.Name}，值：{param.Value}"); } }

4.4.2 创建新参数

// 创建模型参数（长度） ModelParameter newParam = partDoc.ComponentDefinition.Parameters.ModelParameters.Add( "Width", // 参数名 UnitTypeEnum.kMillimeterLengthUnits, // 单位 80 // 初始值 ); // 创建用户参数（整数） UserParameter userParam = partDoc.ComponentDefinition.Parameters.UserParameters.AddByValue( "Count", // 参数名 5, // 初始值 UnitTypeEnum.kIntegerUnits // 单位 );

4.5 事务的高级使用

事务可用于批量操作的管理，支持嵌套和撤销 / 重做：

// 创建父事务 Transaction parentTrans = _inventorApp.TransactionManager.CreateTransaction(partDoc, "批量创建特征"); parentTrans.Start(); // 创建子事务 Transaction childTrans1 = _inventorApp.TransactionManager.CreateTransaction(partDoc, "创建拉伸"); childTrans1.Start(); // 执行拉伸创建操作 childTrans1.End(); Transaction childTrans2 = _inventorApp.TransactionManager.CreateTransaction(partDoc, "创建孔"); childTrans2.Start(); // 执行孔创建操作 childTrans2.End(); // 提交父事务 parentTrans.End(); // 撤销父事务（会同时撤销子事务） // parentTrans.Undo(); // 重做父事务 // parentTrans.Redo();