CAD二次开发 - LineAngularDimension2 全部属性及注解

LineAngularDimension2 全部属性及注解一、类继承层次LineAngularDimension2的继承链如下DBObject └── Entity └── Dimension └── LineAngularDimension2该类的属性来自四个层级自身特有属性、Dimension基类属性、Entity基类属性和DBObject基类属性。其中大部分常用属性如 Dimtad、Dimtix、Dimasz 等继承自Dimension基类。二、LineAngularDimension2 自身特有属性属性类型读写中文注解ArcPointPoint3d读/写标注弧线定义点WCS坐标系用于确定角度标注弧线的位置。该点位置决定标注是绘制在夹角内侧还是外侧当该点位于两直线夹角的外部区域时箭头从外指向内侧XLine1StartPoint3d读/写第一条尺寸界线的起点第一条直线的起点XLine1EndPoint3d读/写第一条尺寸界线的终点第一条直线上不同于起点的另一点XLine2StartPoint3d读/写第二条尺寸界线的起点第二条直线的起点XLine2EndPoint3d读/写第二条尺寸界线的终点第二条直线上不同于起点的另一点说明在 AutoCAD .NET API 中XLine1Start和XLine2Start通常都指向两直线的交点角度顶点。三、构造参数创建时设置参数类型中文注解line1StartPoint3d第一条直线的起点通常为角度顶点/交点line1EndPoint3d第一条直线的终点第一条尺寸界线的参考点line2StartPoint3d第二条直线的起点通常为角度顶点/交点line2EndPoint3d第二条直线的终点第二条尺寸界线的参考点arcPointPoint3d标注弧线定义点决定弧线位置及箭头指向方向dimensionTextstring标注文本传入空字符串表示自动计算角度值dimensionStyleObjectId标注样式的 ObjectId传入db.Dimstyle使用当前样式构造函数签名publicLineAngularDimension2(Point3dline1Start,Point3dline1End,Point3dline2Start,Point3dline2End,Point3darcPoint,stringdimensionText,ObjectIddimensionStyle);四、继承自 Dimension 的常用属性以下属性继承自Dimension基类是二次开发中修改标注外观的核心属性属性类型读写中文注解Dimtadint读/写文字垂直位置0 文字居中在尺寸线上1 文字位于尺寸线上方2 文字位于尺寸线下方Dimtixint读/写强制文字在尺寸界线内侧0 关闭1 开启Dimtohint读/写外侧文字水平放置0 关闭1 开启Dimtihint读/写内侧文字水平放置0 关闭1 开启Dimaszdouble读/写箭头大小控制尺寸线箭头头的尺寸Dimtxtdouble读/写文字高度控制标注文本的大小Dimgapdouble读/写文字与尺寸线间距当文字位于尺寸线中间时可设置间隙Dimscaledouble读/写全局比例因子影响标注各元素的尺寸箭头、文字等Dimaunitint读/写角度标注单位格式0 十进制角度1 度/分/秒2 百分度3 弧度Dimdecint读/写小数位数控制角度标注的精度Dimtmoveint读/写文字移动方式0 尺寸线随文字移动1 添加引线2 不添加引线Dimclrtint读/写文字颜色使用 AutoCAD 颜色索引值Dimclrdint读/写尺寸线和箭头颜色Dimclreint读/写尺寸界线颜色Dimatfitint读/写箭头和文字放置方式当空间不足时0 文字和箭头都放到尺寸界线外1 箭头在外、文字在内2 文字在外、箭头在内3 自动最佳放置Dimpoststring读/写文字后缀/前缀格式为prefixsuffix会被替换为测量值Dimsahint读/写使用不同箭头0 两端相同1 两端可使用不同箭头块DimblkObjectId读/写箭头块ID用于设置自定义箭头样式Dimblk1ObjectId读/写第一个箭头块ID当 Dimsah 1 时Dimblk2ObjectId读/写第二个箭头块ID当 Dimsah 1 时Dimazinint读/写角度标注消零处理0 显示所有前导/后续零1 抑制前导零2 抑制后续零3 同时抑制Dimadecint读/写角度标注小数位数0~8 指定小数位-1 表示使用 Dimdec 设置Dimaltint读/写显示换算单位0 关闭1 开启Dimaltdint读/写换算单位小数位数Dimaltfdouble读/写换算单位比例因子DimensionStyleObjectId读/写标注样式ID可重新关联到另一个标注样式Measurementdouble只读实际测量值角度弧度值该值由几何位置自动计算Textstring读/写标注文本字符串覆盖默认测量值TextRotationdouble读/写文字旋转角度弧度TextPositionPoint3d读/写文字位置WCS坐标系HorizontalRotationdouble读/写尺寸线旋转角度弧度IsTextUserDefinedbool读/写是否使用用户自定义文本五、继承自 Entity 的常用属性属性类型读写中文注解ColorColor读/写实体颜色ColorIndexint读/写颜色索引值0~2560ByBlock256ByLayerLayerstring读/写图层名称LayerIdObjectId读/写图层IDLinetypestring读/写线型名称LinetypeIdObjectId读/写线型IDLineWeightLineWeight读/写线宽枚举值LinetypeScaledouble读/写线型比例TransparencyTransparency读/写透明度Visiblebool读/写可见性EcsCoordinateSystem3d只读实体坐标系ECSGeometricExtentsExtents3d只读几何边界范围BoundsExtents3d只读实体边界框IsErasedbool只读是否已被删除六、继承自 DBObject 的常用属性属性类型读写中文注解ObjectIdObjectId只读对象ID数据库中的唯一标识HandleHandle只读对象句柄持久化标识符OwnerIdObjectId只读所有者对象ID如所在的 BlockTableRecordDatabaseDatabase只读所属数据库IsWriteEnabledbool只读是否可写IsNotifyEnabledbool只读是否启用通知IsTransactionResidentbool只读是否驻留在事务中IsUndoRecordingDisabledbool只读是否禁用撤销记录XDataResultBuffer读/写扩展数据XDATAExtensionDictionaryObjectId只读扩展字典ID七、常用属性使用示例using(Transactiontrdb.TransactionManager.StartTransaction()){// 创建角度标注LineAngularDimension2dimnewLineAngularDimension2(intersection,point1,// 第一条直线intersection,point2,// 第二条直线arcPoint,// 弧线位置位于夹角外侧则箭头向内,// 自动计算角度db.Dimstyle);// 当前标注样式// 设置文字位于尺寸线上方dim.Dimtad1;// 1 文字在尺寸线上方// 设置文字高度dim.Dimtxt3.5;// 设置箭头大小dim.Dimasz2.5;// 设置角度单位0 十进制角度dim.Dimaunit0;// 设置小数位数2位dim.Dimdec2;// 设置颜色为红色dim.ColorIndex1;// 添加到模型空间btr.AppendEntity(dim);tr.AddNewlyCreatedDBObject(dim,true);tr.Commit();}八、参考链接Autodesk 官方文档LineAngularDimension2 ClassDimension 基类属性参考Dimension Class PropertiesBricsCAD API 参考与 AutoCAD 兼容LineAngularDimension2 Class注意上述属性覆盖了LineAngularDimension2及其基类的主要属性。实际开发中可使用 Visual Studio 的智能感知IntelliSense查看完整属性列表或使用typeof(LineAngularDimension2).GetProperties()反射获取所有属性。部分属性如 Dimtad、Dimtix 等继承自 Dimension 基类类型为 int 的布尔属性通常使用 0/1 表示关/开。