2. using Autodesk.AutoCAD.DatabaseServices;
  3. using Autodesk.AutoCAD.EditorInput;
  4. using Autodesk.AutoCAD.Geometry;
  5. using Autodesk.AutoCAD.Runtime;

  7. /// <summary>
  8. /// 带方向的多重引线绘制交互类
  9. /// 继承自EntityJig，用于通过用户交互动态创建带方向的多重引线（MLeader）
  10. /// 支持实时更新引线终点位置，并根据终点与起点的位置关系自动调整文字方向
  11. /// </summary>
  12. public class DirectionalLeaderJig : EntityJig
  13. {
  14.     #region 私有字段

  16.     /// <summary>
  17.     /// 引线的固定起点坐标（用户初始指定的起点）
  18.     /// </summary>
  19.     private readonly Point3d _start;

  21.     /// <summary>
  22.     /// 引线的实时终点坐标（用户鼠标移动/输入的动态终点）
  23.     /// </summary>
  24.     private Point3d _end;

  26.     /// <summary>
  27.     /// 多重引线中引线簇的索引（用于标识当前操作的引线簇）
  28.     /// </summary>
  29.     private int _index;

  31.     /// <summary>
  32.     /// 引线簇中线段的索引（用于标识当前操作的线段）
  33.     /// </summary>
  34.     private int _lineIndex;

  36.     /// <summary>
  37.     /// 绘制状态标记：true表示已开始绘制（引线已初始化），false表示未开始
  38.     /// 用于避免起点与终点过近时误创建引线
  39.     /// </summary>
  40.     private bool _started;

  42.     /// <summary>
  43.     /// 与引线关联的多行文字对象（存储引线的文字内容及格式）
  44.     /// </summary>
  45.     private readonly MText _mtext;

  47.     #endregion

  49.     #region 构造函数

  51.     /// <summary>
  52.     /// 初始化DirectionalLeaderJig实例
  53.     /// </summary>
  54.     /// <param name="start">引线的固定起点坐标</param>
  55.     /// <param name="ld">需要交互绘制的多重引线对象</param>
  56.     /// <param name="mtext">与引线关联的多行文字对象（包含文字内容和格式）</param>
  57.     public DirectionalLeaderJig(Point3d start, MLeader ld, MText mtext) : base(ld)
  58.     {
  59.         _start = start;          // 初始化起点（固定不变）
  60.         _end = start;            // 初始终点设为起点（避免初始位置异常）
  61.         _started = false;        // 初始标记为未开始绘制
  62.         _mtext = mtext;          // 关联多行文字对象
  63.     }

  65.     #endregion

  67.     #region 重写方法

  69.     /// <summary>
  70.     /// 输入采样处理：获取用户实时输入的引线终点坐标
  71.     /// 继承自EntityJig，用于处理用户交互输入
  72.     /// </summary>
  73.     /// <param name="prompts">交互提示对象，用于获取用户输入</param>
  74.     /// <returns>采样状态：NoChange（坐标未变）、OK（输入有效）、Cancel（用户取消）</returns>
  75.     protected override SamplerStatus Sampler(JigPrompts prompts)
  76.     {
  77.         // 创建点输入提示，指导用户操作
  78.         var pointOptions = new JigPromptPointOptions("\n指定引线终点或[右键取消]: ");
  79.         
  80.         // 配置输入规则：允许3D坐标输入，不接受空响应（避免误操作）
  81.         pointOptions.UserInputControls =
  82.             UserInputControls.Accept3dCoordinates |
  83.             UserInputControls.NoNegativeResponseAccepted;

  85.         // 获取用户输入的点
  86.         PromptPointResult inputResult = prompts.AcquirePoint(pointOptions);

  88.         // 若输入的终点与当前终点相同，返回无变化状态（避免无效更新）
  89.         if (_end == inputResult.Value)
  90.         {
  91.             return SamplerStatus.NoChange;
  92.         }
  93.         // 若用户输入有效，更新终点坐标并返回成功状态
  94.         else if (inputResult.Status == PromptStatus.OK)
  95.         {
  96.             _end = inputResult.Value;
  97.             return SamplerStatus.OK;
  98.         }
  99.         // 其他情况（如用户按ESC取消），返回取消状态
  100.         return SamplerStatus.Cancel;
  101.     }

  103.     /// <summary>
  104.     /// 更新引线几何图形：根据实时终点坐标动态调整引线形状和文字方向
  105.     /// 继承自EntityJig，在用户输入变化时触发
  106.     /// </summary>
  107.     /// <returns>是否更新成功（始终返回true，确保交互流畅）</returns>
  108.     protected override bool Update()
  109.     {
  110.         // 将当前操作的实体转换为多重引线对象（构造函数传入的是MLeader，转换安全）
  111.         MLeader leader = (MLeader)Entity;

  113.         // 首次初始化：当起点与终点距离超过容差时，创建引线基础结构
  114.         if (!_started)
  115.         {
  116.             // 检查起点与终点的距离是否超过全局点容差（避免点击过近时误创建）
  117.             if (_start.DistanceTo(_end) > Tolerance.Global.EqualPoint)
  118.             {
  119.                 // 配置引线内容：关联多行文字（而非块或其他类型）
  120.                 leader.ContentType = ContentType.MTextContent;
  121.                 leader.MText = _mtext;  // 绑定预设的多行文字对象

  123.                 // 创建引线簇和线段结构
  124.                 _index = leader.AddLeader();                  // 添加新的引线簇
  125.                 _lineIndex = leader.AddLeaderLine(_index);    // 在簇中添加线段

  127.                 // 设置线段的起点和初始终点
  128.                 leader.AddFirstVertex(_lineIndex, _start);    // 线段起点固定为初始起点
  129.                 leader.AddLastVertex(_lineIndex, _end);       // 线段终点设为当前输入终点

  131.                 _started = true;  // 标记为已开始绘制（后续进入更新逻辑）
  132.             }
  133.         }
  134.         // 后续更新：已创建引线后，实时调整终点位置
  135.         else
  136.         {
  137.             leader.Visible = true;  // 强制显示引线（避免初始化时的闪烁问题）
  138.             leader.SetLastVertex(_lineIndex, _end);  // 更新线段终点为最新输入坐标
  139.         }

  141.         // 调整文字方向：根据终点与起点的X坐标关系设置狗腿线方向
  142.         if (_started)
  143.         {
  144.             // 狗腿线方向向量：终点在起点右侧则向右（X正方向），左侧则向左（X负方向）
  145.             Vector3d doglegVector = new Vector3d(
  146.                 _end.X >= _start.X ? 1 : -1,  // X方向：右侧为正，左侧为负
  147.                 0, 0                          // Y、Z方向不变
  148.             );
  149.             leader.SetDogleg(_index, doglegVector);  // 应用狗腿线方向，确保文字朝向正确
  150.         }

  152.         return true;  // 确认更新成功
  153.     }

  155.     #endregion
  156. }
  2. using Autodesk.AutoCAD.ApplicationServices;
  3. using Autodesk.AutoCAD.DatabaseServices;
  4. using Autodesk.AutoCAD.EditorInput;
  5. using Autodesk.AutoCAD.Runtime;

  7. /// <summary>
  8. /// 方向性多重引线命令类
  9. /// 包含创建带方向的多重引线（MLeader）的核心命令逻辑
  10. /// 支持用户输入文字内容、指定起点，并通过动态拖动（Jig）实时调整引线终点
  11. /// </summary>
  12. public class DirectionalLeaderCommands
  13. {
  14.     /// <summary>
  15.     /// 创建方向性引线的命令入口（命令名：DL）
  16.     /// 执行流程：获取文字内容 → 获取起点 → 创建引线相关对象 → 启动动态拖动 → 提交数据库操作
  17.     /// </summary>
  18.     [CommandMethod("DL")]
  19.     public void DirectionalLeader()
  20.     {
  21.         // 获取当前活动文档及编辑器（用于用户交互）和数据库（用于对象存储）
  22.         Document doc = Application.DocumentManager.MdiActiveDocument;
  23.         Editor editor = doc.Editor;
  24.         Database db = doc.Database;

  26.         #region 步骤1：获取用户输入的文字内容
  27.         // 创建文字输入选项，允许包含空格（支持多单词内容）
  28.         PromptStringOptions textInputOptions = new PromptStringOptions("\n输入文字内容: ");
  29.         textInputOptions.AllowSpaces = true;

  31.         // 执行文字输入并检查结果
  32.         PromptResult textInputResult = editor.GetString(textInputOptions);
  33.         if (textInputResult.Status != PromptStatus.OK)
  34.         {
  35.             // 用户取消输入或输入失败，直接退出命令
  36.             editor.WriteMessage("\n文字内容输入取消或失败。");
  37.             return;
  38.         }
  39.         #endregion

  41.         #region 步骤2：获取用户指定的引线起点
  42.         // 提示用户指定引线起点
  43.         PromptPointResult startPointResult = editor.GetPoint("\n指定引线起点: ");
  44.         if (startPointResult.Status != PromptStatus.OK)
  45.         {
  46.             // 用户取消选择或选择失败，退出命令
  47.             editor.WriteMessage("\n引线起点选择取消或失败。");
  48.             return;
  49.         }
  50.         Point3d leaderStartPoint = startPointResult.Value; // 保存起点坐标
  51.         #endregion

  53.         #region 步骤3：数据库事务处理（创建并存储引线对象）
  54.         // 使用using语句自动管理事务生命周期（确保异常时自动回滚）
  55.         using (Transaction transaction = db.TransactionManager.StartTransaction())
  56.         {
  57.             try
  58.             {
  59.                 // 打开块表（只读，用于获取当前空间）
  60.                 BlockTable blockTable = (BlockTable)transaction.GetObject(
  61.                     db.BlockTableId,
  62.                     OpenMode.ForRead,
  63.                     false
  64.                 );

  66.                 // 打开当前空间块表记录（可写，用于添加新对象）
  67.                 BlockTableRecord currentSpace = (BlockTableRecord)transaction.GetObject(
  68.                     db.CurrentSpaceId,
  69.                     OpenMode.ForWrite,
  70.                     false
  71.                 );

  73.                 // 确保文字样式已创建并设置（调用外部文字处理逻辑）
  74.                 文字相关.CreateAndSetTextStyle();

  76.                 #region 创建多重引线样式及相关对象
  77.                 // 创建自定义多重引线样式（样式名：XPF_MLeader），返回样式ID
  78.                 ObjectId mLeaderStyleId = 多重引线相关.CreateMleaderStyle("XPF_MLeader");
  79.                 // 打开样式对象（只读，用于配置多行文字）
  80.                 MLeaderStyle mLeaderStyle = (MLeaderStyle)transaction.GetObject(
  81.                     mLeaderStyleId,
  82.                     OpenMode.ForRead
  83.                 );

  85.                 // 创建多重引线对象（初始不可见，避免拖动前闪烁）
  86.                 MLeader multiLeader = new MLeader();
  87.                 multiLeader.MLeaderStyle = mLeaderStyleId; // 应用自定义样式
  88.                 multiLeader.Visible = false; // 初始隐藏，拖动时再显示

  90.                 // 创建多行文字对象（MText）：绑定样式、设置内容（带宽度因子0.8）和高度0.75
  91.                 MText leaderText = CreateMtext(
  92.                     mLeaderStyle,
  93.                     $"{{\\W0.8x{textInputResult.StringResult}}}", // 文字内容带宽度因子格式
  94.                     0.75 // 文字高度
  95.                 );
  96.                 #endregion

  98.                 #region 启动动态拖动（Jig）交互
  99.                 // 初始化Jig对象：传入起点、多重引线、多行文字
  100.                 DirectionalLeaderJig leaderJig = new DirectionalLeaderJig(
  101.                     leaderStartPoint,
  102.                     multiLeader,
  103.                     leaderText
  104.                 );

  106.                 // 将多重引线添加到当前空间并注册到事务（确保数据库跟踪）
  107.                 currentSpace.AppendEntity(multiLeader);
  108.                 transaction.AddNewlyCreatedDBObject(multiLeader, true);

  110.                 // 启动动态拖动：用户通过鼠标移动实时调整引线终点
  111.                 PromptResult dragResult = editor.Drag(leaderJig);
  112.                 #endregion

  114.                 #region 提交或回滚事务
  115.                 if (dragResult.Status == PromptStatus.OK)
  116.                 {
  117.                     // 拖动成功，提交事务（永久保存所有对象到数据库）
  118.                     transaction.Commit();
  119.                     editor.WriteMessage("\n方向性引线创建成功。");
  120.                 }
  121.                 else
  122.                 {
  123.                     // 拖动取消或失败，事务自动回滚（不保存任何对象）
  124.                     editor.WriteMessage("\n引线创建已取消。");
  125.                 }
  126.                 #endregion
  127.             }
  128.             catch (System.Exception ex)
  129.             {
  130.                 // 捕获异常并提示错误信息
  131.                 editor.WriteMessage($"\n命令执行出错：{ex.Message}");
  132.                 // 异常时事务自动回滚，无需手动处理
  133.             }
  134.         }
  135.         #endregion
  136.     }

  138.     /// <summary>
  139.     /// 创建并配置与多重引线关联的多行文字对象（MText）
  140.     /// </summary>
  141.     /// <param name="style">关联的多重引线样式（用于继承基础格式）</param>
  142.     /// <param name="content">文字内容（支持格式化代码，如宽度因子）</param>
  143.     /// <param name="height">文字高度</param>
  144.     /// <returns>配置完成的MText对象</returns>
  145.     private MText CreateMtext(MLeaderStyle style, string content, double height)
  146.     {
  147.         MText mtext = new MText();
  148.         mtext.Contents = content; // 设置文字内容（含格式）
  149.         mtext.Height = height;    // 设置文字高度
  150.         // 可根据需要添加更多格式配置（如颜色、字体等，可从style继承）
  151.         return mtext;
  152.     }
  153. }


  • 上一篇：开发图库功能
  • 下一篇：没有了
    CAD技术交流中心 | 建筑CAD | 给排水CAD | 暖通CAD | 电气CAD | 电力CAD | 机械CAD | CAD母线槽 | CAD看图
    Copyright © 2019 - 2025