solidworks二次开发—06—在装配体中添加配合
折腾了三天终于完成了计划中的功能模块。在一个装配体中自动判断插入合适的零件，并添加配合。
在前面几篇文章中我已经基本上说明了如何得到零部件的数据信息、如何插入零部件、如何得到已经选择的特征等。
下面只介绍怎样进行配合
在做配合时，需要经常选择到零件的面、线等，这是一个问题，还有就是介绍一下addmate2函数的使用：
一般进行配合我们按照下面的次序来进行：
1-modeldoc.clearselection2 ‘取消所有选择
2-选择需要配合的实体（entity）
3-使用addmate2函数进行配合
4-再次使用 modeldoc.clearselection2 ‘取消所有选择
主要的问题在于如何选择合适的面：
由于面的命名没有什么规律，很多时候是程序自动来命名的，这样，不方便使用selectbyid来选择，我也不想使用坐标值来选择一个面，那样做更加糟糕。
在得到一个组件（component）或者一个特征（feature）时，我们有getfaces、getfirstface、getnextface等方法，我们可以使用这些方法遍历一个组件或特征等的各个面，来达到选择面的目的，看下面程序：
private function selectface(dcom as sldworks.component2, 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 swmatetype_e
配合类型
input:
(long) alignfromenum
type of alignment as defined in swmatealign_e
对齐选项
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 remarks)
距离限制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 swaddmateerror_e
错误报告
return:
(lpmate2) pmateobjout
pointer to the mate2 object
返回指向配合的指针
remarks
to specify a distance mate without limits, set the distabsupperlimit and distabslowerlimit arguments equal to the distance argument's value.
指定一个没有限制的距离，设定距离限制的最大、最小值和距离值相等
if matetypefromenum is swmatedistance or swmateangle when the mate is applied to the closest position that meets the mate condition specified by distance or angle, then setting flip to true moves the assembly to the other possible mate position.
如果是距离或角度配合，配合将从符合条件的最近端进行配合，我们可以设定flip为true，改变配合至另一个合适的位置
use:使用配合的步骤
modeldoc2::clearselection2(variant_true) before selecting entities to mate.
modeldocextension::selectbyid2 with mark = 1 to select entities to mate.
modeldoc2::clearselection2(variant_true) after the mate is created.
if matetypefromenum is swmatecamfollower, then use a selection mark of 8 for the cam-follower face.
如果配合类型为 凸轮，在表面标示8. 注：这个我也不太明白哈哈
if nothing is preselected, then errorstatus is swaddmateerror_incorrectseletions and pmateobjout is null/nothing.
如果实现没有限定实体来配合，将会抱错swaddmateerror_incorrectseletions，函数返回null或者nothing
上面就是api帮助所说的话，下面给出一段示例程序，假设之前我们已经选择了两个半径一样的圆柱面，那么我们来定义一个同心配合：
set swmatefeat = swassy.addmate2(1, 0, false, 0, 0, 0, 0, 0, 0, 0, 0, nerrors)
其中的 dim swassy as sldworks.assemblydoc
dim swmatefeat as object
注：在编程中有时候不能实现确定一个对象的类型，我们可以声明一个object对象，让vb自己去匹配。但这样做是影响了效率。
要完成一个距离或者角度要麻烦一些，就像上面的remark中说明的：
set swmatefeat = swassy.addmate2(5, 1, true, 0.001, 0.001, 0.001, 0, 0, 0, 0, 0, nerrors)
在这里我们需要将min和max都设置成与距离值相等，要不然配合会认为我们设定了高级配合中的限制条件，会报错。并且第三个参数和第二个参数需要按实际情况来确定。
最后我们列出addmate2的类型：
swmatetype_e
‘specifies values for assembly-mate information.
swmatecoincident 0 重合
swmateconcentric 1 同心
swmateperpendicular 2 垂直
swmateparallel 3 平行
swmatetangent 4 相切
swmatedistance 5 距离
swmateangle 6 角度
swmateunknown 7 未知
swmatesymmetric 8 对称
swmatecamfollower 9 凸轮
swmategear 10 齿轮
