Autodesk.Revit.DB.BuiltInFailures.EditingFailures

Autodesk.Revit.DB.BuiltInFailures.EditingFailures是Revit API中的一个枚举类型，用于指定在Revit中编辑过程中可能出现的失败原因。

枚举值

以下是EditingFailures枚举类型的枚举值和相应的描述：

• InaccurateGenericInsertion: 当尝试插入一个家具或装饰时，发现其位置不够准确。例如，家具在实际墙壁内部的位置而不是拼花上。
• InaccurateElementSize: 找到的元素的大小不准确。例如，墙壁的高度过短或过高。
• InaccurateAlignment: 找到的元素的对齐方式不准确。例如，梁的对齐方式不符合要求。
• InaccurateWallJoin: 墙之间的连接不准确。例如，当两个墙之间没有正确对齐时。
• InaccurateWallSweep: 找到的墙掠过错位。例如，从一个墙延伸到另一个墙或天花板时遇到困难。
• MissingRequiredGeometry: 没有为所需的几何对象提供足够的信息。例如，缺少必要的某些结构的基础图纸或者描述。
• JoinedGeometryConflict: 有冲突的 joined 几何体。例如，两个墙壁进行拼合时，某些区域出现了冲突。
• LinkedElementConflict: 有冲突的链接元素。例如，在链接模型的对象冲突。
• InvalidAddition: 尝试添加的元素无法被添加到模型中。例如，添加一个 3D 模型文件并尝试将其存入 Revit 中时遇到错误。
• InvalidDeletion: 尝试删除的元素无法从模型中删除。例如，尝试删除原始构成建筑物的几何体时遇到错误。
• InvalidOperation: 尝试执行无效操作。例如，尝试重叠拼合两个墙体时遇到错误。

使用方法

EditingFailures枚举类型被广泛用于Revit API中，以指定在Revit中的编辑过程中可能出现的错误，并且通常用于与FailureMessageAccessor类一起使用。通过与FailureMessageAccessor类一起使用，你可以捕获某些失败，并向用户提供信息。

以下代码示范了如何捕获墙体冲突的失败信息：

var failDoc = commandData.Application.ActiveUIDocument.Document;
var options = new TransactionOptions();
options.SetFailuresPreprocessor(new FailurePreprocessor());
using (Transaction transaction = new Transaction(failDoc, "Demo"))
{
    transaction.SetFailureHandlingOptions(options);
    transaction.Start();
    var wall1 = Wall.Create(failDoc, Line.CreateBound(new XYZ(0, 0, 0), new XYZ(0, 0, 10)), ElementId.InvalidElementId, false);
    var wall2 = Wall.Create(failDoc, Line.CreateBound(new XYZ(0, 0, 0), new XYZ(0, 0, 10)), ElementId.InvalidElementId, false);
    var failureAccessor = new FailureMessageAccessor();
    if (failureAccessor.HasFailure())
    {
        failureAccessor.DeleteAllWarnings();
    }
    transaction.Commit();
}

结论

Autodesk.Revit.DB.BuiltInFailures.EditingFailures在Revit API编程中具有广泛应用。通过指定不同的枚举值，它帮助我们了解并解决在Revit编辑过程中可能出现的各种错误。