简介这份源码包面向NX二次开发工程师针对BlockUI对话框无法同时打开或切换模块的开发限制提供了一套在NX7.5及以上版本可用的非模态对话框实现方案聚焦检验、检查、BOM工具等需要多窗口交互的业务场景作者通过封装继承NXModelessDialog类的结构并定义回调函数原型解决了焦点冲突等交互细节。压缩包共2个文件包括inscode核心源码文件与html说明文档整体仅有3KB结构紧凑适合快速查阅与移植。已有178人学习下载示例覆盖NX7.5与NX2306两个版本可以帮助理解不同版本下的实现差异并掌握非模态对话框的开发与排错思路。包内文件虽少但提供了从类封装到回调绑定的完整最小实现开发者可基于此快速集成到自己的NX工具中避免从零研究接口限制。 搞NX二次开发的人应该都有这种经历对话框弹出来后整个NX界面就锁死了你在图形区里想选个面、转个视角全部得先点“确定”把对话框关掉。一次两次还能忍要是做那种需要反复选对象、反复试算的工具模态对话框真的是能把人逼疯。所以我这次干脆把对话框做成非模态的把源码整理出来遇到类似需求可以直接拿去改。这篇文章会围绕NX二次开发中非模态对话框的实现讲清楚为什么需要非模态、怎么选实现方案、完整源码怎么搭以及我在实际调试过程中踩过的那些坑。适合正在做NX二开、想给工具加一个“不挡操作”的辅助面板的人参考。1. 项目背景与需求解析1.1 模态对话框把用户锁死在工作流之外模态对话框Modal Dialog和非模态对话框Modeless Dialog最本质的区别是模态对话框弹出后会独占整个NX进程的输入用户在关掉它之前没办法跟主窗口做任何交互非模态对话框则不会打断主流程两边可以并行操作。绝大多数NX二次开发初学者接触到的第一个对话框界面都是BlockUI的Styler对话框默认就是模态的。BlockUI的形态是“对话框弹出来填参数点确定执行逻辑关闭”。这种模式适合参数设置类、单次执行类的工具比如“创建圆柱体”“批量改名”一次性输入完参数就结束。但如果你的工具天然是一个“持续存在”的辅助窗口比如批量测量工具用户需要一边在图形区点选对象一边在面板上看实时结果再比如一个装配导航辅助窗口用户希望在处理零件的同时面板上始终显示当前装配状态的信息。这种场景下用模态对话框体验极其反人类——用户每点一次图形区对象都要重新打开一次对话框中间还要忍受窗口闪来闪去。1.2 非模态对话框适合哪些典型场景从我的实际经验看非模态对话框在NX二开里最适合这几种场景辅助工具面板面板常驻在窗口一侧用户不主动关就一直显示比如颜色批量设置、图层管理、对象信息查询。实时交互选择用户点击按钮后到图形区选择对象选择结果回填到面板中再在面板上做下一步操作。监测/日志类窗口工具执行过程中实时输出日志、错误信息用户可以随时查看而不中断当前操作。多窗口协同工具比如同时打开多个部件的对照面板需要在不同窗口之间切换操作。说白了什么时候需要非模态就是“对话框只是工具的一部分而不是工具本身”的时候。2. 技术方案选型与核心原理2.1 三种实现方案对比NX二次开发里搞对话框主流就是三条路BlockStyler、MFCC、WinFormsC#/.NET。我做个对比表格方案语言开发效率界面自由度非模态支持维护成本BlockStylerC / C#高低只能按模板来基本不支持本质是模态低MFC对话框C低界面代码量大高Win32/MFC控件随便摆支持良好但需要细心管理资源高WinForms窗体C# .NET高高控件拖拽代码控制支持良好垃圾回收自动管理中我的选择是C# WinForms理由很简单BlockStyler在非模态这块基本是绕不过去的MFC写起来又太痛苦。C#这边用窗体做界面开发效率高和NXOpen .NET API的对接也很成熟代码结构清晰。2.2 为什么BlockStyler做不了真正的非模态很多人一开始都会问BlockStyler能不能改成非模态我试过结论是BlockStyler在非模态需求面前基本是个死胡同。BlockStyler对话框的底层机制是在Show()过程中开启了一个内部的消息循环直到用户点击“确定”或“取消”后回调执行完对话框销毁程序才往下走。你可以在代码层面绕过这个流程比如先创建对话框再手动Shown但这样会导致NX Open的UI管理器和NX主窗口之间出现消息冲突表现就是窗口“看似非模态”实际上一碰NX图形区就失去响应。所以在“让用户流畅操作图形区”这个需求面前最稳妥的路线就是跳过BlockUI直接用WinForms做窗体。WinForms窗体是独立的窗口不依赖NX的UI管理器天然支持非模态显示。2.3 非模态对话框的线程模型与API调用红线这里必须重点说一个概念NX窗口的真正主人是NX主进程的UI线程所有NXOpen调用都必须在UI线程上执行。WinForms窗体如果是在NX的UI线程上创建的那窗体的事件回调按钮点击、定时器触发也都在UI线程上跑此时直接调用Session.GetSession()和NXOpen API是安全的。但如果窗体的事件是在后台线程比如BackgroundWorker或Task.Run里触发再去调NXOpen API轻则抛出异常重则直接把NX进程搞崩。红线只有一条后台线程只做计算和数据处理绝对不要碰NX对象。需要更新NX模型时用Control.BeginInvoke把操作切回UI线程再执行。3. 核心源码拆解与实操3.1 环境准备VS2019 NXOpen.NET我这次用的环境是Visual Studio 2019 NX系列开发语言C#。如果你用的是别的VS版本配置大同小异。步骤新建项目选择“C# Windows窗体应用.NET Framework”目标框架建议.NET Framework 4.7.2或更高。添加引用在项目引用的“浏览”里找到NX安装目录下的NXBIN\managed文件夹添加以下DLLNXOpen.dllNXOpen.UF.dllNXOpenUI.dll将引用到的NX DLL的属性“复制本地”设为False避免生成的exe带一堆大文件。配置调试如果你想把入口函数暴露给NX调用项目类型不需要是exe类库也能用关键是入口方法要写成public static int Main(string[] args)。编译平台建议选x64NX是64位进程程序集位数对不上会在加载时直接报错。3.2 C#非模态对话框完整源码下面是我整理好的一个最小可用版本。功能很简单弹出一个非模态窗体窗体上两个按钮一个拿当前工作部件的路径一个统计当前部件里实体数量。你可以在它基础上加自己的逻辑。using NXOpen; using NXOpen.UF; using System; using System.Windows.Forms; namespace NxNonModalDemo { public class Demo { private static Session theSession; private static UFSession theUfSession; private static Form dlg; private static ListBox listBox; public static int Main(string[] args) { theSession Session.GetSession(); theUfSession UFSession.GetUFSession(); // 创建并显示非模态对话框 CreateDialog(); return 0; } private static void CreateDialog() { dlg new Form(); dlg.Text 非模态对话框演示; dlg.Size new System.Drawing.Size(320, 260); dlg.StartPosition FormStartPosition.CenterScreen; Button btnPart new Button(); btnPart.Text 获取当前工作部件; btnPart.Location new System.Drawing.Point(20, 20); btnPart.Size new System.Drawing.Size(160, 30); btnPart.Click BtnPart_Click; Button btnCount new Button(); btnCount.Text 统计实体数量; btnCount.Location new System.Drawing.Point(20, 60); btnCount.Size new System.Drawing.Size(160, 30); btnCount.Click BtnCount_Click; Button btnClose new Button(); btnClose.Text 关闭; btnClose.Location new System.Drawing.Point(20, 100); btnClose.Size new System.Drawing.Size(160, 30); btnClose.Click (s, e) dlg.Close(); listBox new ListBox(); listBox.Location new System.Drawing.Point(20, 140); listBox.Size new System.Drawing.Size(270, 80); dlg.Controls.Add(btnPart); dlg.Controls.Add(btnCount); dlg.Controls.Add(btnClose); dlg.Controls.Add(listBox); dlg.FormClosed Dlg_FormClosed; // 关键Show()不是ShowDialog()这就是非模态的入口 dlg.Show(); } private static void BtnPart_Click(object sender, EventArgs e) { try { Part workPart theSession.Parts.Work; if (workPart null) { listBox.Items.Add(当前没有工作部件); return; } listBox.Items.Add(工作部件 workPart.FullPath); } catch (NXException ex) { listBox.Items.Add(错误 ex.Message); } } private static void BtnCount_Click(object sender, EventArgs e) { try { Part workPart theSession.Parts.Work; if (workPart null) { listBox.Items.Add(当前没有工作部件); return; } int solidCount 0; foreach (Body body in workPart.Bodies) { if (body.IsSolidBody) { solidCount; } } listBox.Items.Add(实体数量 solidCount.ToString()); } catch (NXException ex) { listBox.Items.Add(错误 ex.Message); } } private static void Dlg_FormClosed(object sender, FormClosedEventArgs e) { dlg.Dispose(); dlg null; } } }3.3 运行机制与后续扩展思路这段代码里最关键的一行是dlg.Show()。Show()和ShowDialog()的区别在于ShowDialog()会启动一个嵌套消息循环代码会卡在方法里不往下走Show()只是把窗口显示出来然后立即返回主流程继续。所以窗体显示出来后NX主界面仍然可以正常操作窗口和图形区互不阻塞。实测下来用Show()显示的非模态窗体在NX里运行机制非常稳定窗体可以拖动、缩放NX图形区也能继续响应鼠标键盘。但有几个细节要记住入口方法Main()执行完就结束了如果没有全局变量dlg持有窗体引用窗体可能被垃圾回收表现为“窗口闪一下就消失”。所以窗体引用必须用static字段持有。所有按钮事件里都加了try-catch这对于非模态窗口尤其必要。因为模态对话框出错时NX会把错误直接弹出来非模态窗口出错时如果没捕获异常可能会抛到NX的消息循环里导致NX无响应。listBox.Items.Add在多次点击时会一直追加更严谨的做法是先清空再添加或者用ListView展示这里为了精简没有写。扩展到实际项目中这个结构还能做很多事在按钮事件里调用theUfSession.Ui.SelectWithSingleDialog让用户在图形区选择对象然后读取坐标用System.Windows.Forms.Timer做定时刷新实时获取当前坐标平面或视图信息用TreeView展示当前部件的装配结构点击节点后高亮对应对象把窗体改成面板式布局停靠在NX窗口边界附近模拟“侧边工具栏”效果。3.4 C/MFC方案的关键代码对比如果你项目组定死了C那非模态对话框一般用MFC实现。思路和C#类似在NX入口函数里创建并显示一个非模态对话框。关键代码结构大致是这样static CMyDlg* g_pDlg NULL; extern C DllExport void ufusr(char* param, int* returnCode, int rlen) { if (g_pDlg NULL) { g_pDlg new CMyDlg; g_pDlg-Create(CMyDlg::IDD, NULL); g_pDlg-ShowWindow(SW_SHOW); } }C方案里有几个C#不会遇到的问题对话框资源句柄要从DLL模块里手动切换否则资源加载不到g_pDlg指针需要在DLL卸载时清理MFC的CWinApp初始化等。整体维护成本比C#高不少。所以我推荐大家优先用C#做非模态对话框除非项目边界强制要求C。4. 常见问题与排查技巧4.1 对话框弹出后窗口假死我调试时遇到的第一类问题就是窗口弹出来了NX主界面点了没反应或者窗口一出现就白屏。排查思路确认你是不是用了ShowDialog()。用了ShowDialog()等于在NX自己的消息循环里又套了一层模态循环两个循环互相抢消息一定会卡。确认事件回调里有没有长时间阻塞的操作。比如在按钮事件里直接for循环遍历一万个面界面肯定会卡因为UI线程被占死了。如果需要在回调里做大量计算用BackgroundWorker或Task.Run把计算放后台但后台线程里绝对不要调NX API只做纯数据计算完成后用Control.BeginInvoke回到UI线程更新界面和NX对象。4.2 对象句柄失效导致崩溃非模态窗口的特点就是生命周期长用户在窗口打开期间可能不断切换工作部件、修改模型、删除对象。一旦NX对象被删掉窗体里缓存的引用就成了无效句柄再访问就会抛NXException或直接崩溃。我的建议是不要在窗体字段里保存NX对象引用每次需要时通过theSession.Parts.Work等方式取最新对象事件回调里统一包try-catch捕获到NXException后提示用户重新选择或刷新长期存活的窗体要监听WhenObjectDeleted之类的事件对象删除时同步清理控件状态。4.3 引用与编译环境问题很多人在VS里编译时遇到“未能加载文件或程序集NXOpen.NET”之类的报错。这种问题九成是引用的DLL版本和当前NX版本不一致导致的。N X的.NET DLL都在安装目录的NXBIN\managed下不同大版本NX1847、NX2206、NX2312等的DLL不一定能互相兼容。解决方式很简单把全部NX相关的引用都从当前使用的NX安装目录添加然后把每个引用的“复制本地”设为False避免VS把DLL拷贝到输出目录造成版本混乱。程序集目标平台设置成x64。4.4 窗口生命周期管理非模态窗口关闭后要确保资源释放干净。C#这边FormClosed事件里做Dispose就行。C那边要复杂一些要在DLL卸载入口里检查g_pDlg指针是否存在存在就DestroyWindow加delete。还有一个容易忽略的问题NX执行完一个入口方法后如果程序集被NX标记为“可卸载”窗体还在显示的话后续回调可能访问不到已经卸载的程序集代码。我的做法是在入口方法里通过菜单注册把窗口挂到NX菜单上或者让DLL在NX会话期间保持驻留具体看你的开发模式。5. 实操心得与几点补充个人经验非模态对话框真正考验人的不是“弹窗”本身而是窗口生命周期和NX对象状态的管理。我是从BlockStyler转向WinForms做非模态的第一版踩了不少坑最主要的心得是非模态窗口里不要放太多需要跟NX交互的功能能异步就异步能缓存数据就缓存数据。一个非模态面板尽量设计成“轻量辅助”的角色把重逻辑放到独立线程或者NX命令里这样才能保证用户操作流畅。另外你现在看到的是WinForms的版本如果项目里用的是Qt或者其他UI框架原理是一样的只是控件体系不同核心还是Show()和线程模型“两个点”。最后再分享一个小技巧做非模态对话框时工具箱里多个控件要养成统一的命名习惯比如按钮都以btn开头文本框都以txt开头。界面功能一多事件回调里找控件会快很多。这个习惯能帮你省下大量不必要的精力。本文还有配套的精品资源点击获取