告别枯燥Demo：用C#给SolidWorks插件加个‘撤销’和‘宏录制’功能（附完整代码）

解锁SolidWorks插件高阶能力：C#实现撤销栈与宏录制实战

在机械设计与工程领域，SolidWorks作为主流三维CAD软件，其二次开发能力为专业用户提供了无限可能。但许多开发者止步于基础功能实现，忽略了商业级插件必备的撤销操作和宏录制两大核心体验。本文将深入探讨如何通过C#为SolidWorks插件注入这两项关键能力，让你的自定义工具拥有与原生功能相媲美的专业交互体验。

1. 理解SolidWorks命令架构与扩展机制

1.1 原生命令系统的运作原理

SolidWorks的命令管理采用分层架构：

• 命令组(CommandGroup)：逻辑相关的命令集合
• 命令项(CommandItem)：具体可执行的操作单元
• 命令标签页(CommandTab)：UI层面的工具栏组织

// 典型命令组创建示例 ICommandGroup cmdGroup = iCmdMgr.CreateCommandGroup2( groupId, "自定义工具", "高级功能集合", "", -1, false, ref cmdGroupErr);

原生撤销系统通过操作堆栈实现，每个可撤销操作包含：

1. 操作前状态快照
2. 逆向执行逻辑
3. 操作描述信息

1.2 插件命令的特殊性挑战

自定义插件命令面临的核心问题：

• 无自动撤销支持：需要手动维护状态变更
• 宏录制盲区：默认不记录插件操作
• 上下文感知缺失：需自行处理文档状态

提示：SolidWorks API中的IModelDocExtension接口提供了部分文档状态管理方法，可作为开发基础。

2. 构建可撤销的操作系统

2.1 设计撤销栈数据结构

实现高效撤销系统需要以下核心组件：

// 操作封装示例 public class SWOperation { public Action Execute { get; set; } public Action Undo { get; set; } public string Description { get; set; } public void Perform() { Execute?.Invoke(); UndoStack.Push(this); } }

2.2 与SolidWorks原生撤销系统集成

通过ISldWorks::AddUndoableAction实现深度集成：

// 注册可撤销操作 swApp.AddUndoableAction( "添加自定义特征", // 操作描述 (int)swUndoActionType_e.swUndoAction_ModelChange, // 操作类型 myCustomUndoHandler // 自定义撤销处理器 );

关键参数说明：

• swUndoActionType_e：定义操作影响的范畴
• 撤销处理器需实现特定接口方法

3. 实现宏录制功能

3.1 宏录制原理剖析

SolidWorks宏录制器本质是：

1. 监听UI操作事件
2. 生成对应API调用序列
3. 存储为VBA兼容代码

插件需要模拟这一过程：

// 伪代码：宏录制触发流程 public void RecordAction(string apiCall) { if (swApp.IsRecordingMacro) { var macro = swApp.GetRunningMacro(); macro.AddCode(GenerateVBAEquivalent(apiCall)); } }

3.2 关键API接口

• ISldWorks::IsRecordingMacro：检测录制状态
• IMacro::AddCode：注入自定义代码
• IModelDoc2::StartRecordingMacro：手动触发录制

注意：录制代码需考虑SolidWorks版本兼容性，建议使用最稳定的API子集

4. 实战：为特征生成器添加专业支持

4.1 案例背景

假设我们开发了一个参数化齿轮生成器插件，现在需要：

1. 支持Ctrl+Z撤销生成操作
2. 允许录制生成过程用于批量生产

4.2 撤销功能实现步骤

1. 创建操作包装器：

public class GearCreationOperation : ISWOperation { private readonly ISldWorks swApp; private readonly IFeature gearFeature; public GearCreationOperation(IFeature feature) { this.gearFeature = feature; this.swApp = SwAddin.Application; } public void Undo() { gearFeature.Select2(false, -1); swApp.DeleteSelection(); } }

2. 集成到命令流程：

public void CreateGear() { var feature = GenerateGearFeature(); // 实际生成逻辑 var operation = new GearCreationOperation(feature); swApp.AddUndoableAction( "创建齿轮", (int)swUndoActionType_e.swUndoAction_FeatureDelete, operation); }

4.3 宏录制集成方案

public void RecordGearCreation(double module, int teeth) { if (swApp.IsRecordingMacro) { string code = $@"Part.FeatureManager.InsertProtrusionBlob2( {module}, {teeth}, swBlobType_e.swBlobType_Gear, swBlobOptions_e.swBlobDefault)"; swApp.GetRunningMacro().AddCode(code); } }

5. 性能优化与异常处理

5.1 内存管理策略

• 采用弱引用存储大型模型状态
• 实现LRU缓存淘汰机制
• 对复杂操作使用差异存储

// 差异存储示例 public class DiffState : IUndoState { private Dictionary<string, object> _changes; public void Capture(IModelDoc doc) { // 仅存储变更属性 _changes = DetectChanges(doc); } public void Restore(IModelDoc doc) { ApplyChanges(doc, _changes); } }

5.2 错误恢复机制

建议实现以下安全措施：

1. 操作前自动创建恢复点
2. 提供操作回滚超时保护
3. 记录详细的操作日志

try { using (var transaction = StartTransaction()) { PerformCriticalOperation(); transaction.Commit(); } } catch (Exception ex) { swApp.SendMsgToUser($"操作失败: {ex.Message}"); TryRestoreBackup(); }

在开发过程中，我发现最棘手的不是功能实现本身，而是处理用户连续快速操作时的状态同步问题。通过引入操作队列和状态版本控制，最终实现了稳定的撤销体验。