告别枯燥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 插件命令的特殊性挑战
自定义插件命令面临的核心问题：
- 无自动撤销支持：需要手动维护状态变更
- 宏录制盲区：默认不记录插件操作
- 上下文感知缺失：需自行处理文档状态
提示：SolidWorks API中的
IModelDocExtension接口提供了部分文档状态管理方法，可作为开发基础。
2. 构建可撤销的操作系统
2.1 设计撤销栈数据结构
实现高效撤销系统需要以下核心组件：
| 组件类型 | 职责描述 | 实现要点 |
|---|---|---|
| 命令封装器 | 包装原始操作及其逆操作 | 需保存足够的状态信息 |
| 堆栈管理器 | 维护undo/redo双栈 | 限制栈深度防止内存溢出 |
| 状态快照服务 | 捕获操作前后文档差异 | 增量存储优化性能 |
| 事务协调器 | 将多个操作合并为原子单元 | 提供begin/commit/rollback接口 |
// 操作封装示例 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宏录制器本质是：
- 监听UI操作事件
- 生成对应API调用序列
- 存储为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 案例背景
假设我们开发了一个参数化齿轮生成器插件，现在需要：
- 支持Ctrl+Z撤销生成操作
- 允许录制生成过程用于批量生产
4.2 撤销功能实现步骤
- 创建操作包装器：
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(); } }- 集成到命令流程：
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 错误恢复机制
建议实现以下安全措施：
- 操作前自动创建恢复点
- 提供操作回滚超时保护
- 记录详细的操作日志
try { using (var transaction = StartTransaction()) { PerformCriticalOperation(); transaction.Commit(); } } catch (Exception ex) { swApp.SendMsgToUser($"操作失败: {ex.Message}"); TryRestoreBackup(); }在开发过程中，我发现最棘手的不是功能实现本身，而是处理用户连续快速操作时的状态同步问题。通过引入操作队列和状态版本控制，最终实现了稳定的撤销体验。