SolidWorks API是SolidWorks的OLE应用程序开发接口,用户可以利用它和支持OLE编程的开发工具,如VB、VBA(Excel,Access)、C、VC++等对SolidWorks进行二次开发,建立适合用户需要的、专用的SolidWorks 功能模块。 ^ tm,gh
">voi$Kzey
一、问题的提出 .'7o,)pJ<
r0j:ll d
大多数工程图纸的标题栏中应该包括一些基本的设计信息,如零件名称、零件代号、材料以及设计人员和设计日期等,其中,零件的名称、代号、材料、数量、重量及一些重要的后处理要求等信息还应该出现在装配图的材料明细表(BOM)中。这些内容如果在工程图中一一进行编写和修改,其工作量是很大的,并且这种处理方法也不利于保证设计信息的一致性,对模型文件(零件或装配体文件)和图纸文件的管理来讲是脱节的。SolidWorks是一个全相关的三维机械设计软件,模型文件中的设计数据,如尺寸、注释、文件属性等内容与工程图相关,因此,我们在处理上述工程图标题栏和材料明细表中的设计数据时,应该将这些内容保存在模型文件中,并且自动显示在工程图相应的位置上。当需要对工程图中的内容进行修改时,直接修改模型文件中的相应数据即可实现。 m.EWYO0XQ
XUUS N
这样的处理方法不仅保证了设计信息的一致性,而且可以大大提高设计效率。根据这个设想,笔者将这些设计信息进行了归纳,并将它们作为模型文件的自定义属性保存在模型文件指定配置的属性(在SolidWorks中,选择菜单"文件→属性",单击"指定配置"标签,如图1所示)中,针对模型文件指定配置的这些属性可以自动带入到工程图的标题栏和材料明细表。 Q.6pmaXrb
f+$/gz
对于材料明细表模板进行修改或建立新的明细表模板就可以在装配图中的材料明细表中显示所需要的设计信息(工程图格式文件的定义和材料明细表模板的定义,请参阅《SolidWorks2001中文版实用技术精粹》一书)。因此,无论何时需要修改设计信息,只需在SolidWorks中打开相应的模型文件,修改指定配置属性即可。然而,即使采用这样的处理方法,在修改文件当前配置属性时仍然显得有些繁琐,能否为SolidWorks建立一个工作界面,可以更加方便地添加和修改这些信息就成了问题的关键。 oChcEx%
hlkf|H
二、自定义属性Cpbom it>FG9hVo
Jp5~iC2d
为了更大程度地提高工作效率,我们利用VB6.0通过SolidWorks API建立了自定义属性设置程序--Cpbom,这个程序通过一个对话界面直接对当前模型文件的当前配置进行添加或修改,其基本功能如下: sOLo[5y'
?~S\^4]
☆ 针对配置添加模型文件的自定义属性; OjeM#s#N!
UXa3>q>
☆ 设置的项目包括:零件代号、材料名称、后处理、设计者姓名、设计日期; K$'
J:{yY
=UNzjmP503
☆ 确定自定义属性后,自动保存文件;如当前文件还没有保存,提示文件保存路径和文件名称; m2<sVTN`^
vM\8>p*U
☆ 针对装配文件,可以选择是否删除"材料"和"后处理"两个属性。本程序利用VB进行编译生成可执行文件。自定义属性界面 "自定义属性"程序就是通过SolidWorks API对当前模型文件中当前配置的自定义属性的名称和值进行"读"和"写"的操作,程序非常简单,这里介绍一下该程序中用到的一些SolidWorks API的对象和方法。 0V srAV0
ycCEXu2F
1.SolidWorks对象这里指的是SolidWorks API的最高级别的对象。通过该对象可以控制SolidWorks软件的执行或退出,以及SolidWorks文件的建立、打开、关闭等操作。在VB中利用CreateObject方法来获得SolidWorks对象,利用该对象的activedoc方法可以获得当前SolidWorks文件对象,文件对象为空时,表示SolidWorks 没有打开任何文件。 bEy j8=P;
|$9k
z31
Dim swApp As ObjectDim XF{}St~ (
|'=R`@w~0
activeDocument As ObjectSet swApp=CreateObject("SldWorks.Application") kfA%%A
6]Ppa ~Xwq
Set activeDocument = swApp.activedocIf (activeDocument Is Nothing) Then Dim Msg, Style, title Style = vbExclamation v D}y%}
5oWR}qqFK
title = "模型自定义属性" nKkI
<tgJ-rnL
Msg = "请首先打开一个Solidworks模型文件" P7"g/j" "
> -Jd@7-
Call MsgBox(Msg, Style, title) " Display error message
; >.>vLF
7PP76$
End 01#a
ep,kImT
End If )>$xbo")k
X )g<F
2.获取当前文件信息自定义属性程序是对模型文件设置自定义属性,与工程图文件无关,因此需要利用GetType方法获得当前文件的类型,并利用Gettitle()方法和Getpathname()方法获得当前文件的名称和存盘路径。 (?YTQ8QR
sRb)*p'
Dim docType As LongDim 0P\)L`cG
nY}Ep\g
docName As StringDim (+bk +0
~ N_\V
filename As StringDim $0sUh]7y
HRje4=:
FilePath as StringdocType = activeDocument. m/%sBw\rx
O^4:4tRpt
GetTypeIf (docType = swDocPART) f(7/
)iluu1,o
Then docName = "零件"With CPbomfrm .deldescription.Enabled = False .delmaterial.Enabled = FalseEnd With Picture5.Picture = Picture3.Picture p?=rQte([
`gD'q5.z;3
ElseIf (docType = swDocASSEMBLY) Then docName = "装配" Picture5.Picture = Picture2.Picture 4wMKl6mL
Qy5\qW'
ElseIf (docType = swDocDRAWING) Then Style = vbExclamation Msg = "当前文件是工程图文件,请打开零件或装配文件" (?I8/KYR
:kflq
Call MsgBox(Msg, Style, title) " Display error message {Qg"1+hhM
&T}~h^/t
End 7oh6G
Zz,E4+'Rm
End 2|kx:^D p
.P9ALJP(b
If filename = activeDocument.GETTITLE() \ d+&&ns
.& B_\*
FilePath = activeDocument.getpathname() Qp!r_a&
rM<c;iQ
3.获取文件配置名称SolidWorks API提供了按照配置名称访问自定义属性的方法--CustomInfo2(读取自定义属性的值)、deletecustominfo2(删除指定的自定义属性)、ADDcustominfo3(添加自定义属性的名称和参数值),这些方法都要求指定文件的配置名称。因此,为了对当前模型文件和当前配置设定自定义属性,必须首先要获得当前配置的名称,利用GetActiveConfiguration()方法可以获得当前模型文件配置的对象,并利用Name方法获得当前配置的名称。 RAR"9 N
.
S;MS,R
Dim ConfName As StringSet -?&wD["y
H)G ^ Y1
CurCFG = activeDocument.GetActiveConfiguration() O:q 0-
?msx
ConfName = CurCFG.Name /Rb`^n#
| wKZ-6
4.按照配置访问自定义属性在本程序中,笔者对于指定配置的属性设置按照如下的步骤: N3TkRJZ
8BhLO.(<O
(1)按照配置名称读取文件中的自定义属性值,并赋值于相应的文本框; &M*&oi (
J,_I$* _0
(2)判定当前文件和当前配置是否已经改变,如其中之一发生变化,则提示错误信息; uK="#1z cC
IFH%R>={
(3)根据配置名称删除指定的自定义属性; oXK`=.\
Se%FqI
(4)将相应文本框中的内容按照配置名称添加到模型文件自定义属性名称和参数值。下面对上述控制配置自定义属性的三种方法加以介绍。 Gyk>5Q}}
nUz2~z
☆ CustomInfo2:获取或设置当前文档指定配置的自定义属性的值。 O+@"l$;N
x4pl#~Su
value = ModelDoc.CustomInfo2 (configuration, fieldName) M4XnuFGB[w
%XMrSlSOp
其中,configuration为配置名称; ~*ZB2
$oHlfV/!
fieldName为自定义属性的名称。 nMNAn}~*M
~2beVQ(U
☆ deletecustominfo2:删除当前文档指定配置的自定义属性的值 l&dHH_m3
Ts:3_4-k
retval = ModelDoc.DeleteCustomInfo2(configuration, FieldName ) @c,}\"(
5-0
☆ ADDcustominfo3:向当前文档中指定的配置添加自定义属性以及值 #%il+3J
=4/LixsV|
retval = ModelDoc.AddCustomInfo3 ( configuration, FieldName, FieldType, FieldValue ) 0e^j :~*
F=EAD3
其中,FieldType为自定义属性的类型;FieldValue为自定义属性的值。 B)Hs>Mh|W
cmmH)6c>
下面这段代码是单击"确定"的子程序,为了简单,只给出了其中一个自定义属性的处理过程。 403%~
ZsirX~W<
Private Sub cmd_OK_Click()On Error GoTo ERR_91 |qE"60&"}
KM*sLC#
Dim swApp2 As ObjectDim U#gHc:$
_Z~wpO}/
activeDocument2 As ObjectDim &kB[jz_[A
T?I&n[Y|
curcfg2 As ObjectDim U59uP
7n
p4\%*ovQt
cfgname2 As StringDim mR,p?[P
?C(Z\"IX
retval As BooleanSet {6!Mf+Xq
\7nlwFAO
swApp2 = CreateObject("SldWorks.Application") Ka1
F7b
wO@b=1j
Set activeDocument2 = swApp2.activedoc @tdX=\[~
f#pT6
Set curcfg2 = activeDocument2.GetActiveConfiguration()
&THM]3:
ps[TiW{q;
cfgname2 = curcfg2.Name" 判断文件或配置是否改变,如改变,则提示错误。 B!K{y>|.
mDC{c ?
If cfgname2 = ConfName And FilePath = activeDocument2.getpathname() Then " 删除属性设置 >G92k76G
c>{6NSS -
retval = activeDocument2.deletecustominfo2(ConfName, "PartID")" 添加属性 7uFM)b@.P
2mP|
hp?
retval = activeDocument2.ADDcustominfo3(ConfName, "PartID", swCustomInfoText, frmPartID) " 保存文件 -@b&qi7&S
S3PW [R@=
retval = activeDocument2.Save() >|KfO>
.r)WDR
Else Style = vbExclamation + ^{;o0kcx
7=N=J<]pl
title = "模型自定义属性" |j&u2DM~#m
0|9(oP/:
Msg = "错误:打开的文件或配置已经改变!" & Chr(10) & "请重新执行本程序" c5>&~^~>Tx
"5BgajrB
Call MsgBox(Msg, Style, title) :!;BOCTYI
%4Ylq|d
End 1wmS?
zkYlIUD
End <~!7? ak
~j" aJ /
IfERR_91: Style = vbExclamation title = "模型自定义属性" jb$sIZ%i
t(VG#}
Msg = "程序运行错误,文件可能已经关闭" & Chr(10) & "自定义属性无法添加,单击确定退出!" AGQCk*dm
fz31di9$
Call MsgBox(Msg, Style, title) 9-eYCg7C|
1 h|cr_
End Y=sRVypJ
7=0uG
End Sub T D].*9
FjRJSMwO,
三、在SolidWorks界面中执行应用程序 (P~Jzp9u
2x{@19w)C
对于使用VB编译的EXE、DLL文件,目前SolidWorks还不能直接支持这些文件作为插件使用,如果要在SolidWorks 中直接调用通过VB编译的可执行程序,可以使用SolidWorks"宏"操作来进行。利用"宏"在SolidWorks界面中添加指定的应用程序后,就好像SolidWorks调用了自身的功能一样,利用类似的方法,可以在SolidWorks添加任何可执行的文件。下面利用"自定义属性"程序来说明一下步骤。1.建立"宏"文件在SolidWorks中,我们利用录制并修改"宏"的方法来建立所需要的"宏"文件。主要步骤如下: T5)Xl 'Q
{H#1wu^]O$
(1)选择菜单"工具→宏操作→录制"。 2/sD#vC
9Gfm?.O5
(2)停止录制,并保存宏文件。给定文件名称,如:Cpbom.swp。 qEX2K^y'4"
73P=<3
(3)选择菜单"工具→宏操作→编辑",把Cpbom.swp "宏"文件录制的内容全部删除,并输入下面的内容。 L^yQb4$&M
FVMR9~&+
Sub main()MyAppID = Shell("C:Program FilesCPbomCPbom.exe", 1) AppActivate MyAppID 18z{d9'F
d?GfT$1
End Sub YYr &Jcj
kXzm
(4)保存并退出宏编辑,返回到SolidWorks环境。 9xP{#Qa
5s8S;Pb]<