7. Revit API UI: ExternalEvent（外部事件）

接着上一篇，上一篇中，我们简单讲了下预览控件，并给了示例。

示例中，通过点击按钮，删除楼板模型，这是怎么做到的呢？这就得用到ExternalEvent和IExternalEventHandler了。

实现与使用流程

IExternalEventHandler，外部事件接口；ExternalEvent，外部事件。

在写外部事件之前，我们先回忆一下外部应用（IExternalApplication），不记得可以去第二篇看看。

先在外部应用的启动方法中，添加工具栏相关控件，在按钮上绑定已实现的外部命令，这样就可以在像使用Revit工具栏一样使用它们了。

外部事件基本类似，只不过绑定的不是Revit API中的控件（Ribbon）。

流程：

实现IExternalEventHandler接口，这和IExternalCommand一样一样的
使用ExternalEvent.Create创建一个实例，传的就是第1步实现的。
调用方法Raise()，进行执行。

就是如此简单。

至于类成员之类的就不看了，没什么看头…吗？

等等，还真有点东西！

ExternalEvent.Raise()

我们来看看这个玩意儿的描述：“Revit processes external events only when no other commands or edit modes are currently active in Revit, which is the same policy like the one that applies to evoking external commands. ”

意思是Revit会在空闲时处理外部事件，即当前没有其他命令或编辑模式处于活动状态时执行

P.S.后一句说这和外部命令是一样的，好吧，我之前还没看这个。

这样，上一篇“注”中提到的问题也就得到了解释。

PreviewControl创建后，会一直处于活动状态，要关闭（Dispose()）后其它命令才能执行。

示例

还是看个例子吧，接着上一篇。

实现外部事件接口

[Transaction(TransactionMode.Manual)]  // 外部事件接口中，这个居然可以不加
[Journaling(JournalingMode.NoCommandData)]
internal class ExternalEventCommand : IExternalEventHandler
{public void Execute(UIApplication app){UIDocument uiDoc = app.ActiveUIDocument;Document doc = uiDoc.Document;// 找到FloorFilteredElementCollector collector = new FilteredElementCollector(doc);IList<ElementId> floorIds = collector.OfClass(typeof(Floor)).ToElementIds().ToList();using (Transaction transaction = new Transaction(doc, "Delete All Floor")){transaction.Start();foreach (ElementId floorId in floorIds){doc.Delete(floorId);  // 删除楼板}transaction.Commit();}}public string GetName(){return "ExternalEventCommand: Delete all floor.";}
}

使用外部事件

public partial class PreviewControlWindow : Window
{private readonly ExternalEvent externalEvent;public PreviewControlWindow(){this.InitializeComponent();this.externalEvent = ExternalEvent.Create(new ExternalEventCommand());}private void Btn_DeleteFloor_Click(object sender, RoutedEventArgs e){this.externalEvent.Raise();  // 执行}
}