简介这份资源面向从事NX二次开发、需要实现用户自定义特征的C开发者围绕CustomFeature的测试记录与问题处理展开。内容涵盖核心库与UI库的分工、CustomFeatureConfiguration.xml的配置要点以及FeatureClass、FeatureName、FeatureIcon、FeatureLibrary、FeatureUILibrary、IsWithoutBody等属性的含义与常见坑点并整理了创建、修改、更新前回调等关键方法的实现思路与头文件引用方式。资源包共1个docx文件约18KB以文档形式集中记录测试过程与排错经验便于对照查阅。目前已有348人学习下载。读者可借此理清自定义特征从XML注册到DLL部署的完整链路掌握对话框区分创建与编辑模式、属性读取与默认值初始化等细节并参考其中的异常处理与日志记录思路减少因配置不当或实体标志设置错误导致的报错适合具备一定NXOpen基础的开发者进阶参考。1. 自定义特征加载失败从两个 DLL 和一个 XML 说起如果你正在做 NX 二次开发并且尝试用 C 实现 CustomFeature大概率会遇到这样一个场景代码编译通过DLL 也生成了但打开 NX 后自定义特征就是不出现或者出现了却报“不能创建体”的异常。这不是玄学而是 CustomFeature 的加载机制在作祟。它不像普通 NXOpen 程序那样把 DLL 放对位置就能跑而是需要两个 DLL 加一个 XML 配置文件三者严格配合。很多开发者第一次踩坑就卡在这里明明按文档拷了文件特征列表里却空空如也。这篇文章适合正在被 CustomFeature 加载、注册、回调、编辑异常卡住的开发者我会把踩过的坑和排查路径一条条拆开让你能照着命令和配置直接定位问题。2. 特征不显示或加载报错XML 配置与 DLL 部署的排查2.1 两个 DLL 和一个 XML 到底该放哪CustomFeature 的部署结构比普通 NXOpen 项目多一层约束。你需要把编译生成的Core DLL实现特征创建逻辑和UI DLL处理对话框交互连同CustomFeatureConfiguration.xml一起放到 NX 的application文件夹下。常见做法是放在%UGII_USER_DIR%\application或%UGII_CUSTOM_DIRECTORY_FILE%指向的目录里。如果只放了 DLL 没放 XMLNX 启动时不会报错但特征类根本不会注册你在历史树里也找不到任何痕迹。我一般会先确认三件事XML 文件名是否严格为CustomFeatureConfiguration.xml大小写敏感两个 DLL 是否和 XML 在同一目录以及 XML 里的FeatureLibrary和FeatureUILibrary是否和实际 DLL 文件名一致不带.dll后缀。很多“特征不显示”的问题根源就是 XML 里写的是BlockAndCylinderCore而实际生成的 DLL 叫BlockAndCylinderCore.dll名字对不上NX 直接静默跳过。2.2 XML 里每个属性写错会报什么XML 的格式看着简单但每个属性都直接对应代码里的类名或资源名写错一个就可能导致加载失败或运行时异常。下面是一段可对照的配置示例?xml version1.0 encodingutf-8? CustomFeatureLib xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:noNamespaceSchemaLocationCustomFeatureConfiguration_schema.xsd CustomFeature FeatureClassNXOpen::CustomFeature::BlockAndCylinder FeatureNameBlock And Cylinder FeatureIconblock_and_cylinder FeatureLibraryBlockAndCylinderCore FeatureUILibraryBlockAndCylinderUI IsWithoutBodyfalse/ CustomFeature FeatureClassNXOpen::CustomFeature::SamplePolygonalHole FeatureNamePolygonal Hole FeatureIconpolygonal_hole FeatureLibraryPolygonalHoleCore FeatureUILibraryPolygonalHoleUI IsWithoutBodytrue/ /CustomFeatureLibFeatureClass必须和 C 代码里注册的类名完全一致包括命名空间。FeatureName是显示在 UG 历史模型记录里的名字写错了用户看到的特征名就不对。FeatureIcon对应图标资源名没有图标不会导致加载失败但历史树里会显示默认图标。FeatureLibrary和FeatureUILibrary分别指向 Core 和 UI 的 DLL 文件名不带扩展名。IsWithoutBody是最容易翻车的一个如果特征只创建曲线、不创建实体必须设为true否则双击编辑时会直接抛异常提示“不能创建体”或“没有目标体”。2.3 用 listing window 确认注册是否成功当你不确定特征类有没有被 NX 识别到最直接的验证方式是在 Core DLL 的入口函数里加一段输出。常见做法是在构造函数中获取CustomFeatureClassManager然后调用GetClassFromName看返回值是否为空// Core DLL 入口处验证类是否注册成功 NXOpen::Features::CustomFeatureClassManager *mgr theSession-CustomFeatureClassManager(); NXOpen::Features::CustomFeatureClass *cfClass mgr-GetClassFromName(NXOpen::CustomFeature::SamplePolygonalHole); if (cfClass NULL) { UF_UI_open_listing_window(); UF_UI_write_listing_window(CustomFeature class NOT found!\n); } else { UF_UI_open_listing_window(); UF_UI_write_listing_window(CustomFeature class registered OK\n); }这段代码的逻辑是从当前 session 拿到特征类管理器再按 XML 里写的FeatureClass全名去查。如果返回空指针说明 XML 没被加载、DLL 没放对位置或者类名拼写有误。参数NXOpen::CustomFeature::SamplePolygonalHole必须和 XML 里的FeatureClass一字不差。输出到 listing window 是为了在不打断 NX 启动的前提下快速确认注册状态比弹窗更省事。3. 双击编辑报“不能创建体”IsWithoutBody 与回调注册的坑3.1 IsWithoutBody 设错导致的异常这个报错我见过太多次特征创建成功历史树里也能看到但双击想编辑时直接弹窗“不能创建体或者没有目标体”。根因几乎都落在IsWithoutBody上。如果你的特征只生成曲线、点或基准面不生成实体那么 XML 里必须写IsWithoutBodytrue。写成false时NX 会认为这个特征应该输出实体编辑时找不到目标体就抛异常。判断标准很简单打开 Core 代码里的createGeometryCallBack看它最终往trackingObjectVector里塞的是 Parasolid 实体还是 NX 对象曲线、点。如果只有曲线就老老实实把IsWithoutBody改成true。改完 XML 后不需要重新编译 DLL但需要重启 NX 让配置重新加载。3.2 五个回调没注册全的后果CustomFeature 的核心逻辑分布在五个回调里preUpdateCallBack、createGeometryCallBack、modifyGeometryCallBack、postUpdateCallBack、informationCallBack。这些回调必须在 Core 类的构造函数里通过AddPreUpdateHandler、AddCreateFeatureGeometryHandler等方法注册到CustomFeatureClass上。漏注册任何一个对应的阶段就不会执行你的代码。// 在 Core 类构造函数中注册五个回调 NXOpen::Features::CustomFeatureClassManager *mgr theSession-CustomFeatureClassManager(); NXOpen::Features::CustomFeatureClass *cfClass mgr-GetClassFromName(NXOpen::CustomFeature::SamplePolygonalHole); cfClass-AddPreUpdateHandler(make_callback(PolygonalHoleCore::preUpdateCallBack)); cfClass-AddCreateFeatureGeometryHandler(make_callback(PolygonalHoleCore::createGeometryCallBack)); cfClass-AddModifyFeatureGeometryHandler(make_callback(PolygonalHoleCore::modifyGeometryCallBack)); cfClass-AddPostUpdateHandler(make_callback(PolygonalHoleCore::postUpdateCallBack)); cfClass-AddInformationHandler(make_callback(PolygonalHoleCore::informationCallBack));make_callback把静态成员函数包装成 NXOpen 需要的回调对象。参数就是你在类里声明的五个静态函数地址。如果GetClassFromName返回空后面的注册全部无效所以务必先确认类名正确。注册顺序不影响执行但建议按生命周期顺序写方便排查时对照日志。3.3 编辑时读不到属性值FeatureData 的读取时机二次编辑时UI 需要从已有的CustomFeatureData里把属性值读出来回填到对话框控件上。这个逻辑要写在对话框的初始化阶段而不是 APPLY 里。典型写法是先判断GetEditedCustomFeature()是否为空// 在对话框初始化中区分首次创建和二次编辑 NXOpen::Features::CustomFeature* editedFeature mgr-GetEditedCustomFeature(); if (editedFeature NULL) { UF_UI_open_listing_window(); UF_UI_write_listing_window(初始化中第一次创建\n); } else { NXOpen::Features::CustomFeature *cfFeature (NXOpen::Features::CustomFeature *)editedFeature; NXOpen::Features::CustomFeatureData* cfData cfFeature-FeatureData(); PopulateUIFromCustomFeatureData(cfData); UF_UI_open_listing_window(); UF_UI_write_listing_window(初始化中二次编辑\n); }GetEditedCustomFeature()返回非空说明用户是双击已有特征进入编辑此时要从FeatureData()里按属性名逐个读取。表达式属性用CustomExpressionAttributeByNameTAG 属性用CustomTagAttributeByName读出来后再dynamic_cast成具体类型Expression*、Direction*、Point*、Body*。如果读不到先检查属性名是否和创建时CreateCustomExpressionAttribute传入的字符串一致大小写敏感。4. 创建成功但模型树异常TrackingData 与 ConstructionFeature 的避坑记录4.1 避坑一实体没做布尔运算却不显示现象Core 回调里用 PK 函数创建了实体createGeometryCallBack也返回了 0但模型树里看不到这个体图形窗口也是空的。原因CustomFeature 不会自动把 PK 创建的实体纳入显示管理。如果你没有在回调里把实体注册到TrackingDataNX 就不知道这个体属于当前特征自然不会显示。解决在createGeometryCallBack里为每个输出实体创建TrackingData并调用AppendOutputTrackingData// 为 PK 创建的实体注册 TrackingData std::vectorNXOpen::Features::TrackingData* trackingObjectVector; NXOpen::Features::TrackingData *trackObject1 event-CreateTrackingDataForParasolidEntity( (NXOpen::Features::CustomFeatureEvent::ParasolidId)output1); std::vectorNXOpen::NXObject * objVector1; objVector1.push_back(dynamic_castNXOpen::NXObject *(body)); trackObject1-AddTagSourceEntities(objVector1); trackingObjectVector.push_back(trackObject1); event-AppendOutputTrackingData(trackingObjectVector);CreateTrackingDataForParasolidEntity的参数是 PK 实体的 ParasolidIdAddTagSourceEntities把 NX 对象和这个追踪数据关联起来。最后必须调用AppendOutputTrackingData否则前面创建的 TrackingData 不会生效。4.2 避坑二面没有加入 TrackingData 导致选不中现象实体显示出来了但用选择过滤器选面时选不到或者后续特征引用这个面时报“找不到面”。原因只注册了体级别的 TrackingData没有把体的各个面也加进去。NX 的拓扑引用需要面级别的追踪数据。解决遍历实体的所有面为每个面创建 TrackingData 并设置整数键// 将实体的每个面也加入 TrackingData for (int i 0; i numFaces; i) { NXOpen::Features::TrackingData *trackObject event-CreateTrackingDataForParasolidEntity( (NXOpen::Features::CustomFeatureEvent::ParasolidId)faces[i]); trackObject-AddIntSourceEntity(i 1); trackingObjectVector.push_back(trackObject); }AddIntSourceEntity(i 1)给每个面一个唯一整数标识后续通过这个标识可以反查面。numFaces和faces数组需要你从 PK 实体上提前查出来。4.3 避坑三NX 函数创建的对象在 preUpdate 里没设 ConstructionFeatureData现象用UF_MODL_create_cyl1等 NX 函数创建了辅助体或基准几何但模型树里不显示或者显示为游离特征而不是当前 CustomFeature 的子节点。原因NX 函数创建的特征默认不属于 CustomFeature需要在preUpdateCallBack里用CreateConstructionFeatureData包装并设置SetShowInGraphicView(true)。解决// 在 preUpdateCallBack 中包装 NX 函数创建的特征 std::vectorNXOpen::Features::ConstructionFeatureData* ConstructionFeatureDataVector; UF_MODL_create_cyl1(..., tCyFeatTag); UF_MODL_ask_feat_body(tCyFeatTag, g_tCylTag); NXOpen::Features::Feature *nxFeat dynamic_castNXOpen::Features::Feature *( NXObjectManager::Get(tCyFeatTag)); NXOpen::Features::ConstructionFeatureData *outputFeatData event-CreateConstructionFeatureData(nxFeat); outputFeatData-SetShowInGraphicView(true); ConstructionFeatureDataVector.push_back(outputFeatData);CreateConstructionFeatureData把普通特征转换成构造特征数据SetShowInGraphicView(true)控制是否在图形窗口显示。如果不需要显示设为false即可。这些数据要在preUpdateCallBack里准备好因为几何创建阶段会用到。4.4 避坑四不参与显示的体没有调用 SetBodies现象某些中间体或辅助体在创建后一直显示在图形窗口即使用户不需要看到它们。原因没有明确告诉 NX 哪些体不参与最终显示。CustomFeature 默认会把所有 PK 实体都当作输出。解决在回调里用SetBodies明确指定不显示的体// 设置不参与显示的体 std::vectorNXOpen::Features::CustomFeatureEvent::ParasolidId bodiesVector; bodiesVector.push_back((NXOpen::Features::CustomFeatureEvent::ParasolidId)output1); event-SetBodies(bodiesVector);SetBodies接收一个 ParasolidId 向量列表里的体不会出现在最终结果中。注意这个调用要在AppendOutputTrackingData之前或之后根据实际需求调整通常放在几何创建完成后。4.5 避坑五属性名拼写不一致导致读取为空现象二次编辑时CustomExpressionAttributeByName(m_polygonSides)返回空指针后续SetValue直接崩溃。原因创建属性时用的名字和读取时用的名字不一致比如创建时写m_polygonSides读取时写成m_polygonSidesAttrib。解决把属性名统一用常量管理创建和读取都引用同一个常量。如果已经出现不一致用HasCustomAttribute先判断再读// 安全读取属性先判断是否存在 NXOpen::Features::CustomTagAttribute *sectionAttrib cfData-HasCustomAttribute(section, NXOpen::Features::CustomAttribute::TypeTag) ? dynamic_castNXOpen::Features::CustomTagAttribute*(cfData-CustomTagAttributeByName(section)) : NULL; if (sectionAttrib NULL) { // 处理属性不存在的情况 }HasCustomAttribute的第二个参数指定属性类型TypeTag对应 TAG 属性TypeExpression对应表达式属性。先判断再读可以避免空指针崩溃也方便在日志里输出具体缺了哪个属性。5. 快速定位 CustomFeature 故障我的排查顺序和验证习惯遇到 CustomFeature 不工作我一般按固定顺序走一遍基本能在十分钟内定位到根因。第一步永远是看 XML 和 DLL 的部署确认CustomFeatureConfiguration.xml在application目录下两个 DLL 文件名和 XML 里的FeatureLibrary、FeatureUILibrary完全一致。这一步能过滤掉一半以上的“特征不显示”问题。第二步在 Core 构造函数里加GetClassFromName的输出确认类是否注册成功。如果返回空问题一定在 XML 或 DLL 路径上不用往下查。第三步检查五个回调是否全部注册。漏注册createGeometryCallBack会导致特征创建后没有几何漏注册modifyGeometryCallBack会导致编辑时几何不更新。我习惯在构造函数里加一行 listing window 输出把每个Add*Handler的调用结果打出来虽然啰嗦但能省掉大量猜测时间。第四步看IsWithoutBody和实际输出是否匹配只出曲线就设true出实体就设false。这个属性设错的表现非常典型双击编辑必报“不能创建体”。第五步查 TrackingData。实体不显示、面选不中、后续特征引用失败几乎都和 TrackingData 有关。我会在createGeometryCallBack里把trackingObjectVector的大小输出到 listing window确认每个输出实体和面都加进去了。如果用了 NX 函数创建辅助几何再检查preUpdateCallBack里有没有调CreateConstructionFeatureData和SetShowInGraphicView。下面这张表是我实际排查时用的对照表按报错现象直接跳到对应检查点报错现象优先检查常见根因特征列表里没有自定义特征XML 文件名、DLL 路径、FeatureClass 拼写XML 未加载或类名不匹配双击编辑报“不能创建体”IsWithoutBody 值只出曲线却设为 false创建后模型树无几何createGeometryCallBack 注册、TrackingData回调未注册或未 AppendOutputTrackingData面选不中或引用失败面级别 TrackingData未遍历面创建 TrackingData二次编辑属性读不到属性名一致性、HasCustomAttribute创建和读取属性名不一致辅助体一直显示SetBodies 调用未指定不显示的体最后一步是看 listing window 的输出顺序。正常创建流程应该依次出现preUpdateCallBack、createGeometryCallBack、postUpdateCallBack。如果某个回调没打印说明注册或调用链断了。二次编辑时还会多出modifyGeometryCallBack。这个顺序本身就是最好的诊断线索。从那以后我每次新建 CustomFeature 项目都会先把 XML 模板和五个回调的空实现搭好编译部署后确认 listing window 里五个回调都能按顺序打印再往里填业务逻辑。这个习惯帮我省掉了大量“代码写完了才发现注册没生效”的返工。希望帮到你。本文还有配套的精品资源点击获取 简介这份资源面向从事NX二次开发、需要实现用户自定义特征的C开发者围绕CustomFeature的测试记录与问题处理展开。内容涵盖核心库与UI库的分工、CustomFeatureConfiguration.xml的配置要点以及FeatureClass、FeatureName、FeatureIcon、FeatureLibrary、FeatureUILibrary、IsWithoutBody等属性的含义与常见坑点并整理了创建、修改、更新前回调等关键方法的实现思路与头文件引用方式。资源包共1个docx文件约18KB以文档形式集中记录测试过程与排错经验便于对照查阅。目前已有348人学习下载。读者可借此理清自定义特征从XML注册到DLL部署的完整链路掌握对话框区分创建与编辑模式、属性读取与默认值初始化等细节并参考其中的异常处理与日志记录思路减少因配置不当或实体标志设置错误导致的报错适合具备一定NXOpen基础的开发者进阶参考。1. 自定义特征加载失败从两个 DLL 和一个 XML 说起如果你正在做 NX 二次开发并且尝试用 C 实现 CustomFeature大概率会遇到这样一个场景代码编译通过DLL 也生成了但打开 NX 后自定义特征就是不出现或者出现了却报“不能创建体”的异常。这不是玄学而是 CustomFeature 的加载机制在作祟。它不像普通 NXOpen 程序那样把 DLL 放对位置就能跑而是需要两个 DLL 加一个 XML 配置文件三者严格配合。很多开发者第一次踩坑就卡在这里明明按文档拷了文件特征列表里却空空如也。这篇文章适合正在被 CustomFeature 加载、注册、回调、编辑异常卡住的开发者我会把踩过的坑和排查路径一条条拆开让你能照着命令和配置直接定位问题。2. 特征不显示或加载报错XML 配置与 DLL 部署的排查2.1 两个 DLL 和一个 XML 到底该放哪CustomFeature 的部署结构比普通 NXOpen 项目多一层约束。你需要把编译生成的Core DLL实现特征创建逻辑和UI DLL处理对话框交互连同CustomFeatureConfiguration.xml一起放到 NX 的application文件夹下。常见做法是放在%UGII_USER_DIR%\application或%UGII_CUSTOM_DIRECTORY_FILE%指向的目录里。如果只放了 DLL 没放 XMLNX 启动时不会报错但特征类根本不会注册你在历史树里也找不到任何痕迹。我一般会先确认三件事XML 文件名是否严格为CustomFeatureConfiguration.xml大小写敏感两个 DLL 是否和 XML 在同一目录以及 XML 里的FeatureLibrary和FeatureUILibrary是否和实际 DLL 文件名一致不带.dll后缀。很多“特征不显示”的问题根源就是 XML 里写的是BlockAndCylinderCore而实际生成的 DLL 叫BlockAndCylinderCore.dll名字对不上NX 直接静默跳过。2.2 XML 里每个属性写错会报什么XML 的格式看着简单但每个属性都直接对应代码里的类名或资源名写错一个就可能导致加载失败或运行时异常。下面是一段可对照的配置示例?xml version1.0 encodingutf-8? CustomFeatureLib xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:noNamespaceSchemaLocationCustomFeatureConfiguration_schema.xsd CustomFeature FeatureClassNXOpen::CustomFeature::BlockAndCylinder FeatureNameBlock And Cylinder FeatureIconblock_and_cylinder FeatureLibraryBlockAndCylinderCore FeatureUILibraryBlockAndCylinderUI IsWithoutBodyfalse/ CustomFeature FeatureClassNXOpen::CustomFeature::SamplePolygonalHole FeatureNamePolygonal Hole FeatureIconpolygonal_hole FeatureLibraryPolygonalHoleCore FeatureUILibraryPolygonalHoleUI IsWithoutBodytrue/ /CustomFeatureLibFeatureClass必须和 C 代码里注册的类名完全一致包括命名空间。FeatureName是显示在 UG 历史模型记录里的名字写错了用户看到的特征名就不对。FeatureIcon对应图标资源名没有图标不会导致加载失败但历史树里会显示默认图标。FeatureLibrary和FeatureUILibrary分别指向 Core 和 UI 的 DLL 文件名不带扩展名。IsWithoutBody是最容易翻车的一个如果特征只创建曲线、不创建实体必须设为true否则双击编辑时会直接抛异常提示“不能创建体”或“没有目标体”。2.3 用 listing window 确认注册是否成功当你不确定特征类有没有被 NX 识别到最直接的验证方式是在 Core DLL 的入口函数里加一段输出。常见做法是在构造函数中获取CustomFeatureClassManager然后调用GetClassFromName看返回值是否为空// Core DLL 入口处验证类是否注册成功 NXOpen::Features::CustomFeatureClassManager *mgr theSession-CustomFeatureClassManager(); NXOpen::Features::CustomFeatureClass *cfClass mgr-GetClassFromName(NXOpen::CustomFeature::SamplePolygonalHole); if (cfClass NULL) { UF_UI_open_listing_window(); UF_UI_write_listing_window(CustomFeature class NOT found!\n); } else { UF_UI_open_listing_window(); UF_UI_write_listing_window(CustomFeature class registered OK\n); }这段代码的逻辑是从当前 session 拿到特征类管理器再按 XML 里写的FeatureClass全名去查。如果返回空指针说明 XML 没被加载、DLL 没放对位置或者类名拼写有误。参数NXOpen::CustomFeature::SamplePolygonalHole必须和 XML 里的FeatureClass一字不差。输出到 listing window 是为了在不打断 NX 启动的前提下快速确认注册状态比弹窗更省事。3. 双击编辑报“不能创建体”IsWithoutBody 与回调注册的坑3.1 IsWithoutBody 设错导致的异常这个报错我见过太多次特征创建成功历史树里也能看到但双击想编辑时直接弹窗“不能创建体或者没有目标体”。根因几乎都落在IsWithoutBody上。如果你的特征只生成曲线、点或基准面不生成实体那么 XML 里必须写IsWithoutBodytrue。写成false时NX 会认为这个特征应该输出实体编辑时找不到目标体就抛异常。判断标准很简单打开 Core 代码里的createGeometryCallBack看它最终往trackingObjectVector里塞的是 Parasolid 实体还是 NX 对象曲线、点。如果只有曲线就老老实实把IsWithoutBody改成true。改完 XML 后不需要重新编译 DLL但需要重启 NX 让配置重新加载。3.2 五个回调没注册全的后果CustomFeature 的核心逻辑分布在五个回调里preUpdateCallBack、createGeometryCallBack、modifyGeometryCallBack、postUpdateCallBack、informationCallBack。这些回调必须在 Core 类的构造函数里通过AddPreUpdateHandler、AddCreateFeatureGeometryHandler等方法注册到CustomFeatureClass上。漏注册任何一个对应的阶段就不会执行你的代码。// 在 Core 类构造函数中注册五个回调 NXOpen::Features::CustomFeatureClassManager *mgr theSession-CustomFeatureClassManager(); NXOpen::Features::CustomFeatureClass *cfClass mgr-GetClassFromName(NXOpen::CustomFeature::SamplePolygonalHole); cfClass-AddPreUpdateHandler(make_callback(PolygonalHoleCore::preUpdateCallBack)); cfClass-AddCreateFeatureGeometryHandler(make_callback(PolygonalHoleCore::createGeometryCallBack)); cfClass-AddModifyFeatureGeometryHandler(make_callback(PolygonalHoleCore::modifyGeometryCallBack)); cfClass-AddPostUpdateHandler(make_callback(PolygonalHoleCore::postUpdateCallBack)); cfClass-AddInformationHandler(make_callback(PolygonalHoleCore::informationCallBack));make_callback把静态成员函数包装成 NXOpen 需要的回调对象。参数就是你在类里声明的五个静态函数地址。如果GetClassFromName返回空后面的注册全部无效所以务必先确认类名正确。注册顺序不影响执行但建议按生命周期顺序写方便排查时对照日志。3.3 编辑时读不到属性值FeatureData 的读取时机二次编辑时UI 需要从已有的CustomFeatureData里把属性值读出来回填到对话框控件上。这个逻辑要写在对话框的初始化阶段而不是 APPLY 里。典型写法是先判断GetEditedCustomFeature()是否为空// 在对话框初始化中区分首次创建和二次编辑 NXOpen::Features::CustomFeature* editedFeature mgr-GetEditedCustomFeature(); if (editedFeature NULL) { UF_UI_open_listing_window(); UF_UI_write_listing_window(初始化中第一次创建\n); } else { NXOpen::Features::CustomFeature *cfFeature (NXOpen::Features::CustomFeature *)editedFeature; NXOpen::Features::CustomFeatureData* cfData cfFeature-FeatureData(); PopulateUIFromCustomFeatureData(cfData); UF_UI_open_listing_window(); UF_UI_write_listing_window(初始化中二次编辑\n); }GetEditedCustomFeature()返回非空说明用户是双击已有特征进入编辑此时要从FeatureData()里按属性名逐个读取。表达式属性用CustomExpressionAttributeByNameTAG 属性用CustomTagAttributeByName读出来后再dynamic_cast成具体类型Expression*、Direction*、Point*、Body*。如果读不到先检查属性名是否和创建时CreateCustomExpressionAttribute传入的字符串一致大小写敏感。4. 创建成功但模型树异常TrackingData 与 ConstructionFeature 的避坑记录4.1 避坑一实体没做布尔运算却不显示现象Core 回调里用 PK 函数创建了实体createGeometryCallBack也返回了 0但模型树里看不到这个体图形窗口也是空的。原因CustomFeature 不会自动把 PK 创建的实体纳入显示管理。如果你没有在回调里把实体注册到TrackingDataNX 就不知道这个体属于当前特征自然不会显示。解决在createGeometryCallBack里为每个输出实体创建TrackingData并调用AppendOutputTrackingData// 为 PK 创建的实体注册 TrackingData std::vectorNXOpen::Features::TrackingData* trackingObjectVector; NXOpen::Features::TrackingData *trackObject1 event-CreateTrackingDataForParasolidEntity( (NXOpen::Features::CustomFeatureEvent::ParasolidId)output1); std::vectorNXOpen::NXObject * objVector1; objVector1.push_back(dynamic_castNXOpen::NXObject *(body)); trackObject1-AddTagSourceEntities(objVector1); trackingObjectVector.push_back(trackObject1); event-AppendOutputTrackingData(trackingObjectVector);CreateTrackingDataForParasolidEntity的参数是 PK 实体的 ParasolidIdAddTagSourceEntities把 NX 对象和这个追踪数据关联起来。最后必须调用AppendOutputTrackingData否则前面创建的 TrackingData 不会生效。4.2 避坑二面没有加入 TrackingData 导致选不中现象实体显示出来了但用选择过滤器选面时选不到或者后续特征引用这个面时报“找不到面”。原因只注册了体级别的 TrackingData没有把体的各个面也加进去。NX 的拓扑引用需要面级别的追踪数据。解决遍历实体的所有面为每个面创建 TrackingData 并设置整数键// 将实体的每个面也加入 TrackingData for (int i 0; i numFaces; i) { NXOpen::Features::TrackingData *trackObject event-CreateTrackingDataForParasolidEntity( (NXOpen::Features::CustomFeatureEvent::ParasolidId)faces[i]); trackObject-AddIntSourceEntity(i 1); trackingObjectVector.push_back(trackObject); }AddIntSourceEntity(i 1)给每个面一个唯一整数标识后续通过这个标识可以反查面。numFaces和faces数组需要你从 PK 实体上提前查出来。4.3 避坑三NX 函数创建的对象在 preUpdate 里没设 ConstructionFeatureData现象用UF_MODL_create_cyl1等 NX 函数创建了辅助体或基准几何但模型树里不显示或者显示为游离特征而不是当前 CustomFeature 的子节点。原因NX 函数创建的特征默认不属于 CustomFeature需要在preUpdateCallBack里用CreateConstructionFeatureData包装并设置SetShowInGraphicView(true)。解决// 在 preUpdateCallBack 中包装 NX 函数创建的特征 std::vectorNXOpen::Features::ConstructionFeatureData* ConstructionFeatureDataVector; UF_MODL_create_cyl1(..., tCyFeatTag); UF_MODL_ask_feat_body(tCyFeatTag, g_tCylTag); NXOpen::Features::Feature *nxFeat dynamic_castNXOpen::Features::Feature *( NXObjectManager::Get(tCyFeatTag)); NXOpen::Features::ConstructionFeatureData *outputFeatData event-CreateConstructionFeatureData(nxFeat); outputFeatData-SetShowInGraphicView(true); ConstructionFeatureDataVector.push_back(outputFeatData);CreateConstructionFeatureData把普通特征转换成构造特征数据SetShowInGraphicView(true)控制是否在图形窗口显示。如果不需要显示设为false即可。这些数据要在preUpdateCallBack里准备好因为几何创建阶段会用到。4.4 避坑四不参与显示的体没有调用 SetBodies现象某些中间体或辅助体在创建后一直显示在图形窗口即使用户不需要看到它们。原因没有明确告诉 NX 哪些体不参与最终显示。CustomFeature 默认会把所有 PK 实体都当作输出。解决在回调里用SetBodies明确指定不显示的体// 设置不参与显示的体 std::vectorNXOpen::Features::CustomFeatureEvent::ParasolidId bodiesVector; bodiesVector.push_back((NXOpen::Features::CustomFeatureEvent::ParasolidId)output1); event-SetBodies(bodiesVector);SetBodies接收一个 ParasolidId 向量列表里的体不会出现在最终结果中。注意这个调用要在AppendOutputTrackingData之前或之后根据实际需求调整通常放在几何创建完成后。4.5 避坑五属性名拼写不一致导致读取为空现象二次编辑时CustomExpressionAttributeByName(m_polygonSides)返回空指针后续SetValue直接崩溃。原因创建属性时用的名字和读取时用的名字不一致比如创建时写m_polygonSides读取时写成m_polygonSidesAttrib。解决把属性名统一用常量管理创建和读取都引用同一个常量。如果已经出现不一致用HasCustomAttribute先判断再读// 安全读取属性先判断是否存在 NXOpen::Features::CustomTagAttribute *sectionAttrib cfData-HasCustomAttribute(section, NXOpen::Features::CustomAttribute::TypeTag) ? dynamic_castNXOpen::Features::CustomTagAttribute*(cfData-CustomTagAttributeByName(section)) : NULL; if (sectionAttrib NULL) { // 处理属性不存在的情况 }HasCustomAttribute的第二个参数指定属性类型TypeTag对应 TAG 属性TypeExpression对应表达式属性。先判断再读可以避免空指针崩溃也方便在日志里输出具体缺了哪个属性。5. 快速定位 CustomFeature 故障我的排查顺序和验证习惯遇到 CustomFeature 不工作我一般按固定顺序走一遍基本能在十分钟内定位到根因。第一步永远是看 XML 和 DLL 的部署确认CustomFeatureConfiguration.xml在application目录下两个 DLL 文件名和 XML 里的FeatureLibrary、FeatureUILibrary完全一致。这一步能过滤掉一半以上的“特征不显示”问题。第二步在 Core 构造函数里加GetClassFromName的输出确认类是否注册成功。如果返回空问题一定在 XML 或 DLL 路径上不用往下查。第三步检查五个回调是否全部注册。漏注册createGeometryCallBack会导致特征创建后没有几何漏注册modifyGeometryCallBack会导致编辑时几何不更新。我习惯在构造函数里加一行 listing window 输出把每个Add*Handler的调用结果打出来虽然啰嗦但能省掉大量猜测时间。第四步看IsWithoutBody和实际输出是否匹配只出曲线就设true出实体就设false。这个属性设错的表现非常典型双击编辑必报“不能创建体”。第五步查 TrackingData。实体不显示、面选不中、后续特征引用失败几乎都和 TrackingData 有关。我会在createGeometryCallBack里把trackingObjectVector的大小输出到 listing window确认每个输出实体和面都加进去了。如果用了 NX 函数创建辅助几何再检查preUpdateCallBack里有没有调CreateConstructionFeatureData和SetShowInGraphicView。下面这张表是我实际排查时用的对照表按报错现象直接跳到对应检查点报错现象优先检查常见根因特征列表里没有自定义特征XML 文件名、DLL 路径、FeatureClass 拼写XML 未加载或类名不匹配双击编辑报“不能创建体”IsWithoutBody 值只出曲线却设为 false创建后模型树无几何createGeometryCallBack 注册、TrackingData回调未注册或未 AppendOutputTrackingData面选不中或引用失败面级别 TrackingData未遍历面创建 TrackingData二次编辑属性读不到属性名一致性、HasCustomAttribute创建和读取属性名不一致辅助体一直显示SetBodies 调用未指定不显示的体最后一步是看 listing window 的输出顺序。正常创建流程应该依次出现preUpdateCallBack、createGeometryCallBack、postUpdateCallBack。如果某个回调没打印说明注册或调用链断了。二次编辑时还会多出modifyGeometryCallBack。这个顺序本身就是最好的诊断线索。从那以后我每次新建 CustomFeature 项目都会先把 XML 模板和五个回调的空实现搭好编译部署后确认 listing window 里五个回调都能按顺序打印再往里填业务逻辑。这个习惯帮我省掉了大量“代码写完了才发现注册没生效”的返工。希望帮到你。本文还有配套的精品资源点击获取