UG二次开发之ug open++类库

ＵＧ二次开发之ug/open++类库UG/ OPEN++类库概述UG/Open++有五种不同的类：应用程序类，对象类，模板类，辅助类，和数学类。

1，应用程序类：控制UG应用程序的运行。

包括：UgSession，UgInfoWindow，和UgException。

2，对象类：定义可以作用于UG零件文件中包含对象的属性和操作。

例如，UgArc，UgFace，和UgExpression等。

表示UG零件的UgPart类，也属此类。

3，模板类：提供平台无关的标准模板库（STL）类，主要用于数组和字符串。

还有一个遍历UG/Open++对象的模板类。

4，辅助类：定义用于其它类定义中的临时对象。

例如：ThruPoint和Evaluator类等。

5，数学类：包括通用数学对象。

与UG对象类结合使用，非常有帮助。

数学类包括点，向量，矩阵，坐标系等类。

通常情况下，每个类都定义在一个独立的头文件中，文件名是该类的名字。

例如UgArc类定义在ug_arc.hxx文件中。

有时一个头文件也包含诸如辅助类等的一些其它类定义。

在UG/Open++中，你可以任意调用一个类的公用方法，但不能调用其私有方法。

保护方法只能在导出类中调用。

●应用程序类对话期类（Session）UgSession类的一个主要作用是进行UG/Open的初始化。

这个初始化是在其它任何UG/Open++方法被调用之前必须进行的。

对话期的初始化和终止由两个静态方法完成，它们是UgSession::initialize ( ) 和UgSession::terminate ( )：UgSession::initalize();// 你的UG/Open++ 代码UgSession::terminate();另外一种方法是创建一个UgSession对象：UgSession mySession ( true );// 你的UG/Open++ 代码关于UgSession，有两个地方需要注意：1.UgSession析构方法将会自动结束UG/Open。

这在超出UgSession对象的作用范围之外时，将会自动发生。

2，当你用以下语法进行创建UgSession对象时，UG/Open的初始化将被阻止，并且析构方法也不能终止这个对话期：UgSession mySession;从功能上讲，上面提到的两种对话期初始化方法与传统的UF_initialize（）方法是完全一样的，在程序的开始，可以使用任何一种方法，但不能同时使用两种不同方法。

这样在下面的程序中，UG/Open++和传统的UG/Open方法就可以被调用。

UgSession也可以用于控制当前UG对话期的状态和行为。

例如，一些UgSession 的方法可以改变当前工作零件，修改层状态，以及关闭所有的零件等。

●对象类：对象类主要定义可以作用于UG零件文件中包含对象的属性和操作。

例如，UgArc，UgFace，和UgExpression等。

表示UG零件的UgPart类，也属此类。

大多数的UG/Open++应用程序都涉及对UG对象的操作。

对象类分为两种：基类和叶类。

基类定义作用于一组相关对象的通用操作，而且它们没有CREATE（）方法。

叶类定义的是作用于某一特定类型物体的操作，而且大多数都定义了CREATE（）方法。

基类表示一组类似的UG对象，而叶类表示一种具体的UG对象。

类的体系关系提供了充分的UG功能性的层次划分，用基类定义这类对象的公用的操作。

另外，在某些时候它利用多重继承来定义没有关系的对象的通用接口。

所有UG对象最顶层的基类叫做UgObject。

它定义了一些所有UG对象都可以使用的通用方法。

例如UgObject::askOwningPart ( )返回一个UG对象所在的零件。

其它基类都来自UgObject类的派生，包括UgTypedObject和UgDisplayableObject （注意绝大多数在UG/Open++中的基类都是以关键字`Object'结束命名的）。

UgTypedObject提供为UG物体命名或删除物体的方法，而UgDisplayableObject 提供诸如更改颜色、图层等方法。

创建对象UG/Open++层次结构树的叶子，是真正代表具体UG对象的C++类，例如UgArc 表示弧线，UgExpression代表表达式。

这些类叫做可实例类，因为可以创建这些类的C++对象，而且每个创建的对象都对应一个UG零件文件包含的UG对象。

要创建一个UG对象，只需调用创建对象的静态方法CREATE（），如下所示：UgPart *pWorkPart = UgSession::getWorkPart ( );UgExpression *pExpr;pExpr = UgExpression::create ( "diameter", 4.25 , pWorkPart );double diaValue = pExpr->evaluate ( );UG对象都是用指针的方式被引用，而不是用对象名称，如上例中的pExpr。

事实上，C++的构造函数是一个保护方法，这样可以避免在不适当的地方错误调用该构造函数。

用指针引用减少了内存的使用，并且保证写出的C++代码与UG模型在任何时候都保持同步。

UgAssemblyNode类是一个没有CREATE（）方法的叶类。

此类的对象创建是用UgPart::addPart ( ):UgPart *pWorkPart = UgSession::getWorkPart ( );UgAssemblyNode *pNode;pNode = pWorkPart->addPart ( "component.prt", "", "",CoordSys ( ), -1 );一些类覆盖了静态的CREATE（）方法，而用其它方法创建UG物体。

下面介绍三种创建表达式的方法：UgPart *pWorkPart = UgSession::getWorkPart ( );UgExpression *pExpr1, *pExpr2, *pExpr3;UgString strName ( "diameter1" );pExpr1 = UgExpression::create ( "radius", 4.25, pWorkPart );pExpr2 = UgExpression::create ( "diameter=2*radius", pExpr1 );pExpr3 = UgExpression::create ( strName, "2*radius" );所有的create函数的最后一个参数都是一个选项参数，来指定零件上下文，也就是说新创建对象的宿主零件。

如果没有指定该参数，则属于当前工作零件。

这个参数既可以是一个指向零件对象的指针，也可以是一个指向属于该零件对象的其它对象的指针。

例如：UgPart *pOtherPart;// 初始化pOtherPart 来指向一个可用的UG零件对象UgExpression *pExprNew;pExprNew = UgExpression::create("length=3.0", pOtherPart);权限控制当一个指向UG物体的指针被定义后，就可以用它来调用该类及其父类定义的所以方法。

例如，如果pArc是一个指向UgArc的指针，那么就可以调用pArc的方法对该UG弧线对象进行查询或修改，代码如下所示：pArc->setRadius ( 2.5 );double len = pArc->computeArcLength ( );int layer = pArc->getLayer ( );上例中调用的三个方法都可以被UgArc对象调用。

但只有setRadius（）方法在UgArc类中被定义，其它两个方法都是在其父类中定义的。

标志与指针转换UG/Open++允许开发代码中包含传统的UG/Open代码，并且进行相关的数据传递。

这就需要进行在UG/Open++的指针和UG/Open的标志之间进行转换。

UgObject::find ( ) 和UgObject::getTag()两个方法可以完成此类转换。

UgObject::find ( )返回一个指向UgObject对象的指针，因此还需要进行类型的强制转换（请参考动态类型转换一节）。

例如：int color;tag_t tag1, tag2;// Call the traditional UG/Open function to select a line.// Note: this returns the tag of the selected line as `tag1'UF_UI_select_single ( ..., &tag1, ... );// Use the `find' method to get the pointer of the Unigraphics// object corresponding to `tag1'UgObject *pObj = UgObject::find ( tag1 );if ( pObj ){UgLine *pLine = dynamic_cast <UgLine *> pObj;if ( pLine ){// Invoke a UG/Open++ method using that pointerpLine->setColor ( Red );// Now convert the pointer back to a tag (`tag2').// Note that `tag1' and `tag2' should be identical.tag2 = pLine->getTag ( );// Call a traditional UG/Open function to get the color// using `tag2' – it should be Red.UF_OBJ_ask_color ( tag2 , &color );}}从以上的例子可以看出，如果一个UG对象没有创建方法的话，UgObject::find ( )方法有可能返回0。

所以，一般来讲，对UgObject::find ( )返回的指针进行检查并进行强制类型转换很有必要。