CATIA中如何获取孔的螺纹描述并添加精准标注？

关键问题修复点 #

• 螺纹描述获取异常：HoleThreadDescription仅在孔定义螺纹时有效，未定义时会返回null，直接强转StrParam会引发空引用错误；需先判断有效性，再通过Value属性（而非get_Value()）获取字符串。
• 标注固定在原点：原代码硬编码(0,0,0)作为标注位置，需通过孔的几何属性计算中心点坐标，以此为基准偏移生成标注位置。
• 无效类型转换：从孔Shape创建的Reference无法直接转为UserSurface，应直接使用孔的实体参考创建标注。

修正后的代码 #

private void button1_Click(object sender, EventArgs e)
{
    try
    {
        // 连接已运行的CATIA实例（避免重复启动进程）
        Type catiaType = Type.GetTypeFromProgID("CATIA.Application");
        if (catiaType == null)
        {
            MessageBox.Show("未找到CATIA应用程序。");
            return;
        }

        INFITF.Application catiaApp = (INFITF.Application)Marshal.GetActiveObject("CATIA.Application");
        if (catiaApp == null)
        {
            MessageBox.Show("无法连接到CATIA应用程序。");
            return;
        }

        // 获取当前打开的零件文档
        Documents documents = catiaApp.Documents;
        if (documents.Count == 0)
        {
            MessageBox.Show("未找到打开的文档。");
            return;
        }

        PartDocument partDoc = (PartDocument)documents.Item(1);
        Part part = partDoc.Part;

        // 获取或创建ISO_3D标注集
        AnnotationSets annotationSets = (AnnotationSets)part.AnnotationSets;
        AnnotationSet annotationSet;
        try
        {
            annotationSet = annotationSets.Item("ISO_3D");
        }
        catch
        {
            annotationSet = annotationSets.Add("ISO_3D");
        }
        AnnotationFactory annotationFactory = annotationSet.AnnotationFactory;

        Bodies bodies = part.Bodies;
        Body body = bodies.Item("PartBody");
        Shapes shapes = body.Shapes;

        foreach (Shape shape in shapes)
        {
            if (shape is Hole hole)
            {
                // 获取螺纹描述，无螺纹时用直径生成默认标识
                string threadDesc = string.Empty;
                if (hole.HoleThreadDescription != null)
                {
                    KnowledgewareTypeLib.StrParam strParam = (KnowledgewareTypeLib.StrParam)hole.HoleThreadDescription;
                    threadDesc = strParam.Value;
                }
                if (string.IsNullOrEmpty(threadDesc))
                {
                    threadDesc = $"M{hole.Diameter.Value:F0}";
                }

                // 获取孔的中心点坐标
                Reference holeRef = part.CreateReferenceFromObject(hole);
                HybridShapePointCoord centerPoint = (HybridShapePointCoord)part.HybridShapeFactory.AddNewPointCoord(0, 0, 0);
                part.HybridShapeFactory.GetPointOnCurve(holeRef, 0.5, centerPoint);
                part.UpdateObject(centerPoint);
                double[] coords = centerPoint.Coordinates;

                // 偏移标注位置（避免与孔重合，可根据零件尺寸调整偏移量）
                double offset = 10;
                double annotX = coords[0] + offset;
                double annotY = coords[1] + offset;
                double annotZ = coords[2];

                // 创建附着于孔的标注并设置文本
                Annotation annotation = annotationFactory.CreateEvoluateText(holeRef, annotX, annotY, annotZ, true);
                annotation.Text = threadDesc;
                part.Update();
            }
        }

        MessageBox.Show("螺纹标注已添加完成！");
    }
    catch (Exception ex)
    {
        MessageBox.Show($"执行错误：{ex.Message}");
    }
}

额外说明 #

• 复用已有标注集：先尝试获取已存在的ISO_3D标注集，避免重复创建冗余集合。
• 降级处理无螺纹孔：对于未定义螺纹的孔，自动用直径生成MXX格式的标识，保证所有孔都有标注。
• 标注位置可调：offset变量可根据零件实际尺寸调整，确保标注既靠近孔位又不遮挡几何特征。

内容的提问来源于stack exchange，提问作者Yunus Mert AŞKIN