1、简介

MicroStation（以下简称Mstn）中超过一半的功能都是以交互式工具的形式而存在的，可见在Mstn的二次开发中交互式工具的开发是多么的重要。以前的SDK中，我们使用mdlState_XXX系列函数通过设置对应的事件处理回调函数来实现交互式工具。当我们的鼠标或键盘在视图中产生交互操作时，不同的动作会调用不同的回调函数。这种方式是“面向过程”编程思想的产物，在“面向对象”的编程思想下，SDK封装了DgnTool、DgnPrimitiveTool、DgnElementSetTool等类(Class)来供编程人员使用。我们只要从相应的类派生一个我们自己的类，根据交互式工具的不同功能，重写一些基类的成员函数很容易就能实现我们的交互式工具。这种方式下我们的事件处理函数就变成类的成员函数了。

图片.png

上图是我们从MicroStationAPI.chm中截取的DgnElementSetTool在整个DgnTool工具类中的层次关系。我们可以看到DgnTool是所有工具类最顶层的基类，它定义了交互式工具使用过程中大部分的鼠标和键盘相关的事件处理函数。从SDK的头文件中我们可以查到这些函数都被定义为了虚函数，这样我们从DgnTool直接或间接派生了我们自己的类，重写了某一事件对应的虚函数时，如果对应事件被触发，系统后台会通过DgnTool的指针调用我们重写的虚函数。例如如果我们重写了_OnDataButton函数的话，当我们在视图中单击鼠标左键时，重写的这个_OnDataButton函数就会被调用。除了单击鼠标左键事件以外，还有单击鼠标右键、Ctrl/Shift/Alt键按下等事件，甚至当我们的鼠标在视图中移动以及停止移动时都会触发一个事件，这些事件都对应有相关的事件处理函数。我们的交互式工具就是在这些事件处理函数中根据用户输入的信息，而完成各种复杂的交互功能。DgnTool中常用的事件相关的成员虚函数如下表所示：

方法	触发条件
OnDataButton	视图中单击鼠标左键触发
OnResetButton	视图中单击鼠标右键触发
OnModelMotion	鼠标在视图中移动时触发
OnModelNoMotion	鼠标在视图中停留一定时间后触发
OnModelMotionStopped	鼠标在视图中停止移动时触发
OnModelStartDrag	视图中开始拖拽时触发
OnModelEndDrag	视图中停止拖拽时触发
OnModifierKeyTransition	按下Control、Shift或Alt时触发
OnUndoPreviousStep	启用撤销后按下“Ctrl+Z”时触发

• OnInstall
  是在我们的工具类真正成为当前工具之前被调用的，只有_OnInstall返回true我们的工具类才会被激活成为当前工具，如果返回false的话就不能被激活，这就给了我们一个机会去判断满足特定条件时我们的工具才能使用。
• OnPostInstll
  是在我们的工具真正激活成为当前工具之后调用的，这个时候我们就可以做一些初始化的事情了。例如如果你的工具需要一个界面让用户输入一些参数，而你又不想用Bentley提供的定义界面的方式来定制你的窗体的话，你可以通过混合编程借助于VS可视化定制界面的功能利用.Net WinForm来设计你的窗体。这个时候就可以在_OnPostInstall里边实例化你的窗体，并附加到ToolSettings窗口上去，当然这种方式需要你对混合编程比较了解才可以。

2、Microstation中的命令框架

Mstn中的命令分为视图命令和基本命令两大类，基本命令又分为放置类和修改类，它们分别需要用派生于DgnPrimitiveTool和DgnElementSetTool的类来实现，DgnElementSetTool类可用于实现修改命令。

#region 命名空间
using Bentley.DgnPlatformNET;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Bentley.DgnPlatformNET.Elements;
using Bentley.GeometryNET;
using Bentley.MstnPlatformNET;
using BIM = Bentley.Interop.MicroStationDGN;
#endregion
namespace csAddins
{
  //继承DgnElementSetTool
    class MultiScaleCopyClass : DgnElementSetTool
    {
        private MultiScaleCopyForm m_myForm;
//构造函数
        public MultiScaleCopyClass() : base(0, 0)
        {
        }
//静态函数，加载新工具
        public static void InstallNewTool()
        {
            MultiScaleCopyClass multiScaleCopyClass = new MultiScaleCopyClass();
            multiScaleCopyClass.InstallTool();
        }
//重写 OnPostInstall方法，在工具加载之前的操作
        protected override void OnPostInstall()
        {
            if (m_myForm == null)
            {
                m_myForm = new MultiScaleCopyForm();
                m_myForm.AttachToToolSettings(MyAddin.Addin);
                m_myForm.Show();
            }
            base.OnPostInstall();
        }
//重写OnCleanup方法，清理内存
        protected override void OnCleanup()
        {
            m_myForm.DetachFromMicroStation();
        }
//重写OnResetButton方法，右键点击事件，确定退出
        protected override bool OnResetButton(DgnButtonEvent ev)
        {
            OnRestartTool();
            return true;
        }
//重写OnRestartTool方法，重新启动工具
        protected override void OnRestartTool()
        {
            InstallNewTool();
        }
//重写 NeedAcceptPoint方法
        protected override bool NeedAcceptPoint()
        {
            return false;
        }
//重写 OnElementModify方法
        public override StatusInt OnElementModify(Element element)
        {
            Bentley.Interop.MicroStationDGN.Element newEl;
            double dScale = double.Parse(m_myForm.txtScale.Text);
            DgnModel dgnModel = Session.Instance.GetActiveDgnModel();
            double uorPerMaster = dgnModel.GetModelInfo().UorPerMaster;
            DPoint3d offsetPnt = new DPoint3d(double.Parse(m_myForm.txtXOffset.Text)* uorPerMaster,
          double.Parse(m_myForm.txtYOffset.Text) * uorPerMaster,
          double.Parse(m_myForm.txtZOffset.Text) * uorPerMaster);
          BIM.Application app = Bentley.MstnPlatformNET.InteropServices.Utilities.ComApp;
          long eleId = element.ElementId;
          Bentley.Interop.MicroStationDGN.Element BIMEle = app.ActiveModelReference.GetElementByID(ref eleId);

            for (int i = 0; i < int.Parse(m_myForm.txtCopies.Text); i++)
            {
                newEl = app.ActiveModelReference.CopyElement(BIMEle);
                long longid = newEl.ID;
                ElementId elementId = new ElementId(ref longid);
                Element newElement = dgnModel.FindElementById(elementId);
                DRange3d range = new DRange3d();
                ((DisplayableElement)newElement).CalcElementRange(out range);
                DTransform3d dTransform = DTransform3d.Identity;
                dTransform.Translation=new DPoint3d(-(range.Low.X + range.High.X) / 2, -(range.Low.Y + range.High.Y) / 2,
                    -(range.Low.Z + range.High.Z) / 2);
                DTransform3d dTransform2 = new DTransform3d(new DMatrix3d(dScale, 0, 0, 0, dScale, 0, 0, 0, dScale));
                dTransform2 = DTransform3d.Multiply(dTransform2, dTransform);
                dTransform = DTransform3d.Identity;
                dTransform.Translation = new DPoint3d((range.Low.X + range.High.X) / 2 + offsetPnt.X, (range.Low.Y + range.High.Y) / 2 + offsetPnt.Y,
                    (range.Low.Z + range.High.Z) / 2 + offsetPnt.Z);
                dTransform2 = DTransform3d.Multiply(dTransform, dTransform2);
                newElement.ApplyTransform(new TransformInfo(dTransform2));
                newElement.ReplaceInModel(newElement);

                eleId = newElement.ElementId;
                BIMEle = app.ActiveModelReference.GetElementByID(ref eleId);

            }
            return StatusInt.Error;
        }
    }
}