Autodesk.Revit.DB.BuiltInFailures.AlignmentFailures

该类是Revit API中的一部分，对于在Revit中进行对齐时出现的失败情况进行处理的类。

继承关系

该类继承自Autodesk.Revit.DB.BuiltInFailures.FailureDefinitionId

构造函数

该类没有公共构造函数

属性

该类没有公共属性。

方法

ToString()

该方法重写了System.Object.ToString()方法，返回"Alignment Failures"。

备注

该类定义了以下的对齐失败类型：

• Collinear Alignment Failure: 当两个参考线或模型线几乎重合时发生。
• Parallel Alignment Failure: 当两个参考线或模型线几乎平行时发生。
• Perpendicular Alignment Failure: 当两个参考线或模型线几乎垂直时发生。
• Horizontal Alignment Failure: 当一个参考线或模型线几乎水平时发生。
• Vertical Alignment Failure: 当一个参考线或模型线几乎垂直时发生。

在Revit中，这些失败类型的出现通常是因为在BIM模型的构建过程中存在设计错误。当出现这种情况时，使用该类和其他Revit API中的相关类可以将失败信息呈现给用户，并在必要时尝试自动修复失败。

此外，当在Revit中添加对齐操作时，可以使用这些对齐失败类型作为约束，从而提供更准确的对齐结果。

示例

以下示例展示了如何使用该类处理对齐错误：

UIDocument uidoc = commandData.Application.ActiveUIDocument;
Document doc = uidoc.Document;
Reference ref1 = uidoc.Selection.PickObject(ObjectType.Element, "Select first element");
Reference ref2 = uidoc.Selection.PickObject(ObjectType.Element, "Select second element");

try
{
    if (!doc.IsWorkShared)
    {
        using (Transaction tx = new Transaction(doc))
        {
            tx.Start("Align elements");

            // Align elements

            tx.Commit();
        }
    }
    else
    {
        using (WorksharingUtils.DisableWorksharing(doc))
        {
            using (Transaction tx = new Transaction(doc))
            {
                tx.Start("Align elements");

                // Align elements

                tx.Commit();
            }
        }
    }
}
catch (Autodesk.Revit.Exceptions.ArgumentException ex)
{
    // Handle alignment failure

    BuiltInFailures.PostFailure(doc, BuiltInFailures.AlignmentFailures.CollinearAlignmentFailure);
}

在上面的示例中，当出现对齐失败时，将调用BuiltInFailures.PostFailure()方法并将AlignmentFailures.CollinearAlignmentFailure作为参数传递以通知Revit处理该失败类型。