[摘 要] 通过在基于Windows NT平台的UGII（V16.0）中建立对话框、设置和读取对话框中各对象值、激活对话框和执行代码的编写，介绍了开发UGII内部应用程序的基本步骤，并指出了用UG/Open API编程时的注意点。

[关键词] UGII；内部应用程序；二次开发；

中图分类号： TP391.7 文献标识码：A

UGII作为机械领域的高档三维CAD/CAM/CAE软件，因其所具备的工程实用能力和良好的售后服务、技术支持，在国内正拥有越来越多的用户。在为企业提供服务的过程中发现，企业在使用该软件一段时间后，都会提出二次开发的要求，希望通过进一步的开发使UGII能更好地适应本企业的要求，从而进一步提高设计效率，减少使用UGII过程中技术人员的重复操作。所以本文就如何在以Windows NT为操作系统的微机工作站上进行基于VC++6.0的UGII（V16.0）二次开发进行介绍。

UGII的二次开发程序有二种执行方式，可以是在UGII内部运行的程序和在UGII外部运行的程序,内部程序和外部程序开发方法基本相同，只是程序入口和某些API函数不一样，考虑到用户一般都希望所开发的程序能在UGII环境下运行，所以这里主要介绍UGII内部应用程序的开发方法[1-2]。对UGII内部应用程序的开发主要分为四个部分：⑴　环境变量的设置；⑵对话框的建立与激活；⑶对话框对象数据设置和读取；⑷ 执行代码的编写。

1 环境变量的设置

1.1 首先确保已购买了相应的UGⅡ二次开发许可证和执行许可证。

设定UGII启动时所读取的用户文件目录有两种方法：⑴可通过在UG_env.dat中指定UGⅡ_USER_DIR或UGⅡ_SITE_DIR或UGⅡ_VENDOR_DIR，如c:\UGS160\UGⅡ\my_development；⑵可以在操作系统的环境变量中指定，如UGⅡ_VENDOR_DIR=:\UGS160\UGⅡ\my_development。在该目录下建立startup和application子目录以放置用户菜单、对话框和动态连接库；

1.3 设置VC++6.0环境

⑴ 建立一个空的DLL文件

File→new→Projects→Win32 Dynamic-Link Library→输入Project Name→An empty DLL Project→OK；

⑵ 设置编译和连接选项

Project→Settings→C/C++→Category：Code Generation；Use run-time library：Mutli threaded DLL；

Project→Settings→Link→Object/library modules增加UG的二个库文件：libufun.lib、libugopenint.lib；

⑶ 设置Include路径和库文件路径

Tools→Options→Directories→Show directories for→Include files：c:\UGS160\UGⅡ\ugopen；

Tools→Options→Show directories for→Library files：c:\UGS160\ugopen；

2 对话框的建立与激活

二次开发中的一个重要部分就是建立对话框，并在对话框与程序之间进行参数的传递，由于UG/Open UIStyler所创建的对话框与UGⅡ系统本身的对话框风格一致，所以一般用它来创建对话框。

2.1 对话框的建立

启动UGⅡ→Application→激活User interface Styler，建立对话框。

在保存对话框时，UGII自动生成三个文件：

Variable.h：含有指向对话框每个对象的ID。

Variable _template.c：包含了用MenuScript或UG/Open API集成对话框到内部应用程序的框架；

Variable dlg：是菜单脚本所规定的动作与API中激活UF_MB_add_styler_actions 的桥梁。

将对话框头文件和模板文件加入到project中，添加所需要的执行代码进行编译，并将所生成的DLL和 MENU文件存放到startup目录下，将*.dlg文件存放到application目录下。

2.2 对话框的激活

对于内部应用程序而言，对话框可通过三种方式被激活，其调用方式和入口函数如下：

(1)由菜单调用： void ufsta (char *param, int *retcode, int rlen){ 函数体 }

(2)从其它Callback函数调用： int 函数名( int *response ) { 函数体 }

(3)从UG的File→Execute UG/Open →User Function调用该dll文件，激活对话框：

void 函数名 (char *param, int *retcode, int rlen) { 函数体 }

对第1种方式系统使用int UF_MB_add_styler_actions (UF_MB_styler_actions_p_t actions )显示对话框；对于第2、3种方式时，系统调用intUF_STYLER_create_dialog (char*dialog_file, UF_STYLER_callback_info_t * cbs, int number_of_cbs, void * client_data,int * response )建立对话框；

三种不同的调用方式所产生的结果也稍有不同。第1、2种方式，UGII启动时与对话框相关的DLL、menu文件就被同时载入，*.dlg文件则在使用时才被载入；第3种方式，DLL文件和*.dlg在系统调用DLL文件时被载入，所以对话框激活时的各对象初值会有所不同，这在编程时应加以注意。

如果用来建立该对话框的函数名是自已给定的（上述的第2、3种方式），则应在相应的头文件中加以申明。对于从菜单调用的应编写菜单文件，以men为后缀存放到startup目录下面。例：

VERSION 120

EDIT UG_GATEWAY_MAIN_MENUBAR //编辑UGII主菜单条

AFTER UG_TOOLBOX //给定增加菜单的位置，可根据情况规定

CASCADE_BUTTON CUSTOM //给出下拉菜单

LABEL CUSTOM //给出下拉菜单标签名

END_OF_AFTER

MENU CUSTOM //给出菜单项标签

BUTTON C_PICTURE_BTN //在下拉菜单中增加菜单项

LABEL Variable Transfer //给出菜单项名称

ACTIONS Variable.dlg //规定选中菜单项时所执行的动作

END_OF_MENU

图1 UGII中插入的菜单

3 对话框对象的数据设置和读取

了解对话框中对象(Object)的数据结构可以清楚地实现对话框中对象与程序间数据的传递。在UG中所有对话框中的对象（Object）都具有相同的数据结构：

typedef struct UF_STYLER_item_value_type_s {

int reason;

char *item_id; //指出与API程序当前关联的对象名称

int subitem_index;

int count;

int item_attr; //指出与API程序当前关联的对象属性

int indicator;

union{char *string; char *strings; int integer; int *integers;

double real; double *reals; UF_UI_selection_p_t *selection;

} value;

} UF_STYLER_item_value_type_t, *UF_STYLER_item_value_type_p_t;

其中item_id和 item_attr最为重要的，每次对对象的操作都必须首先指定它。下例介绍了如何设定图1对话框中对象Option：

UF_STYLER_item_value_type_t data; //建立一个对象

data.item_id= DIALOG_OPTION_1 ; //指定该对象的ID（可以在头文件中查到）

data.item_attr = UF_STYLER_SUBITEM_VALUES; //指定该对象的属性

data.count=number_of_exps; //指定加入的表达式数目

data.value.strings = point; //传递表达式字符串指针数组的地址给该对象

UF_STYLER_set_value(dialog_id,&data); //对该对象按上述要求进行设定。

同样，读取对象的值时只需按要求设定好ID和ATTR等各项后，使用UF_STYLER_ask_value(dialog_id,&data)可读取该对象的值，如果一次希望读取多个对象的值，则用 int UF_STYLER_ask_values (int dialog_id, int num_values, UF_STYLER_item_value_type_p_t values, int * count )。当然不同Object所要设定的项和读取结果不一样，具体可查阅UIObject Reference。

4 执行代码的编写

在实现与对话框的交互后，就涉及到程序对所获取数据的处理，这主要通过调用UG/Open API中的函数实现，取决于用户对API函数的熟练程度。UGII要求二次开发程序的每个函数执行部分都放在UF_initialize()和UF_terminate()之间，例如对用菜单来激活对话框的入口函数：

void ufsta (char *param, int *retcode, int rlen){
variable declarations；
if((UF_initialize())!=0) // 初始化UG/Open API环境和分配一个UG/Open API执行许可
return;
Function body
UF_terminate()； //释放UG/Open API执行许可
Return ；
}

对话框和UG/Open API中需要用到大量的指针，所以在编写代码时对不用的资源应特别注意通过相应的函数及时释放，否则当对话框增多或操作步骤较多时，极易造成系统的不稳定。

5 结 论

UGII软件本身提供了良好的二次开发功能，为用户进行适合特定要求的二次开发提供了丰富的工具。包括从编辑菜单、建立对话框到抽取或给定部件中对象、特征、装配信息的函数，只要充分运用UGII的现有功能，完全可以实现用户的各种特定要求。