Siemens-NXUG二次开发-打开与关闭prt文件[Python UF][20231206]

1.python uf函数

1.1 NXOpen.UF.Part.Open

# 内部和外部模式可用
"""
官方文档翻译：将现有NX part或Solid Edge part检索到会话中，并使其成为工作和显示part。
通过从Solid Edge part中提取Parasolids数据，然后将该数据导入到扩展名为.prt的新NX part中，可以打开Solid Edge部件（.par、.psm、.pwd或.asm文件扩展名）。
新NX part的文件名具有Solid Edge part名和“.prt”文件扩展名。
如果存在与Solid Edge part同名的现有NX part，则此函数将返回错误。
通过打开Solid Edge part文件创建的NX part文件包含一个或多个未参数化的实体。
可以通过此调用打开其他文件。
以下扩展名有效-.udf、.bkm、.xpk和.jt。
具有以下扩展名的外来文件也可以使用UF_PART_open打开-.igs、.stp、.dxf、.dwg和.model。
返回值：一个元素，0位置元素为打开part的tag(python语言的int类型)，1位置元素为NXOpen.UF.Part.LoadStatus类对象
"""
def NXOpen.UF.Part.Open(self, part_name)

1.2 NXOpen.UF.Part.LoadStatus

# 内部和外部模式可用
类：NXOpen.UF.Part.LoadStatus(在NXOpen C API中是struct UF_PART_load_status_s)
对象方法：
# 如果加载失败并回滚，则为True
def NXOpen.UF.Part.LoadStatus.Failed(sel)	
def NXOpen.UF.Part.LoadStatus.Failed(self, value)# （len:n_parts，free:UF_free_string_array）分配的文件名数组
def NXOpen.UF.Part.LoadStatus.FileNames(self)	
def NXOpen.UF.Part.LoadStatus.FileNames(self, value)# 以下两个已分配数组的长度。加载时出现错误或警告的part数目，这是file_names和status数组中的元素个数（范围）。
def NXOpen.UF.Part.LoadStatus.NParts(self)	
def NXOpen.UF.Part.LoadStatus.NParts(self, value)# （len:n_parts）为每个文件名分配的相关状态代码数组。对数组中的每个状态代码使用UF_get_fail_message来获取关联的消息字符串，必须释放已分配的数组
def NXOpen.UF.Part.LoadStatus.Statuses(self)	
def NXOpen.UF.Part.LoadStatus.Statuses(self, value)	# 如果唯一的“失败”是用户中止，则为True	
def NXOpen.UF.Part.LoadStatus.UserAbort(self)	
def NXOpen.UF.Part.LoadStatus.UserAbort(self, value)	

1.3 NXOpen.UF.Part.Close

# 内部和外部模式可用
"""
官方文档翻译：关闭部件树中选定的零件以及它下面的所有零件（可选）。如果您在内部模式下运行此程序，系统会显示一个确认窗口，询问您是否应该关闭修改后的part。如果在外部模式下运行此程序，系统会认为该part应该关闭。
使用UF_part_close关闭part不会删除NX中的撤消标记。因此，如果使用此函数，可能会消耗大量内存。要释放此内存，请在调用UF_PART_close之后调用UF_UNDO_delete_all_marks。
scope指定要关闭的多少part:
0=仅指定部分;
1=part和所有子组件。
mode：
0=询问是否修改了零件（仅限内部，外部假设回答“是，删除”）；
1=卸载part，即使已修改
2=仅在未修改的情况下卸载part
"""
def NXOpen.UF.Part.Close(self, part_tag, scope, mode)

1.4 NXOpen.UF.Part.AskUnits

# 内部和外部模式可用
"""
官方文档翻译：返回一个值，该值指示part的单位是英制还是公制。
返回值：
（NXOpen C API宏定义值）UF_PART_METRIC（NXOpen Python UF API:NXOpen.UF.UFConstants.UF_PART_METRIC）;
（NXOpen C API宏定义值）UF_PART_ENGLISH（NXOpen Python UF API:NXOpen.UF.UFConstants.UF_PART_ENGLISH）。
"""
def NXOpen.UF.Part.AskUnits(self, part_tag)	

2.示例代码

import NXOpen.UF as UFdef get_uf_session():# 获取当前UF会话return UF.UFSession.GetUFSession()def pyuf_open_prt(the_pyuf_session, open_prt_file_name):"""功能：打开一个指定文件路径和文件名的.prt文件"""# 由于要对Part进行操作，因此需要获取Part实例对象pyuf_part_instance = the_pyuf_session.Part# Open方法位于Part类对象中return pyuf_part_instance.Open(open_prt_file_name)def pyuf_close_prt(the_pyuf_session, part_tag, scope, mode):"""功能：关闭当前工作part"""# 由于要对Part进行操作，因此需要获取Part实例对象pyuf_part_instance = the_pyuf_session.Part# Close方法位于Part类对象中return pyuf_part_instance.Close(part_tag, scope, mode)def pyuf_get_prt_units(the_pyuf_session, part_tag):"""功能：查询某prt的单位制"""# 由于要对Part进行操作，因此需要获取Part实例对象pyuf_part_instance = the_pyuf_session.Part# AskUnits方法位于Part类对象中return pyuf_part_instance.AskUnits(part_tag)if __name__ == '__main__':# 获取uf sessionthe_pyuf_session = get_uf_session()# 打开prt文件路径与名称open_prt_file_name = 'D:\\pyuf_open_prt_test.prt'# 打开D盘根目录下的示例.prt文件，并成为工作prt（work part）# 如果是在内部模式运行，则会在NX/UG界面打开一个名为pyuf_open_prt_test.prt的文件窗口# 如果是外部模式运行，则运行时不会有启动ug界面open_prt_file_data = pyuf_open_prt(the_pyuf_session, open_prt_file_name)# 查询prt的单位制unit_type = pyuf_get_prt_units(the_pyuf_session, open_prt_file_data[0])prt_unit_string = ""if unit_type == UF.UFConstants.UF_PART_METRIC:prt_unit_string = "metric"elif unit_type == UF.UFConstants.UF_PART_ENGLISH:prt_unit_string = "english"# 外部模式运行，会在命令行中打印，但内部模式运行则无反应，因在UF.UI类中操作，才可在NX/UG界面显示数据# 由于与NX/UG界面UI操作的方法都在UI类中，因此先获取UF.UI示例对象pyuf_ui_instance = the_pyuf_session.Ui# 判断信息窗口是否打开if pyuf_ui_instance.IsListingWindowOpen() == False:# 信息窗口未打开，先要将其打开# 打开信息窗口pyuf_ui_instance.OpenListingWindow()# 向信息窗口写入内容pyuf_ui_instance.WriteListingWindow('\nopen_prt_file_name is:' + str(open_prt_file_name))pyuf_ui_instance.WriteListingWindow('\nopen_prt_file_tag type is:' + str(type(open_prt_file_data)))pyuf_ui_instance.WriteListingWindow('\nopen_prt_file_tag is:{}'.format(open_prt_file_data))pyuf_ui_instance.WriteListingWindow('\nunit_type type is:{}'.format(type(unit_type)))pyuf_ui_instance.WriteListingWindow('\nunit_type is:{}'.format(unit_type))pyuf_ui_instance.WriteListingWindow('\nprt_unit_string is:{}'.format(prt_unit_string))# 将信息窗口的内容保存到指定文件中pyuf_ui_instance.SaveListingWindow('D:\\pyuf_listingwindow_content_test.txt')# 关闭信息窗口#pyuf_ui_instance.ExitListingWindow()

3.运行结果

3.1 内部模式

选中要运行的.py文件后，点击“管道通路”即可。

运行结果：

3.2 外部模式

cmd命令：“D:\Siemens\NX 12.0\NXBIN\run_journal.exe” pyuf_open_prt.py。
powershell命令：&“D:\Siemens\NX 12.0\NXBIN\run_journal.exe” pyuf_open_prt.py。

运行结果（内存访问违例，不知道为什！！！）：