Autodesk.Revit.UI.PreviewControl

Autodesk.Revit.UI.PreviewControl 是Revit中一种用于显示预览图的用户界面控件。它提供了对Revit模型预览图的实时浏览。

控件属性

Document 属性

• 数据类型：Autodesk.Revit.DB.Document
• 描述：获取或设置当前显示的Revit文档。

CategoryFilter 属性

• 数据类型：Autodesk.Revit.DB.BuiltInCategory
• 描述：获取或设置在预览窗口中显示的Revit类别。

ModelPosition 属性

• 数据类型：Autodesk.Revit.DB.XYZ
• 描述：获取或设置Revit模型在控件中的位置。

ModelRotation 属性

• 数据类型：System.Double
• 描述：获取或设置Revit模型在控件中的旋转角度。

控件方法

SetModel方法

SetModel方法用于将Revit模型加载到控件中。

• 参数：
  • Autodesk.Revit.DB.Document modelDocument：要加载的Revit文档。
  • Autodesk.Revit.DB.BuiltInCategory categoryFilter：要在预览中显示的模型类别。
  • bool defaultOrientation：设置true时，在加载模型时使用默认方向。

Refresh方法

Refresh方法用于刷新预览控件。

示例代码

//创建一个PreviewControl实例
var previewControl = new Autodesk.Revit.UI.PreviewControl();
//获取要显示的Revit文档
var modelDocument = commandData.Application.ActiveUIDocument.Document;
//设置要在预览中显示的模型类别
var categoryFilter = Autodesk.Revit.DB.BuiltInCategory.OST_Walls;
//将Revit模型加载到控件中
previewControl.SetModel(modelDocument, categoryFilter, true);
//显示控件
ShowPreviewControl(previewControl);

注意事项

• 预览控件只能显示Revit文档中已加载的模型元素。
• 控件支持实时互动，可以通过鼠标拖动控件中的模型元素来改变其位置和旋转角度。
• 控件的默认大小为200x200像素，可以通过改变控件的大小来显示更多的细节信息。
• 在预览控件中显示的模型元素与实际场景可能存在差异，因为预览控件中的元素是在内存中重建的。

参考文献

• Autodesk.Revit.UI.PreviewControl Documentation