SolidWorks.Tools 1.0.1

SolidworksDotNetTools

介绍

SolidWorks 二次开发中 常用的一些方法封装

软件架构

软件架构说明

安装教程

使用说明

Gwh.SolidworksBase

Gwh.SolidworksBase 是一个用于 SolidWorks 二次开发的 .NET 类库，提供了连接、操作和自动化 SolidWorks 的基础功能。

项目概述

• 目标框架: .NET Framework 4.0
• 主要用途: SolidWorks 二次开发基础库
• 依赖项: SolidWorks Interop 组件

功能模块

1. 连接管理 (Connect.cs)

提供与 SolidWorks 应用程序的连接和启动功能：

• 获取正在运行的 SolidWorks 实例
• 启动新的 SolidWorks 实例
• 检查 SolidWorks 是否正在运行
• 获取 SolidWorks 安装路径
• 版本转换工具

2. 应用程序工具 (SwAppTools.cs)

扩展 SolidWorks 应用程序的功能：

• 创建新文档（零件、装配体、工程图）
• 遍历特征树并收集特征信息
• 处理特征尺寸信息

3. 通用工具 (Utility.cs)

提供各种实用功能：

• 连接到 SolidWorks
• 遍历特征和尺寸
• 遍历装配体组件
• 随机颜色生成
• 相关数据模型定义

4. 装配体工具 (AssemblyTools/AsmHelper.cs)

专门处理装配体相关的功能：

• 递归遍历装配体中的所有组件
• 获取模型配置属性
• 构建装配体特征树模型

5. 模型文档工具 (ModelDoc/ModelDocHelper.cs)

处理模型文档的基本操作：

• 压缩模型
• 解压缩模型

6. 工程图工具 (DrawingTools.cs)

自动化生成工程图：

• 创建装配体和零件的工程图
• 支持模板化工程图生成

7. 文档创建工具 (DrawDoc/)

专门用于创建工程图文档：

• CreateAsmDoc.cs: 装配体工程图创建
• CreatePartDoc.cs: 零件工程图创建

8. 辅助工具 (Helper/SharedProxy.cs)

提供程序集加载和执行功能：

• 动态执行外部程序集中的方法
• 程序集解析处理

数据模型

FeatureInfo (Model/FeatureInfo.cs)

表示 SolidWorks 特征的信息：

• 特征名称
• 特征类型
• 是否为草图
• 是否为参考特征
• 是否包含尺寸
• 创建日期
• 子特征列表

PartTreeModel (Model/PartTreeModel.cs)

表示装配体中零部件的树形结构：

• 模型名称
• 属性名称
• SolidWorks 模型对象
• 组件对象
• 选择组件字符串
• 属性字典
• 子模型集合

版本支持

支持以下 SolidWorks 版本：

• SolidWorks 2015 (版本23)
• SolidWorks 2016 (版本24)
• SolidWorks 2017 (版本25)
• SolidWorks 2018 (版本26)
• SolidWorks 2019 (版本27)
• SolidWorks 2020 (版本28)
• SolidWorks 2021 (版本29)
• SolidWorks 2022 (版本30)
• SolidWorks 2023 (版本31)

使用示例

连接到 SolidWorks

// 获取正在运行的 SolidWorks 实例
SldWorks swApp = Connect.GetRunningSolidWorks();

// 或者启动一个新的 SolidWorks 实例
SldWorks swApp = Connect.CreateSolidWorks(true); // true 表示可见

创建新文档

// 使用 SwAppTools 扩展方法创建新零件文档
ModelDoc2 newPartDoc = swApp.CreateNewDocument(swDocumentTypes_e.swDocPART);

// 使用特定模板创建新文档
ModelDoc2 newDoc = swApp.CreateNewDocument(@"C:\Templates\PartTemplate.prtdot");

遍历特征

// 遍历活动文档的所有特征
ModelDoc2 activeDoc = swApp.ActiveDoc;
Feature firstFeature = activeDoc.FirstFeature();
List<FeatureInfo> features = SwAppTools.TraverseFeatures(firstFeature, true, true);

生成工程图

// 自动为装配体及其所有子组件生成工程图
DrawingTools.CreateDoc(swApp);

依赖的 SolidWorks Interop 组件

• SolidWorks.Interop.sldworks
• SolidWorks.Interop.swconst
• SolidWorks.Interop.cosworks
• SolidWorks.Interop.sw3dprinter
• SolidWorks.Interop.swcommands
• SolidWorks.Interop.swdimxpert
• SolidWorks.Interop.swdocumentmgr
• SolidWorks.Interop.swmotionstudy
• SolidWorks.Interop.swpublished
• SolidWorks.Interop.SWRoutingLib

以及辅助库：

• ConnectToSolidworks.dll
• SolidWorksTools.dll

注意事项

1. 确保目标机器已安装相应版本的 SolidWorks
2. 需要正确引用所有 SolidWorks Interop 组件
3. 部分功能可能需要 SolidWorks 特定版本的支持
4. 在使用自动化功能时，确保 SolidWorks 已正确初始化

这是 Gwh.SolidworksBase 项目的完整文档，涵盖了项目的主要功能模块、使用方法和注意事项。该文档可以帮助开发者快速了解和使用这个 SolidWorks 二次开发基础库。



#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)