Autodesk.Revit.DB.Events.PreEventArgs

Autodesk.Revit.DB.Events.PreEventArgs是Revit API中的一种事件参数类型，在事件发生前提供了相应的信息。

概述

PreEventArgs类是所有事件参数类的父类，它提供了事件发生前需要的信息，包括：

• Cancel属性：获取或设置一个值，表示是否取消事件。
• HandlerGuid属性：获取与事件关联的处理程序的全局唯一标识符（GUID）。
• HandlerType属性：获取与事件关联的处理程序的类型。

继承关系

PreEventArgs类的继承关系如下：

System.Object
  Autodesk.Revit.DB.Events.PreEventArgs

使用方法

用户可以通过继承PreEventArgs类，实现事件发生前自定义逻辑。通常情况下，需要在自定义类中重写Cancel属性的setter方法，以实现取消事件的功能。

以下代码示例演示如何使用PreEventArgs类：

public class CustomPreEventArgs : PreEventArgs
{
    public CustomPreEventArgs(Guid handlerGuid, Type handlerType)
        : base(handlerGuid, handlerType)
    { }

    public override bool Cancel
    {
        get { return base.Cancel; }
        set
        {
            // 打印取消事件的信息
            if (value)
            {
                Console.WriteLine($"Event {HandlerType.Name}({HandlerGuid}) is canceled.");
            }

            base.Cancel = value;
        }
    }
}

public class CustomEventHandler : IExternalEventHandler
{
    public void Execute(UIApplication app)
    {
        // 注册事件PreTransactionsCommitting
        app.ApplicationEvents.PreTransactionsCommitting += new EventHandler<CustomPreEventArgs>(OnPreTransactionsCommitting);

        // 模拟创建事务并提交，触发PreTransactionsCommitting事件。
        using (Transaction t = new Transaction(app.ActiveUIDocument.Document, "Custom Transaction"))
        {
            t.Start();
            t.Commit();
        }
    }

    private void OnPreTransactionsCommitting(object sender, CustomPreEventArgs e)
    {
        Console.WriteLine($"Event {e.HandlerType.Name}({e.HandlerGuid}) is triggered.");
    }

    public string GetName()
    {
        return "CustomEvent";
    }
}

// 注册外部事件
CustomEventHandler handler = new CustomEventHandler();
ExternalEvent externalEvent = ExternalEvent.Create(handler);

// 执行外部事件
externalEvent.Raise();

在上述代码中，自定义了一个名为CustomPreEventArgs的类，继承自PreEventArgs类，重写了Cancel属性的setter方法。该类与CustomEventHandler类一起使用，用于注册Revit的PreTransactionsCommitting事件。在事件触发时，如果取消了事件，将会打印出取消事件的信息。如果没有取消事件，则只打印出事件触发的信息。

参考资料

• Autodesk.Revit.DB.Events.PreEventArgs