使用V B A进行
s o l i d w o r k s开发指南标准化管理部编码-[99968T-6889628-J68568-1689N]
目录第1章概述
1.1内容简介
Solidworks在提供了强大的三维建模功能的同时，也为使用者提供了开放的应用程序编程接口（API），通过调用这些API，我们可以将solidworks中一些重复单调或者规则明确的操作使用程序语言描述，通过简单的人机交互，让计算机自己来完成此类工作。
掌握了此类本领，可以在以后的工作中，开阔自己的视野，更加深入的了解软件本身工作的原理，并且，改善自己的工作，提高工作效率和质量。
本文旨在总结作者工作中获得的经验，专注于solidworks软件本身特点，文章中示例的代码基本上使用了vb语言描述，选择vb语言是因为其语法简单易懂，并且和应用程序间有很明朗的接口不需要再学习其它技术（如果使用
c++,可能需要读者拥有COM知识）。
Solidworks提供了极其丰富的API，并且有很完善的帮助系统。
我们可以使用 Microsoft VBA编写SolidWorks Macros或者使用其他编程环境编写Standalone and Add-in Applications。
（使用visual studio到.NET都可以）在SW的API帮助中我们可以很明了的查看API调用语法及相关的示例代码。
本文不可能对每一个API进行细致的解释，在后面章节主要指导大家如何使用软件提供的帮助来在需要时得到有用信息的手段。
本文所有API和代码都以solidworks2005 sp0.0 版本为准。
1.2名词解释
API ：应用编程接口Application Programming Interface
对象：即计算机抽象出来的一种事物，在面向对象的程序设计中它表示由数据和与该数据关联的操作组成的类的具体实现。
属性：对象所具有的属性，识别及说明对象的特性。
方法：对象可以使用的对数据的操作。
1.3预备知识
首先我们的读者应该有简单的VB经验。
当然如果没有也可以临时抱佛脚（VB语句是直观易懂的），边看代码边学习。
很好的掌握SW中宏的录制功能
多阅读API帮助中的示例代码，是自学的最佳途径（虽然SW的宏录制功能相比EXCEl来说代码不是很清晰）。
其次solidworks软件应该非常熟练，读者应该有使用solidworks实际建模的经验，，这是能够写出良好代码的基础。
否则看到一些对象名称也不能了解它对应了软件的那个功能。
如果英文不够好，请准备及时词典，如金山词霸等。
Solidworks提供的API帮助是纯英文的，solidworks汉化的还不错，不明白为什么不顺便把API 帮助也翻过来。
准备好，我们可以开始了.
第2章录制、编辑、运行宏
2.1录制、编辑、运行宏基本步骤：
开始solidworks编程的最快方式就是录制宏。
宏可以记录用户的操作将其记录为一系列solidworksAPI的调用。
在solidworks“工具”菜单“宏”中有运行、录制、新建、编辑等选项。
我们选择“录制”来开始记录用户操作，选择“停止”来结束宏的录制。
结束后会提示保存宏文件，其后缀名为.swp。
（估计是solidworks program的意思吧）。
录制到停止间对solidworks进行的操作都将记录到宏文件中。
但是直接录制的宏程序的可用性很差，我们需要对它进行一些合理的优化，清理多余的语句，所以在录制完成宏之后需要编辑它。
编辑宏的时候，选择“工具”菜单“宏”中的“编辑”，此时提示你选择要编辑的宏文件（swp文件）。
选择后进入编辑界面（其实就是VBA的编辑器，叫集成环境也行）。
需要说明的是，如果之前你在excel、word等软件中录制过宏程序，那么可能solidworks录制宏中的垃圾数据要更多些。
2.2一些基本的建议：
Solidworks在帮助中也有一个大体的介绍，在编辑一个新录制的宏时可以需要删除下面的多余代码（Delete extra lines of code）:
1、The following variables are declared automatically in a SolidWorks macro. Delete any variables not used in the macro. SolidWorks对象的声明是自动产生的，可以将没用到的删除
2、Delete all lines of code that change the view. 删除切换视图的
代码
says：像这样的 Part.ActiveView().RotateAboutCenter 0.0662574,
0.0346621 无情的删掉吧
3、Delete all calls appearing immediately before calls. However, do not delete ModelDocExtension::SelectByID2 calls appearing immediately after ModelDoc2::ClearSelection2 calls. Delete all ModelDoc2::ClearSelection2 calls appearing immediately before ModelDocExtension::SelectByID2.
删除所有紧挨之前的调用，不要删除紧挨ModelDoc2::ClearSelection2调
用后的ModelDocExtension::SelectByID2。
删除所有紧挨ModelDocExtension::SelectByID2之前的ModelDoc2::ClearSelection2。
下图为VBA的集成编辑环境：
编辑完成后，按照程序的要求来运行宏，在VBA编辑器中点“运行”开
始执行程序，需要注意，有些宏程序的运行有前提条件，比如需要事先选择好
一个特征等。
第一次运行不一定成功，这时候就要对宏代码进行调整，反复一
个编辑代码、测试运行的循环，最后得到比较满意的结果。
加载宏到solidworks有很多种方法我们只介绍最简单的三种：快捷键、菜单、工具栏按钮。
可以参考文档《SW技术文档加载宏到solidworks的三种方法.doc》
第3章代码格式及帮助信息
3.1代码格式：
这章中，我们给出一段完成简单功能的代码，并讨论如何从帮助中获得
有用信息。
首先，打开soliworks，选择“工具”、“宏”、“新建”，给新的宏
文件起名字为“openprt.swp”。
清空vba编辑器中的内容，拷贝或者输入下面的代码，保存。
'---------------------------------
' Preconditions: None
' Postconditions: Specified document is opened.
'---------------------------------
Option Explicit
Dim swApp As SldWorks.SldWorks
Dim fileerror As Long
Dim filewarning As Long
Sub main()
Set swApp = Application.SldWorks
swApp.Visible = True
swApp.OpenDoc6 "d:/samples/hotrod.sldprt", swDocPART, swOpenDocOptions_Silent, "", fileerror, filewarning
End Sub
上面的代码来自solidworksAPI帮助，它打开d:/samples/目录下的零件文件hotrod.sldprt。
我们来分别解释一下上面代码的内容：
'---------------------------------
' Preconditions: None
' Postconditions: Specified document is opened.
'---------------------------------
注释：注释块说明了程序运行的上下文：前提条件（Preconditions）为：无 NONE ；运行结果为：
打开指定的文件。
API帮助中的示例都有这样的格式，需要大家在使用时注意其上下文约束条件。
Option Explicit
Dim swApp As SldWorks.SldWorks
Dim fileerror As Long
Dim filewarning As Long
声明变量和对象：swapp为一个solidworks应用程序对象。
其它两个为long型整数，用来保存错误和警
告id。
Sub main() 这是主过程，以main为名称。
Set swApp = Application.SldWorks 刚才的DIM语句只是声明了对象swapp，现在使用SET定义
对象
swApp.Visible = True 设置应用程序可见
swApp.OpenDoc6 "d:/samples/hotrod.sldprt", swDocPART, swOpenDocOptions_Silent, "", fileerror,
filewarning
打开文件d:/samples/hotrod.sldprt 。
End Sub
3.2获得帮助：
当我们想从这个示例代码中了解打开一个文件的细节时，我们需要
OpenDoc6函数的参考，可以在索引或者搜索中查找OpenDoc6，得到如下信息
（汉字为我的注释）：
Description：描述此API完成的功能
This method opens an existing document and returns a pointer to the document object. It also
allows control over whether or not to:此方法打开一个已经存在的文档并返回指向此文档对象的指
针。
它在打开文档时允许做下面控制：
Suppress displaying dialog boxes 禁止对话窗口
Open the document read-only 只读打开
Open the document view-only 只看打开
Convert a drawing to a detached drawing 将工程图转换为断开的工程图
Syntax (OLE Automation) 语法：
retval = SldWorks.OpenDoc6 ( filename, type, options, configuration, &Errors, &Warnings )
Input: (BSTR) Filename Document name or full path if not in current directory, including extension文件
全路径
Input: (long) Type Document type as defined in 文档类型
Input: (long) Options Mode in which to open the document as defined in swOpenDocOptions_e打开选项
Input: 输入(BSTR) Configuration Model configuration in which to open this document 配置设置
Applies to parts and assemblies, not drawings 只在零件和装配体适用
If this argument is empty or the specified configuration is not present
in the model, the model is opened in the last-used configuration. 如果
未指定任何配置将使用最后一次打开的配置。
Output:输出(long) Errors Load errors as defined in swFileLoadError_e打开错误
Output: (long) Warnings Warnings or extra information generated during the open operation as defined in
swFileLoadWarning_e打开警告
Return:返回(LPDISPATCH) retval Pointer to a Dispatch object, the newly loaded ModelDoc2, or NULL if failed to
open
Remarks备注：
When opening a parent document (assembly, drawing, and so on):
SolidWorks also opens any additional documents that are referenced in the parent
document (parts, subassemblies, and so on).
SolidWorks follows certain rules in trying to locate its referenced documents.
If explicit Search Folders have not been set using Tools, Options, System
Options, ExternalReferences, then the first place SolidWorks looks for the
referenced documents is in the current working directory. If SolidWorks finds
the referenced file in the current working directory, then it is loaded from
that directory. … …
我们应该具备的素质就是，可以按照上面的参考内容明白API的使用方
法和规则。
而我们常常需要注意的焦点是语法（Syntax）知道需要输入什么参
数返回什么对象就基本OK了，不要被前面一片英文所迷惑。
最后我们介绍一下API帮助的目录：
Solidworks 2005 API Release Notes ：此文档树下为sw2005版本的新特性：新对象新函数等
Programmer’s Guide ：此文档树目录下为sw编程向导，提供了开始编程的向导、sw对象模型总揽和实际编程中的注意事项等内容。
Examples ：此文档树目录下为sw所有示例工程，分为c++和VB两中
语言大类。
我们经常需要访问的地方。
APIs ：sw提供的所有API定义及参考。
Obsolete APIs ：sw已过时的API。
第4章常用对象模型
4.1综述：
学会录制宏代码，并从帮助中得到代码中API使用方法后，我们介绍一些
常用的对象模型，并给出一些使用方法。
这些对象是sw最基本的对象，几乎所有程序都会使用其中的几种，也是我们可以很直观想象到的对象模型：
4.2SldWorks.SldWorks :
此对象代表solidworks应用程序。
我们可以使用此对象进行应用程序层面的操作：打开、保存、关闭文档；设置用户界面的状态等等。
一般来说我们的sw程序总是首先定义此对象才能进行其他的操作：
声明和定义示例：
Dim swApp As SldWorks.SldWorks
Set swApp = Application.SldWorks
或者
Dim swApp As SldWorks.SldWorks
Set swApp = CreateObject("SldWorks.Application")
调用属性或方法示例：
swApp.Visible = True
swApp.OpenDoc6 "d:/samples/hotrod.sldprt", swDocPART, swOpenDocOptions_Silent, "", fileerror, filewarning
4.3SldWorks.ModelDoc2：
此对象代表solidworks的文档。
Solidworks有三种最基本的文件格式：零件、装配体、工程图。
它们各自都有自己特定的对象来表示，但是solidworks 设定了一些通用的方法和属性来操作这些对象。
ModelDoc2对象可以直接对这
三类文件进行操作。
声明和定义示例：
Dim swmodel As SldWorks.modeldoc2
Set swmodel = swapp.OpenDoc6 "d:/samples/hotrod.sldprt", swDocPART, swOpenDocOptions_Silent, "", fileerror, filewarning ‘打开文档
或者
Dim swmodel As SldWorks.modeldoc2
Set swmodel = swapp.activedoc ‘得到当前文档
调用属性或方法示例：
swmodel.GetPathName 得到模型的路径
4.4SldWorks.PartDoc、SldWorks.AssemblyDoc、SldWorks.DrawingDoc：
上面三个对象分别代表solidworks三种文件格式。
使用它们来操作相应类型的文件。
声明和定义示例：
Dim swpart As SldWorks.PartDoc
Dim swasm As SldWorks.AssemblyDoc
Dim swdraw As SldWorks.DrawingDoc
Set swpart=swmodel
Set swasm = swapp.OpenDoc6 "d:/samples/hotrod.sldasm", swDocPART, swOpenDocOptions_Silent, "", fileerror, filewarning
Set swdraw =swapp.activedoc
调用属性或方法示例：
swpart.MirrorFeature 镜像特征
swasm.AddMate2 添加配合
swdraw.NewSheet3 插入新图纸
4.5SldWorks.feature、SldWorks.Sketch ：
代表solidworks中的特征和草图对象。
还有很多对象在此就不再介绍，下面的三章将针对零件、装配体和工程图分别讨论。
第5章零件 PartDoc
5.1综述：
零件是sw基本文件类型之一，我们可以通过此对象创建新零件、得到零件的各种、信息控制零件中的特征属性等等。
下面是PartDoc的对象模型：我们知道特征是组成一个零件的基本对象。
但是从上图我们可以看出来，特征对象并不是在零件对象下层的。
察看API帮助我们知道，特征是在Modeldoc对象下。
在Partdoc下只能对实体对象（Body2）进行操作。
所以很多对零件进行的操作，我们需要使用Modeldoc对象。
5.2选择对象的话题：
首先来学习两个API，这两个API完成选择对象和得到所选择对象的功能：SelectByID2和GetSelectedObject5这两个函数，第一个通过给出对象的name选择对象。
第二个通过启用程序前已经选择的索引得到对象。
其中的SelectByID2基本上在sw录制宏时所作的选择操作都是用了这个API，但它的局限性在于，程序需要知道所要选择对象的名称、类型（在中定义）并且函数并不返回所选择对象而是一个执行状态。
如果想得到我们刚才选择的对象，则需要用到另一个函数GetSelectedObject5。
使用GetSelectedObject5之前需要介绍一下SelectionMgr对象：此对象允许你得到所选择对象的信息，对其进行一些操作。
GetSelectedObject5就是SelectionMgr对象的一个方法。
可以使用ModelDoc2.SelectionManager来得到一个SelectionMgr对象。
并且需要注意的是sw将所选择的对象进行了索引，我们可能同时选中了多个对象，通过GetSelectedObject5(index)中得index值来得到不同的选择对象。
看下面程序，它使用SelectByID2将当前打开的模型文件中的特征“拉伸1”选中，如果选择成功的话再使用GetSelectedObject5得到此特征：
‘++++++++++++++++++++++++++++++++
‘Filename Selefeat.swp : Select feature”拉伸1”
‘++++++++++++++++++++++++++++++++
Option Explicit
Dim swApp As SldWorks.SldWorks
Dim Model As ModelDoc2
Dim feature As feature ‘定义一个特征对象
Dim boolstatus As Variant ‘定义api返回值
Sub main()
Set swApp = Application.SldWorks
Set Model = swApp.ActiveDoc ‘前面已经介绍，上面两句话基本上是固定模式
' 选择叫"拉伸1"的特征
拉伸1", "BODYFEATURE", 0, 0, 0, False, 0, Nothing, swSelectOptionDefault)
'主要就是这一句话，在写Option Explicit后函数的最后一个参数swSelectOptionDefault可以使用0来代替
If boolstatus = True Then '如果有“拉伸1”这个特征下面的代码将其选中
Dim SelMgr As SelectionMgr ‘ 声明一个selectionmgr 对象
Set SelMgr = Model.SelectionManager ‘得到当前模型的选择对象
Set feature = SelMgr.GetSelectedObject5(1) '此处使用一个索引来得到特征
Debug.Print ‘ 在立即窗口打印特征的name属性
Else
Debug.Print "Error"
End If
End Sub
两个函数的VB语法表述如下，具体请参考API帮助：ModelDocExtension::SelectByID2
Syntax (OLE Automation)
retval = ModelDocExtension.SelectByID2 ( Name, Type, X, Y, Z, Append, Mark, Callout. SelectOption )
SelectionMgr::GetSelectedObject5
Syntax (OLE Automation)
retval = SelectionMgr.GetSelectedObject5 ( AtIndex )
在选择对象这个话题中我们还要讨论几个API：
ModelDoc2::ClearSelection2此API清空SW的选择列表，即取消所有选择。
还有activate系列：
retval = SldWorks.ActivateDoc2 ( name, silent, &errors ) ‘激活文档retval = DrawingDoc.ActivateSheet( SheetName ) ‘激活工程图纸
retval = DrawingDoc.ActivateView ( viewName) ‘激活视图
void ModelDoc2.ActivateSelectedFeature () ‘激活选中特征
选择的话题就到这里结束。
上面有一处关于swSelectOptionDefault的注释大家可能会有疑惑，这里附加上对solidworks API中定义Enum的介绍。
为了让API的参数更直观，swAPI 中有很多类似的enum定义，它将一系列小整数和字符串描述符对应，在api的语法参考中都描述了相应的代表对象。
具体实现细节需要参考VB的语法，这里我们需要明白，如果你在程序前面定义了Option Explicit（强制声明）选项，那你需要在使用这些enum时候定义它或使用不直观的整数作为参数。
Public enum swDocumentType s_e ‘这是一个sw文档类型的列举项
swDocNONE=0 ‘什么也不是
swDocPART=1 ‘零件类型在做为参数时使用1和使用swDocPART效果是相同的，只是swDocPART意义更加明显
swDocASSEMBLY=2 ‘装配体类型
swDocDRAWING=3 ‘工程图类型
End Enum
5.3访问并修改特征:
我们已经学习了如何选中一个对象，下面我们针对特征来讨论如何得到选中特征对象的属性并修改它。
getchoosed.swp得到所选择特征的一些属性信息：
‘+++++++++++++++++++++++++++++++++ 'filename : getchoosed.swp'date :2005-03-22'used to get the simple hole infomation dep & dia'+++++++++++++++++++++++++++++++++++
Option ExplicitDim swApp As SldWorks.SldWorksDim Model As ModelDoc2Dim curfeature As featureDim boolstatus As BooleanDim featdata As SimpleHoleFeatureData2 '声明一个简单直孔特征数据对象
Dim component As Component2
‘声明一个组件对象
Dim dep As Double ‘孔深
Dim dia As Double ‘孔径
Dim SelMgr As SelectionMgr ‘选择管理器Dim ncount As Integer Sub getselected()
Set swApp = Application.SldWorks
Set Model = swApp.ActiveDoc
Set SelMgr = Model.SelectionManager
Set curfeature = SelMgr.GetSelectedObject5(1) '得到当前选中的第一个特征
Debug.print Set featdata = curfeature.GetDefinition '得到特征的定义
boolstatus = featdata.AccessSelections(Model, component) ' 可以对数据进行访问了
ncount = featdata.GetFeatureScopeBodiesCount
‘此方法得到拉伸特征在多实体零件中所作用的实体数
Debug.print ncount
dep = featdata.Depth ‘访问属性depth 和 diameterdia = featdata.Diameter
Debug.print dia & "*" & dep
‘Debug.print "error "
'在solidworks中可以使用swAPP.sendmsgtouser2 替代msgbox
featdata.ReleaseSelectionAccess ‘取消特征数据访问
Model.Save
Model.EditRebuild ‘重建模型
End Sub
上面程序运行前，假设你选择了一个简单直孔特征。
然后得到这个孔的一些参数：孔深、直径。
最初做上面程序的时候，我想象中用Set curfeature = SelMgr.GetSelectedObject5(1)
选中特征以后就可以直接curfeature. Depth了。
在参考了API帮助后，我才了解到特征的数据需要先AccessSelections后才能访问。
总结一下，要访问一个特征，需要经历这样的步骤：
定义一个特征对象及特征数据对象： dim....as ...
选中这个特征：比如使用GetSelectedObject5 还有SelectebyID等...
得到特征的定义：GetDefinition
进行访问：AccessSelections
上面的程序没有if选择的容错机制，实际编码中，每个可能出现错误的地方都应该使用if来控制，如下面这句话boolstatus =featdata.AccessSelections(Model, component)。
我们就需要通过boolstatus的值来判断上面这个语句运行的是否正确，这里的boolstatus很明显是一个布尔型变量：
If not boolstatus then
‘上面语句运行不成功，写错误报告或退出代码
Endif
已经可以访问特征的各参数了，现在我们来修改它：
要修改前面的步骤不能少，当我们已经可以读取一些特征时，我们就可以给他设定一些值。
当然有时需要调用特定的参数。
solidworks是ole和com的，所以要习惯这样。
在修改完特征后需要调用函数modifydefinition()来实现变化。
我们给一个例子，这个例子比前面的都要全面，它有很好的容错引导机制，可以直接拿来成为一个稳定的宏程序。
‘+++++++++++++++++++++++++++++++++ 'filename : doubleBE.swp'date :2005-03-22' This example doubles the length of the base extrude.这个例子将拉伸凸台的长度增加一倍
'+++++++++++++++++++++++++++++++++++
Dim swApp As SldWorks.SldWorks
Dim Model As ModelDoc2
Dim Component As Component2
Dim CurFeature As feature
Dim isGood As Boolean
Dim FeatData As Object '先声明为object，后面自动匹配为 ExtrudeFeatureData 对象
Dim Depth As Double
Dim SelMgr As SelectionMgr
Sub doubleBE()
Set swApp = CreateObject("sldWorks.application")
Set Model = swApp.ActiveDoc
'确定model是零件或正配体，不是就退出。
在这里swDocPART 和swDocASSEMBLY如果不能通过编译则参考
’上面的enum介绍，换为1和2
If Model.GetType <> swDocPART And Model.GetType <> swDocASSEMBLY Then
Msg = "Only Allowed on Parts or Assemblies" ' Define message
Style = vbOKOnly ' OK Button only
Title = "Error" ' Define title
Call MsgBox(Msg, Style, Title) ' Display error message
Exit Sub ' Exit this program
End If
' 得到 Selection Manager
Set SelMgr = Model.SelectionManager
' 得到所选的第一个对象
Set CurFeature = SelMgr.GetSelectedObject3(1)
If CurFeature Is Nothing Then
' 什么都没有选中
swApp.SendMsgToUser2 "Please select the Base-Extrude", swMbWarning, swMbOk
Exit Sub
End If
' Check the feature's type name
' Make sure it is an extrusion
If Not CurFeature.GetTypeName = swTnExtrusion Then
’在这里使用swTnExtrusion我的环境没有通过，改成了Extrusion才ok，参考BodyFeatures_e的定义swApp.SendMsgToUser2 "请选择拉伸基体特征", swMbWarning, swMbOk
Exit Sub
End If
' 得到特征数据
Set FeatData = CurFeature.GetDefinition
' Get the access selections for the feature data
' 注意：访问单独零件时参数Component 为 NULL。
如果我们在装配体中使用AccessSelections，将访问最高级文档此时我们的component参数需要制定component来得到其他零件。
isGood = FeatData.AccessSelections(Model, Component)
' Inform the user of an error
If Not isGood Then
swApp.SendMsgToUser2 "Unable to obtain access selections", swMbWarning, swMbOk
Exit Sub
End If
' 确认用户选择的是基体拉伸特征
If Not FeatData.IsBaseExtrude Then
swApp.SendMsgToUser2 "Please select the Base-Extrude", swMbWarning, swMbOk
FeatData.ReleaseSelectionAccess
Exit Sub
End If
' 得到深度并增加到2倍
Depth = FeatData.GetDepth(True)
FeatData.SetDepth True, Depth * 2
' 执行修改
isGood = CurFeature.ModifyDefinition(FeatData, Model, Component)
' 改变步成功
If Not isGood Then
swApp.SendMsgToUser2 "无法修改特征数据", swMbWarning, swMbOk
' 取消对数据的访问
FeatData.ReleaseSelectionAccess
End If
End Sub
TIPs：
如果出现特征出现“退回”状态，只能在代码执行到最后调用
Model.Save Model.Rebuild
这两个函数来自动更新。
上面的程序中使用了新的没有介绍的API，只作了简单注释性介绍，如果不理解读者可以到API帮助中查看它的细节。
这里只看其中一个API，它可能会经常使用:
如果我们定义了一个特征对象：
dim curfeature as sldworks.feature
又通过SelectMgr得到了这个特征,然后可以使用feature.GetTypeName来判断是那种：
Select Case curfeature.GetTypeName
Case "Cut" '一个拉伸切除特征
do sth.
Case "HoleWzd" '一个异型孔特征
do sth.
Case Else
End Select
end select
这是语法：
Syntax (OLE Automation)
retval = Feature.GetTypeName ()
它会返回一个 (BSTR) retval Feature type as defined in
其中内容比较多，在这里都列出来也没什么用，大家可以参考solidworks API帮助。
5.4草图的话题：
Solidwork中对草图的控制，下面的例子很详细。
特征下的草图在solidwork中其实是特征的子特征，我们可以对特征进行GetFirstSubFeature、及GetNextSubFeature得到。
下面是插入新草图的示例：InsertSketch2插入一个新草图，CreateLine2画一条线。
This example shows how to open a sketch, sketch a line, and close the sketch.
'------------------------------------------
' Preconditions:
' (1) Model document is open.
' (2) Planar face or a sketch is selected.
' Postconditions: A sketch is opened, a line is sketched, and the sketch is closed.
'------------------------------------------
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSkSeg As SldWorks.SketchSegment
Dim swSkLine As SldWorks.SketchLine
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
' A sketch on the selected planar face or the selected sketch is opened
swModel.InsertSketch2 True
' A line is sketched
Set swSkSeg = swModel.CreateLine2(0#, 0#, 0#, 0.1, 0.1, 0#)
Set swSkLine = swSkSeg ‘注意此处的SketchLine和SketchSegment对象
' Sketch is exited
swModel.InsertSketch2 True
End Sub
下面是我从以前的工程中节选的一段代码，它访问特征中的草图数据：Dim curfeature As SldWorks.feature
Dim swsketchfeat As SldWorks.feature
Dim swSketch As SldWorks.Sketch ‘草图对象
Dim swsketchseg As SldWorks.SketchSegment ‘草图段对象
Dim swsketcharc As SldWorks.SketchArc ‘圆弧对象
Dim swsegarr As Variant
Dim swseg As Variant
Dim swcenter As SldWorks.SketchPoint ‘草图点对象
Dim swend As SldWorks.SketchPoint ‘草图点对象
Set swsketchfeat = curfeature.GetFirstSubFeature ‘得到特征的子特征
If swsketchfeat.GetTypeName = "ProfileFeature" Then ‘如果是草图特征
Set swSketch = swsketchfeat.GetSpecificFeature ‘得到草图特征
swsegarr = swSketch.GetSketchSegments ‘得到此草图对象的草图段 For Each swseg In swsegarr
Set swsketchseg = swseg
If swsketchseg.GetType = 1 Then ' 1 说明为arc，之前没有定义enum
Set swsketcharc = swsketchseg
dia = Fix(swsketcharc.GetRadius * 1000 * 2 + 0.5) '得到直径 Else
MsgBox "不是圆的草图 "
Exit Sub
End If
Exit For
Next
End If
关于零件的讨论就到此为止，其中的细节太多，本手册只能做为一个编程的指南而不是整体的参考，更多的内容需要读者在实际工作中参考API帮助来完成。
第6章装配体
6.1综述：
装配体是由零件和子装配体组成的，其对象模型如下图。
相比零件来说，它增加了配合mate2和组件component2两个对象。
配合是零部件之间的几何关系，组件为组成此装配体的零部件,本文只对其组件和配合分两个主题来讨论。
6.2组件的话题：插入零部件到装配体
在往装配体中插入零部件时，我们使用addcomponent 函数。
如果需要选定零部件的配置，则需要使用addcomponent4。
先学习下语法：
需要注意的是：参数1为文件的全名（包括路径）；参数2为文件的配置名称；当函数执行成功购返回一个指向该零件的指针。
于是我们可以如下写一个小程序，用来给装配体中插零件：
‘++++++++++++++++++++++++++++++++
‘filename:insertPart.swp
‘write by 2005-4-4
‘函数在当前工作目录CurrentWorkingDirectory插入一个名为“零件1.SLDPRT”的零件
‘前提条件为当前工作目录有名字为”零件1.sldprt”的零件
‘它有配置名为“配置1”
‘+++++++++++++++++++++++++++++++++
Dim swApp As SldWorks.SldWorks
Dim Model As ModelDoc2
Dim pth As String
Dim strpath As String
Sub insertPart()
Set swApp = Application.SldWorks
strpath = swApp.GetCurrentWorkingDirectory ‘当前工作路径
Set Model = swApp.ActiveDoc
pth = strpath & "零件1.SLDPRT" ‘得到文件的FULLPATH全名
Model.AddComponent4 pth, "配置1", 0, 0, 0 ‘添加零部件
End Sub
然而，这个程序比不是想象中那么好用。
为什么呢回头看addcomponent4的remark，上面这样写：
The specified file must be loaded in memory. A file is loaded into memory when you load the file in your
SolidWorks session () or open an assembly that already contains the file.
就是说你想指定的插入的文件必须在调用函数之前已经在内存中加载了。
不习惯，你就不能直接打开多简单，没办法，我还没有找到好的方法，只能按人家的来：
看看下面的函数Opendoc6，它打开一个文档：
这个函数参数1就是文档的全名，参数2是要插入的类型描述，其中0123分别表示：
0 swDocNONE：不是sw文件
1 swDocPART：零件
2 swDocASSEMBLY：装配体
3 swDocDRAWING：工程图
如果想使用swDocNONE，需要定义：
Public Enum swDocumentTypes_e
swDocNONE = 0
swDocPART= 1
swDocASSEMBLY = 2
swDocDRAWING=3
End Enum
参数3是打开文档的模式，一般我们就选择swOpenDocOptions_Silent
用0 表示，当然还有只读、只看等选项
参数4是打开选项，一般置空
后面是两个OutPut，用来显示错误打开时的提示
函数返回一个指向打开文件的指针。
按照上面的要求我们在向装配体中插入一个零部件时，需要这样步骤：
1、得到装配体
2、使用opendoc6打开需要插入的零件
3、使用addcomponent4插入零件到装配体
我们上面的程序需要这样来修改一下，添加了一个打开文档的函数：' +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
' insertpart 03/21/05 by arden
'插入零件1
'前提条件：在装配体所在文件夹中有零件“零件1”存在，并且零件1有配置“配置1”
' ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Dim swApp As SldWorks.SldWorks
Dim Model As ModelDoc2
Dim YSBmodel As ModelDoc2
Dim pth As String
Dim strpath As String
Dim nErrors As Long
Dim nWarnings As Long
Sub insertpart()
Set swApp = Application.SldWorks
strpath = swApp.GetCurrentWorkingDirectory
Set Model = swApp.ActiveDoc
pth = strpath & "零件1.SLDPRT"
openYSB (pth) ‘在添加零部件之前，先打开它
Model.AddComponent4 pth, "配置1", 0, 0, 0
End Sub
'这个函数打开零件1
Sub openpart(ByVal pth As String)
Dim path As String
Dim newswapp As SldWorks.SldWorks
Set newswapp = Application.SldWorks
path = pth
Set YSBmodel = newswapp.OpenDoc6(path, 1, swOpenDocOPtions_Silent, "", nErrors, nWarnings)
YSBmodel.Visible = False ‘我不想看到零件1
End Sub
6.3配合的话题：在装配体中添加配合
下面我们来在一个装配体中自动判断插入合适的零件，并添加配合。
在前面已经基本上说明了如何得到零部件的数据信息、如何插入零部件、如何得到已经选择的特征等。
下面只介绍怎样进行配合。
在做配合时，需要经常选择到零件的面、线等，这是一个问题，还有就是介绍一下addmate2函数的使用：
一般进行配合我们按照下面的次序来进行：
主要的问题在于如何选择合适的面：
由于面的命名没有什么规律，很多时候是程序自动来命名的，这样，不方便使用selectbyID来选择，我也不想使用坐标值来选择一个面，那样做更加糟糕。
在得到一个组件（component）或者一个特征（feature）时，我们有getfaces、getfirstface、getnextface等方法，我们可以使用这些方法遍历一个组件或特征等的各个面，来达到选择面的目的，看下面程序：‘+++++++++++++++++++++++++++
‘selectface
‘+++++++++++++++++++++++++++
Private Function selectface(dcom As ponent2, tp As Integer) As Boolean Set swdowelbody = dcom.GetBody()
If swdowelbody Is Nothing Then '错误处理
MsgBox "选择零件失败"
selectface = False
Exit Function
End If
Set swDCface = swdowelbody.GetFirstFace ‘得到第一个面
Do While Not swDCface Is Nothing ‘遍历各个面
Set swDsurface = swDCface.GetSurface ‘得到表面对象
If swDsurface.IsCylinder Then ‘如果是圆柱面
If tp = 0 Then 'means cylinder
Set swDEnt = swDCface
swDEnt.Select4 True, selDdata
selectface = True
Exit Function
End If
Else ‘如果是其它，当然实际中我们可能需要使用select来定义好多分支
If tp = 1 Then 'means plane
Set swDEnt = swDCface
swDEnt.Select4 True, selDdata
selectface = True
Exit Function
End If
End If
Set swDCface = swDCface.GetNextFace
Loop
End Function
此函数接受两个参数，第一个是一个component对象，第二个用来标识选
择类型：0表示圆柱面，1表示平面。
此函数运行完成后将选择指定组件的指定
类型的一个面。
需要注意的是我们需要在判断面类型时候需要转换到surface
对象。
而且选择需要定义一个entity对象，用来select4，达到选择的目的。
可能这个过程有些复杂，大家按照这个顺序多测试几次，就明白了它的工作原
理。
上面的函数写的并不好，是从我的工程中截取的一段。
下面介绍一下addmate2函数：
Syntax (OLE Automation) OLE语法：
pMateObjOut = AssemblyDoc.AddMate2 ( mateTypeFromEnum, alignFromEnum, flip, distance,
distAbsUpperLimit, distAbsLowerLimit, gearRatioNumerator, gearRatioDenominator, angle, angleAbsUpperLimit, angleAbsLowerLimit, errorStatus )
参数：
Input: (long) mateTypeFromEnum Type of mate as defined in 配合类型
Input: (long) alignFromEnum Type of alignment as defined in 对齐选项
Input: (VARIANT_BOOL) flip TRUE to flip the component, FALSE otherwise 是否翻转
距离
Input: (double) distance Distance value to use with distance or limit
mates
Input: (double) distAbsUpperLimit Absolute maximum distance value (see ) 距离限制max Input: (double) distAbsLowerLimit Absolute minimum distance value (see Remarks) 距离限制min Input: (double) gearRatioNumerator Gear ratio numerator value for gear mates 齿轮配合分子值Input: (double) gearRatioDenominator Gear ratio denominator value for gear mates 齿轮配合分母值Input: (double) angle Angle value to use with angle mates 角度
Input: (double) angleAbsUpperLimit Absolute maximum angle value 角度限制max Input: (double) angleAbsLowerLimit Absolute minimum angle value 角度限制min Output: (long) errorStatus Success or error as defined by 错误报告
Return: (LPMATE2) pMateObjOut Pointer to the object 返回指向配合的指针Remarks
To specify a distance mate without limits, set the distAbsUpperLimit and distAbsLowerLimit
arguments equal to the distance argument's value.
指定一个没有限制的距离，设定距离限制的最大、最小值和距离值相等。
