AutoCAD C# 二次开发：玩转径向标注（RadialDimension）与防翻转实战

AutoCAD C# 二次开发：玩转径向标注（RadialDimension）与防翻转实战

在 AutoCAD 二次开发中，径向标注（RadialDimension）是机械、建筑等图纸中经常需要处理的实体。很多初学者在尝试用代码修改径向标注的文字位置时，经常会遇到标注“莫名其妙折了过去”、“引线无限拉长”或者“文字翻转”的诡异现象。

本文将带你彻底理清RadialDimension的底层几何逻辑，分享高频常用属性、核心实战案例，并附带完整的属性速查表，帮你完美避坑！

一、 核心概念与常用属性

要搞懂径向标注，首先要明白 CAD 是如何定义它的。径向标注的核心是由圆心、圆弧上的标注点以及文字位置三者决定。

1. 关键几何属性

2. 控制与外观属性

• LeaderLength(double)：引线长度。
• Dimtmove(int)：文字移动规则（非常关键）。
• 0：文字随尺寸线移动。
• 1：移动文字时，自动添加一条额外的引线（脱离原尺寸线）。
• 2：移动文字时，不添加引线（文字孤立悬空）。

二、 经典实战：解决文字下移“折断翻转”的硬核案例

1. 痛点起因

在业务中，我们经常需要调整标注文字的位置（比如向下平移 60 个单位）以防文字重叠。
如果直接用dim.TextPosition = new Point3d(oldX, oldY - 60, oldZ);，你会发现整个标注的引线彻底变形或反向折叠。

底层原因：CAD 的水平折线是靠TextPosition.Y去跟Center到ChordPoint的延长线求交点来计算的。你只改 Y 不改 X，交点就会发生横向暴走，导致引线计算出负值而翻转。

2. 解决方案：扩展方法封装

利用相似三角形定理，当 Y 轴发生偏移时，X 轴必须根据径向线的斜率同步进行补偿偏移，让新点依然保持在原有的径向射线方向上。

下面是将该算法封装为RadialDimension的扩展方法（Extension Method），您可以直接复制到项目中使用：

usingAutodesk.AutoCAD.DatabaseServices;usingAutodesk.AutoCAD.Geometry;usingSystem;namespaceAutoCAD_CAD_Development{publicstaticclassRadialDimensionExtensions{/// <summary>/// 智能平移径向标注的末尾引线和文字，完美保持标注原有几何形态/// </summary>/// <param name="dim">已以 ForWrite 模式打开的径向标注对象</param>/// <param name="yOffset">Y轴垂直偏移量（负数向下，正数向上）</param>publicstaticvoidMoveTailVertically(thisRadialDimensiondim,doubleyOffset){if(dim==null)thrownewArgumentNullException(nameof(dim),"标注对象不能为空。");// 1. 获取当前基础几何点Point3doldTextPos=dim.TextPosition;Point3dcenter=dim.Center;Point3dchordPoint=dim.ChordPoint;// 2. 计算径向线的方向向量 (dx, dy)doubledx=chordPoint.X-center.X;doubledy=chordPoint.Y-center.Y;Point3dnewTextPos;// 3. 规避分母为 0 的情况（即原始标注线接近绝对水平）if(Math.Abs(dy)>1e-6){// 相似三角形原理：xOffset / yOffset = dx / dydoublexOffset=yOffset*(dx/dy);newTextPos=newPoint3d(oldTextPos.X+xOffset,oldTextPos.Y+yOffset,oldTextPos.Z);}else{// 如果是绝对水平的标注，单纯改变Y会导致CAD无法求交点// 此时切换为“移动文字并自动生成独立引线”模式 (Dimtmove = 1)dim.Dimtmove=1;newTextPos=newPoint3d(oldTextPos.X,oldTextPos.Y+yOffset,oldTextPos.Z);}// 4. 应用计算后的新坐标dim.TextPosition=newTextPos;}}}

3. 主命令调用示例

在主命令中，直接用dim.MoveTailVertically(-60);即可优雅实现下移：

[CommandMethod("SmartMoveRadialDim")]publicvoidSmartMoveRadialDim(){Documentdoc=Application.DocumentManager.MdiActiveDocument;Databasedb=doc.Database;Editored=doc.Editor;PromptEntityOptionspeo=newPromptEntityOptions("\n请选择一个径向标注: ");peo.SetRejectMessage("\n选择实体类型错误，请选择径向标注!");peo.AddAllowedClass(typeof(RadialDimension),true);PromptEntityResultper=ed.GetEntity(peo);if(per.Status!=PromptStatus.OK)return;using(Transactiontr=db.TransactionManager.StartTransaction()){try{vardim=tr.GetObject(per.ObjectId,OpenMode.ForWrite)asRadialDimension;if(dim!=null){// 直接调用封装好的扩展方法，整体下移 60dim.MoveTailVertically(-60.0);tr.Commit();ed.WriteMessage("\n✓ 标注引线及文字已成功平滑下移。");}}catch(System.Exceptionex){tr.Abort();ed.WriteMessage($"\n操作失败:{ex.Message}");}}}

三、 RadialDimension 常用属性速查表

为了方便大家日常开发时查阅，这里整理了RadialDimension最常用的属性与说明表：

开发小贴士：
任何时候修改RadialDimension的属性（例如TextPosition或Dimtmove），都要确保在事务（Transaction）中使用OpenMode.ForWrite打开该实体，否则会触发eNotOpenForWrite异常！

项目地址：

AutoCAD.EntityTools