Revit API 开发 (7): Event 事件的应用

前言

Event 是一个在各种编程语言中，都非常重要的概念。它是一种重要的设计模式，Revit API 也需要利用它来完成一些工作。
在介绍 Event 之前，首先说明一下Revit API 中的两个 Application 类。Autodesk.Revit.Creation.Application 和 Autodesk.Revit.ApplicationServices.Application。
前者主要功能是在 Revit 里创建新的元素，比如族实例信息，几何图形等等。
后者主要功能包括文档的创建和打开，文档整体的操作，还有 Event 事件处理。

细节

例子

在下面这个例子中：

1. 使用 IExternalApplication，在它的 OnStartup 中注册事件，在它的 OnShutdown 中取消事件。
2. 事件处理方法是在注册的时候传进去的，这里是 application_DocumentOpened。
3. 在事件处理方法中，可以编写你自己的逻辑，他会在文档打开之后执行。

public class Application_DocumentOpened : IExternalApplication
{public Result OnStartup(UIControlledApplication application){application.ControlledApplication.DocumentOpened += new EventHandler<Autodesk.Revit.DB.Events.DocumentOpenedEventArgs>(application_DocumentOpened);return Result.Succeeded;}public Result OnShutdown(UIControlledApplication application){application.ControlledApplication.DocumentOpened -= application_DocumentOpened;return Result.Succeeded;}public void application_DocumentOpened(object sender, DocumentOpenedEventArgs args){Document doc = args.Document;using (Transaction transaction = new Transaction(doc, "Edit Address")){if (transaction.Start() == TransactionStatus.Started){// 在这里，你可以编写你想要的操作。doc.ProjectInformation.Address ="United States - Massachusetts - Waltham - 1560 Trapelo Road";transaction.Commit();}}}
}

事件类型

Autodesk.Revit.ApplicationServices.Application 类中的主要事件：