Autodesk.Revit.DB.BuiltInFailures.DirectContext3DFailures

概述

Autodesk.Revit.DB.BuiltInFailures.DirectContext3DFailures是Revit API中的一组内置故障ID，用于捕获直接上下文中三维操作中可能出现的错误。

使用方法

使用BuiltInFailures后缀创建显式捕获直接上下文3D操作中的错误。下面是一些ID示例：

• InvalidSectionBox：当SectionBox为无效的值时，捕获该错误。
• CanNotEditSectionBox：当SectionBox处于视觉化模式或视图无法编辑时，捕获该错误。
• CanNotPlaceView：当试图将视图放置在不支持的视图类型上或在无效的区域中时，捕获该错误。

建议在捕获内置故障ID时，慎重地处理错误消息以确保不会清除或失去数据。

以下是一个示例代码片段：

foreach (BuiltInFailures.FailureDefinitionId failureDef in BuiltInFailures.DirectContext3DFailures)
{
   FailureDefinition failureDefinition = FailureDefinition.Create(failureDef, FailureSeverity.Warning, "Custom Handler");
   Application.DocumentChanged += new EventHandler<DocumentChangedEventArgs>(OnDocumentChangedHandler);   
} 
private void OnDocumentChangedHandler(object sender, DocumentChangedEventArgs e)
{
   FailuresAccessor failuresAccessor = e.GetFailuresAccessor();
   IList<FailureMessageAccessor> failureMessages = failuresAccessor.GetFailureMessages();
   List<ElementId> idsToFail = new List<ElementId>();
   foreach (FailureMessageAccessor failureMessage in failureMessages)
   {
      failuresAccessor.DeleteWarning(failureMessage);
   }
}

故障ID列表

以下是Autodesk.Revit.DB.BuiltInFailures.DirectContext3DFailures组中包含的内置故障ID：

• InvalidSectionBox
• InvalidDepthCueingDistance
• CanNotEditSectionBox
• VisibilitySettingsInConflict
• CanNotPlaceView
• CanNotPlaceViewCropBoxUpdatedAt
• CanNotFitViewToSheet
• CanNotAddCropBoundaryToDesignOptionView
• ViewTintInConflict
• CanNotSetPrintRangeWhilePrintingToPDF

结论

Autodesk.Revit.DB.BuiltInFailures.DirectContext3DFailures是Revit API的一部分，可用于捕获直接上下文中三维操作中可能出现的错误。建议在处理错误消息时小心谨慎，以避免清除或丢失数据。在使用内置故障ID时，可参考上述示例代码片段。