Autodesk.Revit.DB.BuiltInFailures.ElementTypeFailures

简介

Autodesk.Revit.DB.BuiltInFailures.ElementTypeFailures 是 Revit API 中的一个类，表示元素类型失败的指示器。

在 Revit 中，创建元素时可能会出现错误，例如选择了不正确的元素类型，或者元素类型与所选的构建系统不匹配。当这些错误发生时，Revit 将显示一个消息框，提示用户出现了错误，并提供一些选项以处理错误。

Autodesk.Revit.DB.BuiltInFailures.ElementTypeFailures 类为这些错误提供了一种编程方法，以便应用程序可以自动处理它们，而无需用户手动干预。

使用

应用程序可以通过 UIApplication.FailureProcessingOptions 属性来配置如何处理元素类型失败。该属性类型为 FailureProcessingOptions。在 FailureProcessingOptions 中，可以指定一系列处理器 IFailureHandler，以处理不同类型的失败。其中一个处理器是 ElementTypeFailureHandler，即用于处理元素类型失败的处理器。

如果 ElementTypeFailureHandler 在 FailureProcessingOptions 中被启用，则当 Revit 中发生元素类型失败时，它将被自动触发，并根据设定的一些规则自动处理失败。可以通过以下方法自定义规则：

• ElementTypeFailureFilter 类：用于定义哪些错误应被视为元素类型错误。
• ElementTypeRule 类：定义如何处理特定类型的元素错误。应用程序可以添加新的规则来扩展ElementTypeFailureHandler 的功能。

示例

以下代码片段演示如何向 FailureProcessingOptions 中添加一个针对元素类型失败的处理器，以及如何添加一条处理规则，以处理某个特定的元素类型失败。

// 获取当前文档的FailureProcessingOptions
FailureProcessingOptions options = commandData.Application.Application.FailuresProcessing;

// 实例化ElementTypeFailureHandler处理器
ElementTypeFailureHandler elementTypeFailureHandler = new ElementTypeFailureHandler();

// 添加ElementTypeFailureHandler处理器到options处理列表中
options.AddFailuresPreprocessor(elementTypeFailureHandler);

// 向ElementTypeFailureHandler处理器中添加规则
// 定义一个ElementTypeRule，当元素出现在Sheets中时，将其转换为Viewports
ElementTypeRule viewportRule = new ElementTypeRule(typeof(Viewport), "Viewport sheet placement rule", FailureSeverity.Warning);
viewportRule.AddFailureResolutionType(typeof(TransformToViewportResolution));
elementTypeFailureHandler.AddRule(viewportRule);

结论

Autodesk.Revit.DB.BuiltInFailures.ElementTypeFailures 类提供了一种自动处理 Revit 元素类型失败的方法，使应用程序可以更加灵活地处理这些错误，从而提高应用程序的稳定性和操作效率。