C# SolidWorks二次开发 - 玩转扫描（Sweep）命令，代码生成管道异型材

做过SolidWorks二次开发的老铁们都知道，手动画图画多了就想偷懒——尤其是画管道、线缆、异型材这些沿路径扫掠的东西的时候。今天我们就来聊聊怎么用代码实现扫描（Sweep）功能，让你从此告别手动画图！

什么是扫描（Sweep）？

简单说，扫描就是让一个截面轮廓沿着一条路径曲线跑一遍，生成三维实体。就像你拿个圆形模具沿着一条曲线挤过去，就能得到一根圆管。

在SolidWorks里手动操作是这样的：

画一个截面（圆、矩形、复杂形状都可以）
画一条路径（直线、曲线、样条曲线）
点「扫描」命令 → 搞定

用API实现？跟着往下看。

核心API是哪个？

在SolidWorks API里，创建扫描功能主要靠这几个对象：

// 扫描特征数据
SweepFeatureData swSweepData = (SweepFeatureData)swPart.FeatureManager.CreateDefinition(swFeatureSweep);

// 路径和截面要通过选择管理器来获取
ISelectionMgr swSelMgr = swDoc.SelectionManager;

敲黑板：和拉伸（Extrude）不同，扫描需要同时选中路径和截面，而且顺序很重要！

代码实现：手把手教学

来，直接上代码，看懂了你就能抄：

public void CreateSweep()
{
    // 连接SolidWorks（假设你已经连上了）
    SldWorks.SldWorks swApp = ConnectToSolidWorks();
    ModelDoc2 swDoc = (ModelDoc2)swApp.ActiveDoc;
    PartDoc swPart = (PartDoc)swDoc;
    SelectionMgr swSelMgr = (SelectionMgr)swDoc.SelectionManager;

    // 第一步：获取截面草图
    // 假设你的截面Sketch叫"ProfileSketch"
    swDoc.SelectByID2("ProfileSketch", "SKETCH", 0, 0, 0, false, 0, null, (int)swSelectOption_e.swSelectOptionDefault);
    
    // 第二步：获取路径草图
    // 假设你的路径Sketch叫"PathSketch" 
    swDoc.SelectByID2("PathSketch", "SKETCH", 0, 0, 0, true, 0, null, (int)swSelectOption_e.swSelectOptionDefault);

    // 第三步：创建扫描特征定义
    FeatureManager swFeatMgr = swPart.FeatureManager;
    swSweepFeatureData = (SweepFeatureData)swFeatMgr.CreateDefinition((int)swFeatureName_e.swFeatureNameSweep);
    
    // 第四步：设置扫描参数（可选）
    // 比如合并切线、保证轮廓垂直于路径等
    swSweepFeatureData.SetProfiles(0, 1);  // 1个截面
    swSweepFeatureData.SetPath(0, 1);       // 1条路径
    
    // 第五步：生成特征！
    Feature swFeature = swFeatMgr.CreateFeature(swSweepFeatureData);
    
    if (swFeature != null)
    {
        Console.WriteLine("扫描成功！管道生成完毕！");
    }
    else
    {
        Console.WriteLine("扫描失败，请检查路径和截面是否相交");
    }
}

常见坑与解决方案

坑1：截面和路径不在同一平面

代码报错"无法创建扫描特征"

解决：确保路径和截面都是3D草图，或者截面垂直于路径起点

坑2：路径有急转弯

扫描出来模型扭成一团

解决：在SweepFeatureData里设置SetGuideCurves()添加引导曲线，或者把路径打磨平滑一点

坑3：截面太复杂

扫描失败但没报错

解决：检查截面是否是闭合轮廓，开环截面只能做扫描切除

进阶玩法：异型管一键生成

掌握了基础，你可以玩更花的：

变径管道：在路径不同位置设置不同直径的截面（用ISweepFlare）
多层复合管：内外层不同材质，一次扫描成型
参数化建模：把截面尺寸、路径曲线都做成变量，用代码动态调整

想象一下：输入一个CSV文件，自动生成几百根不同规格的管道——这不比手动一个个画香多了？

总结

今天的干货就到这里。扫描命令是SolidWorks二次开发中非常实用的一个功能，尤其适合批量生成管道、线缆、异型材等沿着路径分布的模型。

记住核心口诀：先选截面，再选路径，定义特征，最后创建。

如果你在实际项目中遇到什么奇葩问题，欢迎在评论区聊聊，咱们一起debug！

下期预告：上次有人问装配体批量缩放，今天发现2025版本API对MathTransform做了大升级，敬请期待～