UG-NX二次开发基础-OpenAPI

《UG-NX二次开发基础-OpenAPI》由会员分享，可在线阅读，更多相关《UG-NX二次开发基础-OpenAPI（37页珍藏版）》请在装配图网上搜索。

1、CHAPTER2UG NX 50二次开发基本内容提纲U/Open P基本概念和语法知识UG/Open API常用对话框及其应用 提示消息的发布与获取Open/API(顾客函数)是一种程序集合,使得程序员可以访问和操作N对象模型。除此之外，Oen/API还提供了工具用来编辑和连接与UG NX5.风格一致的程序。UG/Oen二次开发模块是UG NX .0软件的二次开发工具集，可用于多种二次开发工作。运用该模块可对UG X 5.0系统进行顾客化剪裁和开发，满足顾客的开发需求。使用UG NX 5.0的二次开发时,顾客需要具有一定的语言基本。UGOpen涉及如下几种部分。（1）U/Opn P开发工具:提

2、供G NX 50软件直接编程接口,支持C、C+、Fora和Jva等重要高档语言。(2）UGOpn UIStl开发工具：是一种可视化编辑器,用于创立类似于U NX 5.0的交互界面。运用该工具,顾客可为UG/pe应用程序开发独立于硬件平台的交互界面。（3)UG/Open Menusipt开发工具:对GNX .软件操作界面进行顾客化开发,使得顾客不必编程即可对UGN.原则菜单进行添加、重组、剪裁或在GNX 5.0中集成自己开发的软件功能。(4）/penGRIP开发工具：是一种类似于APT的U X 0内部开发语言,顾客可运用该工具生成NC自动化或自动建模等特殊应用。221 UG/Ope AI语法基本

3、由于UG/Op A是G 5.0中最常用的二次开发工具,因此国内外有大量的GX 5.顾客投入了大量的精力对UG/Oen 的编程进行研究,并且已经掌握了大量的编程技巧,并开发了许多实际的应用。本书在编写过程中，参照了她们的许多经验。221. 概述作为UG NX 5.0与外部应用程序之间的接口,GOen API是一系列函数的集合。通过UOen API的编程,顾客几乎可以实现所有的UG X5.0功能。开发者可以通过用C+语言编程来调用这些函数，从而实现顾客的需求。()对U par文献及相应模型进行操作,涉及建立U NX.0模型、查询模型对象、建立并遍历装配体及创立工程图等。（)在G NX5.0中创立交

4、互式程序界面。()创立并管理顾客定义对象等。应用函数时应注意,所有的/Open API 应用必须及时进行初始化和终结,以保证获取或释放G/pn AP的执行许可权限。初始化函数是UF_intialize，开始调用UG/e PI的函数时应先调用UF_nitialie来获取执行许可权限。一般来说,变量声明完毕后,第一种调用的UG/Opn API函数就是Finitie。终结函数是UF_termina,不再需要调用G/Open PI的函数时，必须先调用UF_terine来释放执行许可。UG/enP 程序能在两种不同的环境（依赖于程序的连接方式)下运营,即Inte环境（也叫“Internal开发模式”）和

5、Eternal模式。其中ntrnl环境下的程序只能在G 50的界面环境（esin)下运营,在运营这些程序时它们被加载到U X .的运营空间中（UGNX5.0分派的内存）。teral模式开发的程序能在多种操作系统(Wndows N/及UNIX)下运营,不在UGNX 50环境中或作为UG N 50的子进程运营。尽管没有图形显示,但G/OpeI提供了函数用于打印机或绘图仪输出,也可以输出成CGM文献或其她数据文献。下面在VisualC+中创立一种基于GOpen APIppWzard 的项目,来阐明初始化函数和终结函数的应用。【例2-】UGpen PI中初始化函数和终结函数的应用。操作环节如下。检查V

6、sual C+的安装目录icrosot Visual Sdiocmmonmsdev98Template下与否有文献ugopenax及ugoenhlp，若有，进入环节2;否则从G安装目录$UG_BASE_DR/ugopen下将这两个文献复制并粘贴到目录MicosVsual Stocommonsde98mplte下。启动Vsual C+，选择【Fle】【New】命令,弹出【New】对话框,如图22-1所示。图2- 【New】对话框 选择 选项卡，在选项卡下面的列表框中选择【UG/pen AWiard V18】,在 文本框中输入项目名称“Exmple”，单击 按钮。在弹出的对话框中按图-2所示设立选

7、项。图-2 设立选项单击 按钮，在弹出的对话框中设立选项,如图22-所示。图22 设立选项2单击 按钮，系统弹出【New roet Information】窗口,如图22所示。窗口中列出了顾客选择的所有信息。确认无误后单击 按钮,系统将在指定的目录下创立一种U N50二次开发框架。图24 【e roect Inforatio】对话框按快捷键7,编译Example工程,一般会浮现编译成功的信息，如图225所示。图2-5 编译成功的界面打开【Fileiew】选项卡,单击【Exampefes】前的+ 。然后单击【ourc les】前面的,双击【Example.pp】,文献的内容如图26所示。下面给出

8、“xaple.”和“Exmple.cp”两个文献的内容，在“Eaple.cpp”文献中可以找到函数:extern CDllExprt vod fusr(char*parm,int *rtunCod， int ren )其函数体中涉及着/Ope API中的初始化函数U_nitialize和终结函数UF_triate。在进行应用开发时,只需要把相应的代码(代码中的黑体部分)添加到相应的位置，即可完毕应用开发。图26 打开ample.p文献Eample.h文体内容如下:/* Exam.h* escriptio:* xe hder file*/stat vid PntErrorssag( iterro

9、rde);Examplp文献内容如下：/ Exae.cp/ Descriio:/ Contains Uigraphcs entry pon fo te pplatin./ Includ ies#iclude #inclue uf_u.#f ! defie（ _hp90000 ) & ! defined ( _i ） & ! deied （ _sn ）incdeing t：:ostrseam;usig sd:edl;using std：:end;ele#include strstremh#enif#inclue xcueUG/en-Usr Funtion.xtrn C llExprt vid u

10、fsr( ch parm， i*returnoe， it ren) /* Itaize theAInirnmn */ terrrCoe= UFnitialie()； i ( 0 =eoCode ) /* TODO: Adour apiaton cod her */ /* Triatthe AI eionment */ eroCde UF_termina（)； /* Printout an erroesges * Printrroresag（ rrorCode );/-/ Utiiti/-/noad Handle/ s fctio specifieswhn unlod your pction f

11、 nigrapics./ If your aplcatin registrs a cllback (frm a MenuSrpt itm ora/ User Defid Oect for eaple), hisfunctonMUST return/ UF_NLOA_UGTERMNATE.xer C fus_sunloa( oid )retur( UF_UNLOAD_UG_TEITE);/ PrintrrMesage* Prits err essagstostanrd ro an te Unigps stat* lin. /stati vd inErroressge( itrorCode ) f

12、 (0！= rroCoe） /* Rtriv th assoiate error sage * char sage133; UF_get_fail_message（ errorCode，message ）; /* Pritout themeage */ UF_UIsetsaus( messag ); / Construct a fer to hold thtext. srtrearrrag; Inializ th buffe with th required text. ror_meage n Erro: endl messge nl end d; / Write the mesageo st

13、anda err cerr error_messae.tr（)； 在创立几何模型、遍历模型或执行其她某些基本操作时，必须一方面创立或打开一种Ungacs Part文献。2212 UOpn API函数名称及数据类型作为Uniraphi二次开发的一种重要模块，G/Open API在函数名称和数据类型方面均有自己的某些独特风格，本章将分别予以简介。U/penAPI的函数名称一般采用原则名称商定,其格式为:F_are_名称中各部分的阐明如下。(1)UF：表达 UGOen API 函数。（)are：一般是模块功能和首字母的缩写，例如MOD和DISP 是Modlg 模块和iplay功能的缩写。（3)nae

14、:被下画线分开的动词和名词,例如UF_OD_ceate_block1是UG/Ope APIModlng模块中创立立方体的函数,U_DIPst_highlight是高亮显示对象的函数。在数据类型方面,除了原则的语言数据类型外,UG/OpenAP还提供了某些自定义的数据类型,如tagt类型、构造类型、联合类型与指针类型等。下面简介几种常用的类型。1.tag数据类型UG/OeAPI使用最多的数据类型是tag_t，在UG/Open AI的uf_d.h中对该类型的定义如下:yped ungned int ta_t, *tag_t;该类型把UG/pe PI与对象模型联系起来。当U的模型被加载到U环境中后，

15、ag_t相称于对象的唯一标记。大部分的UG/pen API函数参变量列表中均有一种tg_t 指针或ag_t 类。它类似于C语言中的指针,例如当要查询一种点对象的坐标时,送入查询函数中的tagt应是点类型的几何对象,而不是线或面等其她几何对象的tag_。此外,ta_p_t是指向ta_t数据类型的指针。以部件对象为例,下面的代码一方面获取部件的tgt值,然后获取该句柄所引用部件对象的文献名。ag_ttrt;Pr=UFASSEMaskworkpt（);harFie561;_PART_aspartnae（tPrt,sle);由于代码中加入了函数U_ASEM_ask_workpart()，因此调试程序时

16、应加入头文献clde 。UG/OpenI拥有大量用于创立及修改nigraphis对象的函数和过程。UG/Oen AP的部分函数不提供错误信息,在创立对象时一般返回对象的标记(ta_t)。当返回的对象标记为NLL_TAG 时,表达创立对象时浮现了错误。2.构造类型（trcreye）UG/OpeI采用C语言的语法定义了某些常用的构造类型,将互相联系的不同类型的数据封装在一起使用。这些构造类型用后缀“_s”表达，下面给出一种使用构造类型的例子。typef struc F_ASSE_optons_sit rason;ons crimid;nt sbitem_ind;itcunt;nt item_att

17、r；tndicaor;UF_ASSEM_oios_s,*UF_ASSEM_options_s_t;3.联合类型(Union tpe）有时需要将不同数据类型的变量放在同一段内存单元中，这种使不同变量占用同一段内存的构造类型称为“联合类型”。联合类型与构造类型的定义形式相似，但含义不同。联合类型变量所占的内存长度等于其内部最长数据成员的长度乘以变量个数，而构造类型变量所占的内存长度则是其各数据成员所占内存长度之和。U/Oe P采用C语言的语法定义了某些常用的联合类型,使用后缀“_u”表达，下面给出一种使用联合类型的例子。nionUF_ASSEM_opions_char*asemchar；int i

18、tgr;nt inees;doubl assem;obl sse;F_Iseeon_pt selection；;tyedfuion UFAEM_tionu UF_ASEoptions_t;枚举类型（En type）枚举类型将变量的值一一列举出来，变量的值只限于列举出来的值的范畴。UG/Oen AI采用C语言的语法定义了某些常用的枚举类型,使用后缀“e”表达。下面给出一种使用枚举类型的例子。nu F_ASSEM_opos_eU_ASSEM_o,UF_ASSEM_ncel,U_SSEMnoladed,FASSEM_spresse,；tyedef eum U_SEM_optionse U_ASEM_

19、optios_t；213 UG/Open对象类型与操作所有的UNX 5.0对象类型都通过它们唯一的标记来引用,这些UG NX5.0对象分类如下。（1）部件对象(Prt obect）。(2）U对象(F objs),指uf_bject_tpes.中阐明的对象。(3）体现式（Expresins）。对于每一类对象，UG/On API中均有明确的函数对它们进行操作，下面分别简介。1.部件对象部件对象是G N 5.最基本的操作对象之一，它涉及了部件中大量的几何与非几何信息。每一种加载到UGN 5.环境中的pr文献，均有一种关联的部件对象（prt ojc)代表它,系统会为每一种部件对象分派一种标记符(ta)

20、。UG/en P提供的访问和操作部件文献的函数涉及部件文献的创立、打开、关闭、保存和信息的查询等,这些函数重要封装在头文献fpat.h中,涉及：UFATTRk_at_atrs（)访问prt的属性UFOJ_cycle_objsin_part（）在pat中查询对象UF_PRT_clse（)关闭patUFPART_eopen()再打开partUF_PART_as_art_nae（） 获取a的文献名U_PAR_se_dpa_art() 设立显示部件U_RT_skpathistry() 获取部件的历史UART_ask_cstmer_aea（) 查询顾客定义的数据UF_PAT_ak_dsriton(）查询

21、par的描述信息U_ART_as_status() 查询part的状态信息FRT_set_custer_aa() 设立顾客定义的数据F_PART_set_deiptin()设立art的描述信息U_PAst_ttus(） 设立art的状态信息UF_PART_a_cmprssio_flgs() 查询art的压缩标记UF_PATset_ompressio_fas()设立ar的压缩标记下面给出一种例子来讲述at文献的创立、打开、关闭和存盘等操作。【例222】 Part文献的创立、打开和关闭操作。操作环节如下。在例221中加入下面的头文献:includ upt.iclude foj.h把下面的代码添加到

22、例21中黑体代码所在的位置,按快捷键F7,编译xaple工程,浮现编译成功的信息。F_PRT_lod_sttus_t eror_status ;char prt_ame133= I:Eampebuest.pt;nt units = 1 ; / 单位采用米制tag_ part；UFAR_new (pat_nae, units,pr）; / 创立est.rif ( pat = ULTAG ）uc1601(创立Prt错误, 1)；F_PRT_cloe_al (); /退出之前关闭所有paterroroe = U_ermat();urn;lsc161(ts创立成功,1）;uc161(tst被设为显示p

23、ar并且被打开，);UF_PAR_sedipa_part (pt ); /显示testprtUFPART_open (part_ame，pr， ror_sas);UF_ee_sting_rray(eor_tatus.n_rs,errorsta.lenm);Ffree (error_taus.stuses );启动UNX5.0软件，选择【文献】【打开】命令,弹出【执行顾客函数】对话框如图22-7所示。图22-7 【执行顾客函数】对话框在 下拉列表框中选择文献夹“ExapleDebug”，选中文献“Exmpe.l”,然后单击 按钮,弹出的消息对话框如图2所示,提示顾客ts创立成功。图2-8运营“E

24、xample.ll”文献后弹出的【消息】对话框单击 按钮,弹出【消息】对话框如图2-9所示，提示顾客tes被设立为显示并且被打开。图22-9 提示顾客打开“tt.part”文献的【消息】对话框继续单击 按钮,Pa文献“tet.part”被打开，如图22-10所示。接下来可以创立模型，单击 按钮后打开文献夹“:Exampeebug”，即可发现文献“tst.par”。图22-1 新建零件界面2.UF 对象U X 5.中的大部分公共对象都是头文献uf_objt_ypsh和uf_ob.h中定义的对象。所有这些对象均有明确的函数与它们相应,只有特定的对象子类和可显示的对象有此外的函数与它们相应。UF对象

25、的可用措施如下。(1)指定、查询及删除单个对象的名称,例如：FBJ_eame() 指定对象名UFOBJs_name() 查询对象名F_OJdeame() 删除对象名（2）查询遍历对象，例如：UF_OBcycle_obsart（) 在pa中遍历对象U_OBJ_cycl_all(） 在目前工作part中遍历对象F_OB_cycl_by_am() 通过对象名称查询对象由于UG NX 5中对象存储方式的独特,因此函数F_OB_cycle_ob_in_part（）比函数FO_ye_ll()、UFO_cycl_name()和UF_LER_cle_by_lye(）更为有效。因此建议使用UFOJ_ycle_o

26、bjs_n_part()而不是UF_OBJ_cleall(）、 _BJcycleb_name（)或UFLAYER_cycle_bylayer()。3体现式体现式提供GN 5.中的参数化建模的机制,它能控制特性，特性也随体现式的变化而变化。一种体现式可在多种特性中使用，这样它的变化将能变化多种特性。体现式的一般形式是:ae = aluenme为体现式名称,alue为体现式的值。体现式可以是数字或条件等式。体现式名可以用于体现式值中，其首字符必须是字母,其她字符可以是数字、字母或下画线等。体现式名是大小写敏感的。一种par文献中的体现式名应唯一。下面是某些体现式值的例子:egth = .5 +2

27、* sin (ang)potio f(wit= 2) (15* wt) ele()一般说来体现式的使用函数都在头文献 uf_ml.中定义。如果体现式串中仅仅提供体现式值，U N 5.会自动为其命名。如体现式串定义为diaeter /2，UG NX .0会赋给它一种类似于f的名字。固然我们建议按下列形式赋值:radius = iater /2。下面列出了头文献uf_modl_genel.中定义的常用体现式操作函数：UF_DL_crate_（)创立体现式U_MDL_reae_exp_tag()得到创立的体现式的标签UFMOD_disect_exp_strin()分解名字和值返回名字、值和体现式的标

28、签UF_MD_ask_ep()返回体现式名和体现式值UF_MOLeval_p(）输入体现式的名，返回体现式值UF_MODL_edi_x()用新的值替代体现式中原有的值UF_MODL_update（)用新的值替代体现式中原有的值， 使用后应用函数来更新模型FODLreamee()给已有体现式赋新的名称UFOL_as_es_offeature()返回制约某特性的所有体现式的标签UF_MODsk_exsofpart()返回某部件（prt）的所有体现式的标签F_MODL_sk_e_tag_sting( )输入体现式标签,返回该体现式串下面给出一种例子来阐明常用体现式操作函数的使用措施。【例22-3】

29、创立一种长方体并显示出体现式信息。操作环节如下。在例22-中加入下面的头文献:#includ f_md.h把下面的代码添加到例22-1中黑体代码所在的位置,按快捷键F7，编译Exmple工程，浮现编译成功的信息。car*blockn3 0,20,30;dobl blocorig3= 00,00，00;tag_blk_obj;innumbe_of_xps=0, i;UF_UI_pe_listing_wndow（);/ 创立长方体特性_MODL_creae_bck1(UFULIGN，blockorig, ock_en, lk_obj);ag_ xps;/ 查询长方体特性所涉及的体现式UF_MODL

30、_ask_x_of_featu(lk_o,&nue_fexp ，&ep ）；car sting;charam ;nae0 = l;nme = w;nme2 = h;strig =0;UF_MODL_ask_expsof_feat(bk_ob,&b_eps ，exp）;for （ i = 0 ; i Free(id)；pMalloc-Reease();启动GNX 50软件,选择【文献】【执行】|【打开】命令,弹出如图2-17所示的对话框。选择生成的动态库文献“Example.dll”，单击 按钮，弹出如图-9所示的文献夹选择对话框。图22-19 执行“Eamed”文献生成的文献夹选择对话框在调试

31、上面的程序时应加入下面的头文献：#includ#ncle shloj.22.3 选择菜单列表对话框UGOpen PI的选择菜单对话框有两种，即单选菜单列表对话框和多选菜单列表对话框，分别通过子过程c103和c1605实现,下面将具体简介。uc103用于显示一种选择菜单对话框,该菜单可以涉及14个菜单选项,并可以通过变量参数设定默认的选择项。若变量参数为0，则不设定默认选项,同步【拟定】按钮变灰。菜单选项的返回值介于和18之间，虽然用者选择菜单项1,那么返回值是5，使用者选择菜单项,那么返回值是18。下面是返回值的阐明。(1）1：回退。(2）2:取消。(3)518:选中了的菜单项。（4)19:不

32、容许状态,不能启动对话框。uc05解决多选菜单的问题，与uc63不同,该子过程没有默认的选择项,数组变量的每一种元数的初值是0。下面简介返回值及参数。(1）：回退。(）：取消。(3）3：接受。(4)4：有多种选项被选择。(5）：不容许状态，不能启动对话框。【例227】 创立单选菜单列表对话框和多选菜单列表对话框。操作环节如下。把下面的代码添加到例221中黑体字代码所在的位置,按快捷键7,编译xample工程，浮现编译成功的信息。har ingleenut=单选菜单列表对话框;int kDfaul=;ha MnuOptins8=选项1,选项,选项;i umOfption=;uc1603(Sngl

33、eMenuStr，OkDeult,Mention,NuOfOption);启动UG N.0,选择【文献】【执行】【X打开】命令，弹出如图2-所示对话框。选择生成的动态库文献“Exmple.ll”,单击按钮，浮现如图220所示的单选菜单列表对话框。图2-2 执行“Exmple.dll”文献生成的单选菜单列表对话框把下面的代码添加到例22-1中黑体字代码所在的位置，执行与上面相似的操作,即可得到如图22-21所示的多选菜单列表对话框。char ieuSr=多选菜单列表对话框;in*temMenu;ha euOtions38=选项1,选项2,选项3;itNumOfOpton=3;c0(SinglMe

34、nur,0,MenOtions，NmOfpion,IeMeu); 图1 执行“Emple.d”文献生成的多选菜单列表对话框22.4 对象选择对话框UG/OpI提供了专门的接口“UF_I”模块,让开发人员开发的应用可以从Ungrahics图形界面选用几何对象。常用的对象选择对话框有两种：单对象选择对话框与按类选择对话框。F_U模块中的函数重要实现两种功能:一种是通过有过滤功能的函数,把开发者定义的可选对象选出来;一种是弹出对话框,让顾客在可选对象中选择一种或多种对象。这些函数都在头文献f_ui.h中定义。下面简介这两个常用的对话框。注意，调用这两种对话框之前UG环境中必须有工作部件存在。1按类选

35、择对话框按类选择对话框通过函数UFUI_elec_with_lassdalog创立，并且可以一次选择同类的多种对象。如果返回值是UFUI_OK，则被选择的对象保持高亮状态,固然也有也许没有选中任何对象。若返回值是UF_I_BAK或UF_U_CANEL,所有被选的对象都不会高亮显示。默认的可选对象是所有的可选原则类型，开发人员还可以通过函数F_UI_se_s_rcs来指定特殊的过滤过程及选择回调。函数_I_at_sel_l用于事先指定已选对象。【例22-8】创立按类选择对话框。操作环节如下。把下面的代码添加到例22-的exteC DlExpor vodufsr( chaparm,it*etrnC

36、ode, inten ）函数中:/定义初始化进程函数#define UFCL(） （Rep(_ILE_, _LINE_, X, ()it Rport（h*fle, it li, ha*call， intirc)rern (ir);sta int nt_pc(UF_UIelection_p_tselect，oi*uerdata)int nutype=2；U_UI_mask_t mask_riles=F_lin_pe,0,0,F_lid_type,0, UF_UISEL FEAURE_AYEDG;f(UF_L(UFUI_st_semask(select,UFI_S_AK_LEAR_ANDENABL

37、_PEIF，numtype,mak_tple）)=0)return (UF_UI_SLSUCCSS);lseeturn (UFUISEL_ALR);把下面的代码添加到例22-1中黑体字代码所在的位置,按快捷键F,编译Exme工程,浮现编译成功的信息。/按类选择对话框 cr TyelogBo=按类选择对话框;chrDalogBoxitle按类选择对话框;it Scope=UF_SE_SCPE_NO_CHAGE;int spnse;int ont;tagt* atObject;UF_LL(UF_I_selc_ithclass_daog(yeDilogox，DiogBoxitle,coe,it_poc，UL,Reons,nt,&atObjet）；启动UG N 5.0,选择【文献】|【新建】命令，创立新部件,弹出如图22-1所示对话框,在 文本框中输入“pat”,单击 按钮,浮现如图2-1所示的界面。选择【文献】|【执行】【X打开】命令,弹出如图22-17所示对话框。选择生成的动态库文献“xample.dll”，单击 按钮,弹出按钮 。单击 浮现如图2-22所示的按类选择对话框。在上面的函数中一方面定义了一种初始化进程函数int_oc，在该函数体中使用函数UF_UIse_elmask设立被选对象的类型(可以