内容提要
? UG/Open API基础概念和语法知识 ? UG/Open API常用对话框及其应用 ? 提示消息的发布与获取
C
H
A
22
P
T
E
R
UG NX 5.0二次开发基础
Open/API（用户函数）是一个程序集合，使得程序员能够访问和操作NX对象模型。除此之外，Open/API还提供了工具用来编辑和连接与UG NX 5.0风格一致的程序。UG/Open二次开发模块是UG NX 5.0软件的二次开发工具集，可用于各种二次开发工作。利用该模块可对UG NX 5.0系统进行用户化剪裁和开发，满足用户的开发需求。使用UG NX 5.0的二次开发时，用户需要具有一定的C语言基础。
UG/Open包括以下几个部分。
（1）UG/Open API开发工具：提供UG NX 5.0软件直接编程接口，支持C、C++、Fortran和Java等主要高级语言。
（2）UG/Open UIStyle开发工具：是一个可视化编辑器，用于创建类似于UG NX 5.0的交互界面。利用该工具，用户可为UG/Open应用程序开发独立于硬件平台的交互界面。
（3）UG/Open Menuscript开发工具：对UG NX 5.0软件操作界面进行用户化开发，使得用户无须编程即可对UG NX 5.0标准菜单进行添加、重组、剪裁或在UG NX 5.0中集成自己开发的软件功能。
（4）UG/Open GRIP开发工具：是一个类似于APT的UG NX 5.0内部开发语言，用户可利用该工具生成NC自动化或自动建模等特殊应用。
22.1 UG/Open API语法基础
由于UG／Open API是UG NX 5.0中最常用的二次开发工具，因此国内外有大量的UG NX 5.0用户投入了大量的精力对UG／Open API的编程进行研究，而且已经掌握了大量的编程技巧，并开发了许多实际的应用。本书在编写过程中，参考了他们的许多经验。
22.1.1 概述
作为UG NX 5.0与外部应用程序之间的接口，UG／Open API是一系列函数的集合。通过UG／Open API的编程，用户几乎能够实现所有的UG NX 5.0功能。开发者可以通过用C++语言编程来调用这些函数，从而实现用户的需求。
（1）对UG part文件及相应模型进行操作，包括建立UG NX 5.0模型、查询模型对象、建立并遍历装配体及创建工程图等。
（2）在UG NX 5.0中创建交互式程序界面。 （3）创建并管理用户定义对象等。
应用函数时应注意，所有的UG/Open API 应用必须及时进行初始化和终止，以确保获取或释放UG/Open API的执行许可权限。
初始化函数是UF_initialize，开始调用UG/Open API的函数时应先调用UF_initialize来获取执行许可权限。一般来说，变量声明完成后，第一个调用的UG/Open API函数就是UF_initialize。
终止函数是UF_terminate，不再需要调用UG/Open API的函数时，必须先调用UF_terminate来释放执行许可。
UG/Open API 程序能在两种不同的环境（依赖于程序的连接方式）下运行，即Internal环境（也叫“Internal开发模式”）和External模式。其中Internal环境下的程序只能在UG NX 5.0的界面环境（session）下运行，在运行这些程序时它们被加载到UG NX 5.0的运行空间中（UG NX 5.0分配的内存）。External模式开发的程序能在各种操作系统（Windowns NT/2000/XP及UNIX）下运行，不在UG NX 5.0环境中或作为UG NX 5.0的子进程运行。尽管没有图形显示，但UG/Open API提供了函数用于打印机或绘图仪输出，也可以输出成CGM文件或其他数据文件。
下面在Visual C??中创建一个基于UG/Open API AppWizard 的项目，来说明初始化函数和终止函数的应用。
【例22-1】 UG/Open API中初始化函数和终止函数的应用。
操作步骤如下。
检查Visual C??的安装目录Microsoft Visual Studio\\common\\msdev98\\Template下是否有文
件ugopen.awx及ugopen.hlp，若有，进入步骤2；否则从UG安装目录$UG_BASE_DIR/ugopen下将这两个文件复制并粘贴到目录Microsoft Visual Studio\\common\\msdev98\\Template下。
启动Visual C++，选择【File】｜【New】命令，弹出【New】对话框，如图22-1所示。
第22章 UG NX 5.0
图22-1 【New】对话框
二次开发基础 473
一 册 通 UG NX 5.0
选择
选项卡，在选项卡下面的列表框中选择【UG/Open APPWizard V18】，在
文本框中输入项目名称“Example”，单击 按钮。在弹出的对话框中按图22-2
所示设置选项。
图22-2 设置选项1
单击
按钮，在弹出的对话框中设置选项，如图22-3所示。
图22-3 设置选项2
单击
NX 5.0二次开发框架。
474
按钮，系统弹出【New Project Information】窗口，如图22-4所示。窗口中
列出了用户选择的所有信息。确认无误后单击 按钮，系统将在指定的目录下创建一个UG
图22-4 【New Project Information】对话框
按快捷键F7，编译Example工程，一般会出现编译成功的信息，如图22-5所示。
图22-5 编译成功的界面 第22章 UG NX 5.0打开【FileView】选项卡，单击【Examplefiles】前的 + 。然后单击【Source Files】前面的＋，双击【Example.cpp】，文件的内容如图22-6所示。 下面给出“Example.h”和“Example.cpp”两个文件的内容，在“Example.cpp”文件中可以找到函数： extern \其函数体中包含着UG/Open API中的初始化函数UF_initialize和终止函数UF_terminate。在进行应用开发时，只需要把相应的代码（代码中的黑体部分）添加到相应的位置，即可完成应用开发。 二次开发基础 475 一 册 通 UG NX 5.0
图22-6 打开Example.cpp文件
Example.h文体内容如下：
/***************************************************************************** **
** Example.h **
** Description:
** Example header file. **
*****************************************************************************/ static void PrintErrorMessage( int errorCode );
Example.cpp文件内容如下：
////////////////////////////////////////////////////////////////////////////// //
// Example.cpp //
// Description:
// Contains Unigraphics entry points for the application. //
//////////////////////////////////////////////////////////////////////////////
// Include files #include
#include
#if ! defined ( __hp9000s800 ) && ! defined ( __sgi ) && ! defined ( __sun ) # include
476