SolidWorks二次开发：获取选中零件名称的C#实现-代码聚汇网

SolidWorks二次开发：获取选中零件名称的C#实现

小狐狸与小道士

1. SolidWorks二次开发基础与环境准备

在开始编写获取选中零件名称的代码之前，我们需要先搭建好开发环境。SolidWorks提供了完善的API接口，允许开发者通过多种编程语言进行二次开发，其中C#是最常用的选择之一。

1.1 开发环境配置

首先确保你的开发环境中已经安装以下组件：

Visual Studio 2019或更高版本
SolidWorks 2018或更高版本（建议使用与开发环境匹配的版本）
SolidWorks API SDK（通常随SolidWorks安装包一起安装）

在Visual Studio中创建新项目时，选择"类库"项目模板。然后需要通过NuGet包管理器或直接添加引用的方式，将SolidWorks的互操作程序集引入项目：

csharp复制// 在项目中添加以下引用
using SolidWorks.Interop.sldworks;
using SolidWorks.Interop.swconst;

1.2 连接SolidWorks应用程序

与SolidWorks建立连接是二次开发的第一步。以下是建立连接的典型方法：

csharp复制public static SldWorks ConnectToSolidWorks()
{
    try
    {
        // 方法1：通过运行中的SolidWorks实例连接
        SldWorks swApp = (SldWorks)Marshal.GetActiveObject("SldWorks.Application");
        
        // 方法2：如果SolidWorks未运行，则启动新实例
        if(swApp == null)
        {
            Type swType = Type.GetTypeFromProgID("SldWorks.Application");
            swApp = (SldWorks)Activator.CreateInstance(swType);
            swApp.Visible = true;
        }
        
        return swApp;
    }
    catch(Exception ex)
    {
        Console.WriteLine($"连接失败: {ex.Message}");
        return null;
    }
}

提示：在实际应用中，建议添加重试机制和超时处理，因为SolidWorks启动可能需要较长时间。

2. 获取选中零件的核心实现

2.1 选择管理器(SelectionMgr)详解

SolidWorks通过SelectionMgr对象管理当前文档中的选中状态。要获取选中对象，我们需要先获取当前活动文档，然后通过文档的SelectionManager属性访问选择管理器：

csharp复制ModelDoc2 swModel = (ModelDoc2)swApp.ActiveDoc;
if(swModel == null)
{
    Console.WriteLine("错误：没有活动的SolidWorks文档");
    return;
}

SelectionMgr swSelMgr = (SelectionMgr)swModel.SelectionManager;
int selCount = swSelMgr.GetSelectedObjectCount();

SelectionMgr提供了多种方法来获取选中对象的信息：

GetSelectedObjectCount(): 获取选中对象的数量
GetSelectedObject(): 获取特定索引的选中对象
GetSelectedObjectType(): 获取选中对象的类型
GetSelectedObjectType2(): 更详细的类型信息

2.2 零件与组件的类型判断

在SolidWorks装配体中，我们需要区分零件(Part)和组件(Component)。组件是装配体中的实例，可能包含额外的装配信息。判断选中对象类型的代码如下：

csharp复制int selType = swSelMgr.GetSelectedObjectType(i);
if(selType == (int)swSelectType_e.swSelCOMPONENTS)
{
    // 处理组件逻辑
}
else if(selType == (int)swSelectType_e.swSelBODIES)
{
    // 处理实体逻辑
}

swSelectType_e枚举定义了SolidWorks中所有可能的选中类型，常用的有：

swSelCOMPONENTS: 装配体中的组件
swSelBODIES: 实体几何体
swSelEDGES: 边线
swSelFACES: 面
swSelDIMENSIONS: 尺寸

2.3 获取零件名称的完整实现

结合上述知识，完整的获取选中零件名称的实现如下：

csharp复制public static void GetSelectedComponentNames(SldWorks swApp)
{
    try
    {
        ModelDoc2 swModel = (ModelDoc2)swApp.ActiveDoc;
        if(swModel == null)
        {
            Console.WriteLine("错误：没有活动的SolidWorks文档");
            return;
        }

        SelectionMgr swSelMgr = (SelectionMgr)swModel.SelectionManager;
        int selCount = swSelMgr.GetSelectedObjectCount();
        
        Console.WriteLine($"选中对象数量: {selCount}");
        
        for(int i = 1; i <= selCount; i++)
        {
            object selectedObj = swSelMgr.GetSelectedObject(i);
            int selType = swSelMgr.GetSelectedObjectType(i);
            
            if(selType == (int)swSelectType_e.swSelCOMPONENTS)
            {
                Component2 component = (Component2)selectedObj;
                string componentName = component.Name2;
                string componentPath = component.GetPathName();
                
                Console.WriteLine($"组件名称: {componentName}");
                Console.WriteLine($"完整路径: {componentPath}");
                
                // 获取关联的零件文档
                ModelDoc2 componentModel = (ModelDoc2)component.GetModelDoc();
                if(componentModel != null)
                {
                    string partName = componentModel.GetTitle();
                    Console.WriteLine($"关联零件名称: {partName}");
                }
            }
            else
            {
                Console.WriteLine($"对象{i}不是组件，类型为: {(swSelectType_e)selType}");
            }
        }
    }
    catch(Exception ex)
    {
        Console.WriteLine($"发生错误: {ex.Message}");
    }
}

3. 高级功能与扩展实现

3.1 获取零件的自定义属性

在实际应用中，我们通常需要获取零件的更多信息，而不仅仅是名称。SolidWorks允许为零件和组件添加自定义属性：

csharp复制public static void GetComponentProperties(Component2 component)
{
    ModelDoc2 model = (ModelDoc2)component.GetModelDoc();
    if(model == null) return;
    
    CustomPropertyManager propMgr = model.Extension.CustomPropertyManager[""];
    string[] propNames = (string[])propMgr.GetNames();
    
    Console.WriteLine("自定义属性:");
    foreach(string name in propNames)
    {
        string value = "";
        string resolvedValue = "";
        propMgr.Get2(name, out value, out resolvedValue);
        Console.WriteLine($"{name}: {resolvedValue}");
    }
}

3.2 批量处理选中对象

对于需要批量处理多个选中对象的场景，我们可以扩展功能以支持更复杂的操作：

csharp复制public class SelectedComponentInfo
{
    public string Name { get; set; }
    public string Path { get; set; }
    public string Material { get; set; }
    public double Mass { get; set; }
    public Dictionary<string, string> Properties { get; set; }
}

public static List<SelectedComponentInfo> GetSelectedComponentsInfo(SldWorks swApp)
{
    var components = new List<SelectedComponentInfo>();
    
    ModelDoc2 swModel = (ModelDoc2)swApp.ActiveDoc;
    if(swModel == null) return components;
    
    SelectionMgr swSelMgr = (SelectionMgr)swModel.SelectionManager;
    int selCount = swSelMgr.GetSelectedObjectCount();
    
    for(int i = 1; i <= selCount; i++)
    {
        int selType = swSelMgr.GetSelectedObjectType(i);
        if(selType != (int)swSelectType_e.swSelCOMPONENTS) continue;
        
        Component2 component = (Component2)swSelMgr.GetSelectedObject(i);
        ModelDoc2 componentModel = (ModelDoc2)component.GetModelDoc();
        
        var info = new SelectedComponentInfo
        {
            Name = component.Name2,
            Path = component.GetPathName(),
            Properties = new Dictionary<string, string>()
        };
        
        if(componentModel != null)
        {
            // 获取材质信息
            MaterialProperty material = componentModel.MaterialPropertyValue;
            if(material != null)
            {
                info.Material = material.Name;
            }
            
            // 获取质量属性
            MassProperty massProp = (MassProperty)componentModel.Extension.CreateMassProperty();
            if(massProp != null)
            {
                info.Mass = massProp.Mass;
            }
            
            // 获取自定义属性
            CustomPropertyManager propMgr = componentModel.Extension.CustomPropertyManager[""];
            string[] propNames = (string[])propMgr?.GetNames() ?? new string[0];
            foreach(string name in propNames)
            {
                string value = "", resolvedValue = "";
                propMgr.Get2(name, out value, out resolvedValue);
                info.Properties[name] = resolvedValue;
            }
        }
        
        components.Add(info);
    }
    
    return components;
}

4. 常见问题与调试技巧

4.1 常见错误处理

在开发过程中，可能会遇到以下常见问题：

COM异常：SolidWorks API大量使用COM接口，可能会抛出COM异常。处理建议：

csharp复制try
{
    // SolidWorks API调用
}
catch(COMException comEx)
{
    Console.WriteLine($"COM错误: 0x{comEx.ErrorCode:X8} - {comEx.Message}");
    // 尝试释放资源并重新连接
}

空引用异常：许多API调用可能返回null。良好的做法是始终检查返回值：

csharp复制ModelDoc2 doc = (ModelDoc2)swApp.ActiveDoc;
if(doc == null)
{
    Console.WriteLine("没有活动文档");
    return;
}

类型转换错误：确保正确转换接口类型。可以使用as运算符进行安全转换：

csharp复制Component2 component = selectedObj as Component2;
if(component == null)
{
    Console.WriteLine("选中的对象不是组件");
    continue;
}

4.2 调试技巧

启用SolidWorks API日志：

csharp复制swApp.SetUserPreferenceIntegerValue((int)swUserPreferenceIntegerValue_e.swFileOpenLoggingLevel, 3);

检查API调用的返回值：许多SolidWorks API方法返回布尔值表示成功或失败，不要忽略这些返回值。
使用SolidWorks宏录制功能：当不确定如何使用某个API时，可以先在SolidWorks中录制宏，然后查看生成的VBA代码作为参考。
性能优化：频繁的API调用会影响性能。对于批量操作，尽量先收集所有需要的数据，然后一次性处理。

4.3 最佳实践建议

资源释放：SolidWorks对象通常不需要手动释放，但在长时间运行的程序中，应注意管理对象引用。
错误处理：添加足够的错误处理逻辑，特别是对于可能长时间运行的操作。
用户反馈：在长时间操作期间，提供进度反馈，避免用户认为程序无响应。

版本兼容性：如果目标环境可能有不同版本的SolidWorks，应考虑版本兼容性问题：

csharp复制string swVersion = swApp.RevisionNumber();
Console.WriteLine($"SolidWorks版本: {swVersion}");

多线程注意事项：SolidWorks API不是线程安全的，所有调用都应在主线程执行。