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 UF

def 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 session
    the_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。

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