前言

ModelessForm_ExternalEvent，这个例子主要介绍的是 Revit External Event，用来生成非模态对话框。可以理解为，在不打断 Revit 正常操作的情况下，响应用户的请求。

内容

在开始之前，先了解一下 External Event，可以参考官网：External Events
使用 External Event 的基本逻辑：

用IExternalEventHandler这个接口来实现一个事件处理的 handler 类；
用静态方法 ExternalEvent.Create() 创建一个 ExternalEvent ；
在这个非模块对话框中需要 Revit 去进行操作的时候，调用 ExternalEvent.Raise()；
在 Revit 空闲的时候，它会调用用户实现的方法 IExternalEventHandler.Execute() 。

IExternalEventHandler

用户实现一个自己的 IExternalEventHandler，这个用户的处理函数，Revit 最终会在空闲的时候调用这个类的 Execute 方法。

public class ExternalEventExample : IExternalEventHandler
{public void Execute(UIApplication app){TaskDialog.Show("External Event", "Click Close to close.");}public string GetName(){return "External Event Example";}
}

ExternalEvent

用静态方法 ExternalEvent.Create() 创建一个 ExternalEvent 。

public class ExternalEventExampleApp : IExternalApplication
{// ExternalEventExample 是 IExternalEventHandler 的一个实现public static ExternalEventExampleApp thisApp = null;// 非模态对话框的实例private ExternalEventExampleDialog m_MyForm;public Result OnShutdown(UIControlledApplication application){if (m_MyForm != null && m_MyForm.Visible){m_MyForm.Close();}return Result.Succeeded;}public Result OnStartup(UIControlledApplication application){m_MyForm = null;   // 会在用户触发 command 的时候被初始化thisApp = this;  // 记录 revit application instancereturn Result.Succeeded;}//   External command 会调用这个方法public void ShowForm(UIApplication uiapp){// 如果对话框还没有被创建，就创建一个if (m_MyForm == null || m_MyForm.IsDisposed){// 事件处理的类ExternalEventExample handler = new ExternalEventExample();// 用静态方法 `ExternalEvent.Create()` 创建一个 `ExternalEvent` ExternalEvent exEvent = ExternalEvent.Create(handler);// 把 handler 和 exEvent 都传给这个非模态对话框，最终非模态对话框通过它们来处理用户的请求m_MyForm = new ExternalEventExampleDialog(exEvent, handler);}m_MyForm.Show();}
}[Autodesk.Revit.Attributes.Transaction(Autodesk.Revit.Attributes.TransactionMode.Manual)]
public class Command : IExternalCommand
{public virtual Result Execute(ExternalCommandData commandData, ref string message, ElementSet elements){try{ExternalEventExampleApp.thisApp.ShowForm(commandData.Application);return Result.Succeeded;}catch (Exception ex){message = ex.Message;return Result.Failed;}}
}

Raise Event

通过 m_ExEvent.Raise()，让 Revit 来处理用户的请求。

public partial class ExternalEventExampleDialog : Form
{private ExternalEvent m_ExEvent;private ExternalEventExample m_Handler;public ExternalEventExampleDialog(ExternalEvent exEvent, ExternalEventExample handler){InitializeComponent();m_ExEvent = exEvent;m_Handler = handler;}protected override void OnFormClosed(FormClosedEventArgs e){// we own both the event and the handler// we should dispose it before we are closedm_ExEvent.Dispose();m_ExEvent = null;m_Handler = null;// do not forget to call the base classbase.OnFormClosed(e);}private void closeButton_Click(object sender, EventArgs e){Close();}private void showMessageButton_Click(object sender, EventArgs e){m_ExEvent.Raise();}
}

ModelessForm_ExternalEvent

最终效果如下：

对应的消息处理的类 RequestHandler 实现了 IExternalEventHandler：

public void Execute(UIApplication uiapp)
{try{switch (Request.Take()){case RequestId.None:{return;  // no request at this time -> we can leave immediately}case RequestId.Delete:{ModifySelectedDoors(uiapp, "Delete doors", e => e.Document.Delete(e.Id));break;}case RequestId.FlipLeftRight:{ModifySelectedDoors(uiapp, "Flip door Hand", e => e.flipHand());break;}case RequestId.FlipInOut:{ModifySelectedDoors(uiapp, "Flip door Facing", e => e.flipFacing());break;}case RequestId.MakeLeft:{ModifySelectedDoors(uiapp, "Make door Left", MakeLeft);break;}case RequestId.MakeRight:{ModifySelectedDoors(uiapp, "Make door Right", MakeRight);break;}case RequestId.TurnOut:{ModifySelectedDoors(uiapp, "Place door Out", TurnOut);break;}case RequestId.TurnIn:{ModifySelectedDoors(uiapp, "Place door In", TurnIn);break;}case RequestId.Rotate:{ModifySelectedDoors(uiapp, "Rotate door", FlipHandAndFace);break;}default:{// some kind of a warning here should// notify us about an unexpected request break;}}}finally{Application.thisApp.WakeFormUp();}return;
}

每一个动作最终都用调用 ModifySelectedDoors，这里用了策略设计模式，把各种类型的改变都包装成一个函数。ModifySelectedDoors 本身的逻辑很简单，就是把门过滤出来，然后对每个门调用改变的函数。

private void ModifySelectedDoors(UIApplication uiapp, String text, DoorOperation operation)
{UIDocument uidoc = uiapp.ActiveUIDocument;// 判断是否有活动的文档和选择集if ((uidoc != null) && (uidoc.Selection != null)){ICollection<ElementId> selElements = uidoc.Selection.GetElementIds();if (selElements.Count > 0){// 从当前的选择集中过滤出所有的门FilteredElementCollector collector = new FilteredElementCollector(uidoc.Document, selElements);ICollection<Element> doorset = collector.OfCategory(BuiltInCategory.OST_Doors).ToElements();if (doorset != null){using (Transaction trans = new Transaction(uidoc.Document)){// The name of the transaction was given as an argumentif (trans.Start(text) == TransactionStatus.Started){// 对每一个门进行修改foreach (FamilyInstance door in doorset){operation(door);}trans.Commit();}}}}}
}

ModelessForm_IdlingEvent

效果和 ModelessForm_ExternalEvent 一样，差别是处理函数不同。ModelessForm_IdlingEvent 是在 Revit 空闲的时候被调用。
具体逻辑：

注册 idling 事件
在idling 处理函数里进行处理

注册 idling 事件

通过 uiapp 来注册空闲事件：

public void ShowForm(UIApplication uiapp)
{// If we do not have a dialog yet, create and show itif (m_MyForm == null || m_MyForm.IsDisposed){m_MyForm = new ModelessForm();m_MyForm.Show();// if we have a dialog, we need Idling toouiapp.Idling += IdlingHandler;}
}

idling 事件处理函数

public void IdlingHandler(object sender, IdlingEventArgs args)
{UIApplication uiapp = sender as UIApplication;if (m_MyForm.IsDisposed){uiapp.Idling -= IdlingHandler;return;}else   // 对话框还打开着{// 从对话框查询用户的请求及内容RequestId request = m_MyForm.Request.Take();if (request != RequestId.None){try{// 调用具体的处理函数，和ModelessForm_ExternalEvent的处理一致RequestHandler.Execute(uiapp, request);}finally{// 激活无模态对话框m_MyForm.WakeUp();}}}return;
}

Revit SDK 介绍：ModelessForm_ExternalEvent ModelessForm_IdlingEvent相关推荐

Revit SDK 介绍：PostCommandWorkflow
前言这个例子介绍的是如何改变 Revit 的保存命令的行为. 内容程序的步骤: 启动监测修改文件,点击保存选择 Add revision now 程序逻辑菜单的创建与菜单文字的切换在IEx ...
Revit SDK 介绍：API Sketched Winder Stairs 创建扇形踏步楼梯
前言 SDK 里面一个复杂的创建楼梯的例子. 程序逻辑选择模型线,如果是两条,这是L行的楼梯,如果选中三条,则是U行的楼梯: 将 UI 界面的参数转化为内部的参数创建扇形踏步楼梯选择模型线入口 ...
系统SDK介绍-02
系统SDK介绍打开相册选择图片打开相册选择视频打开相机拍摄图片打开相机拍摄视频配置权限: 在info.plist文件中添加需要的权限相机权限:Privacy - Camera Usage ...
iOS SDK 介绍及导入
iOS SDK 介绍环信 SDK 为用户开发 IM 相关的应用提供的一套完善的开发框架.包括以下几个部分: SDK_Core: 为核心的消息同步协议实现,完成与服务器之间的信息交换. SDK: 是基 ...
Revit SDK EXTENSIONS(软件开发工具包扩展)是什么
Revit SDK EXTENSIONS(软件开发工具包扩展)是什么 Extension SDK 是开发环境,以快速开发为目的,帮助开发者以Revit扩展技术为基础创建活动插件. Extension ...
revit sdk java api,REVIT 2016二次开发环境的搭建
1.安装REVIT2016软件,这个直接在autodesk上就可以找到,找到直接安装就好了 2.安装VS环境. 3.安装REVIT 2016 SDK 下载地址在http://usa.autodesk. ...
yocto Extensible SDK介绍
yocto Extensible SDK介绍使用yocto Extensible SDK 1.1 为什么使用yocto Extensible SDK及其包含了什么 1.2 安装 Extensible ...
ST17H66 低功耗蓝牙SOC开发（1）—— SDK介绍
目录 1.资料获取 2.开发环境 3.ST17H66开发SDK获取 4.SDK介绍 4.1 components 4.2 example 4.3 lib 4.4 misc 1.资料获取伦茨17Hxx ...
叠幻AR SDK介绍
SDK介绍叠幻AR SDK是北京叠幻三维科技有限公司拥有完全自主知识产权的增强现实AR核心算法软件套件.叠幻AR SDK在浏览器端(Web)和小程序端通过极致优化增强现实AR的核心算法,为企业客户提 ...

Revit SDK 介绍：ModelessForm_ExternalEvent ModelessForm_IdlingEvent

前言

内容