NX二次开发——编程基础

NX与vS版本对应查询：

NX Open C函数名称约定：
标准的是：UF_<>_<>
以前版本：uf<> 和 uc<>
其中
参数输入方式有：
I 表示参数输入，参数在使用前必须赋值
O 表示参数输出方式，使用前无须赋值
OF 表示参数输出，且使用后需要释放内存，UF_free()、UF_free_string()、UF_STYLER_free_value()等

---

数据类型
主要介绍自定义类型：
tag_t类型
在uf_defs.h中，定义：typedet undigned int tag_t,tag_p_t;
tag_t是NX对象的句柄，NX应用程序只能访问句柄，不能直接访问句柄所指示的实际对象。应用程序通过API函数获取句柄，在通过其他函数使用句柄。NULL_TAG表示不标识任何对象。
结构类型 _s
struct UF_STYLER_item_value_type_s
{
int reason;
const char item_id;
int subitem_index;
int count;
int item_attr;
int indicator;
UF_STYLER_value_t value;
}
Typedef struct UF_STYLER_item_value_type_s UF_STYLER_item_value_type_t, UF_STYLER_item_value_type_p_t;
枚举类型 _e

联合类型 _u

---

NX 对象类型及操作
所有对象都是通过唯一的tag_t值进行标识的。
部件对象
不仅包含了几何信息，还包含其他描述信息。
主要函数：
UF_PART_new
UF_PART_open
UF_PART_close_all
UF_PART_save
UF_PART_close
所有函数返回值是错误代码，利用UF_get_fail_message得到错误信息
部件对象查询函数：

函数名称	函数功能
UF_OBJ_cycle_objs_in_part	在部件中查询对象-
UF_ATTR_ask_part_atts	访问部件的属性
UF_PART_reopen	再打开部件
UF_PART_ask_part_name	获取部件的文件名
UF_PJART_ask_customer_area	查询其他信息
UF_PART_ask_description	查询其他信息
UF_PART_ask_status	查询其他信息
UF_PART_ask_part_history	查询部件文件的历史
UF_PART_ask_compression_flags	查询及设置部件文件的压缩标记
UF_PART_set_compression_flags	查询及设置部件文件的压缩标记

UF对象
是哪些具有标识的NX对象，包括几何对象和非几何对象。利用类型与子类型来区别文件的不同对象。
下表是UF对象基本操作函数

函数名称	函数功能
UF_OBJ_set_name	指定查问删除单个对象的名称
UF_OBJ_ask_name	指定查问删除单个对象的名称
UF_OBJ_delete_name	指定查问删除单个对象的名称
UF_OBJ_cycle_objs_in_part
UF_OBJ_cycle_all
UF_OBJ_cycle_by_name
UF_LAYER_cycle_by_layer	遍历
UF_MODL_delete_exp
UF_MODL_delete_feature
UF_MODL_delete_object
UF_MODL_delete_array_of_objects	对象删除
UF_UI_select_single
UF_UI_select_by_class
UF_UI_select_feature
UF_UI_select_sketch	对象选择

UF对象状态
可以使用函数UF_OBJ_ask_status()来查询

UF对象访问方法
创建对象时就可以直接得到对象标识，但是多数情况下需要访问已经在部件存在的对象，可使用一下方法：
循环法：

参数法
表达式
用函数UF_MODL_create_exp()创建表达式
链表对象
提高编程的灵活性，用来存放对象或特征的标识。链表的每一个节点保存一个对象或者特征标识。
uf_list_p_t表示一个NX对象链表的节点指针。
定义：
typedef struct uf_list_s *uf_list_p_t;
struct uf_list_s {tag_t eid;struct uf_list_s *next;};
链表操作函数：

函数名	函数功能
UF_MODL_create_list	创建一个链表，并返回链表的头指针
UF_MODL_put_list_item	插入元素到链表中
UF_MODL_ask_list_count	获取元素个数
UF_MODL_ask_list_item	查询对象标识

属性对象
uf——attr.h中提供了与部件或对象属性的编程接口