Autodesk.Revit.DB.InstanceVoidCutUtils

该工具用于将实例元素切割为虚空元素的工具类。

方法

CutInstancesWithVoid()

public static void CutInstancesWithVoid(Document doc, ICollection<ElementId> instanceIds, ICollection<ElementId> voidIds);

在文档中将给定的实例元素的几何体切割为给定的虚空元素的几何体。

参数

• doc：文档对象
• instanceIds：要被切割的实例元素的ID集合
• voidIds：用于切割实例元素的虚空元素的ID集合

异常

• ArgumentNullException：当doc、instanceIds、voidIds为空时，抛出该异常。
• ArgumentException：当任一元素ID无法在文档中找到时，抛出该异常。
• InvalidOperationException：当任一元素的几何体无法被切割时，抛出该异常。

示例

假设文档中存在Wall实例元素和Opening虚空元素，现在需要将Wall元素在Opening元素处切割（相当于开一个洞）。代码示例如下：

var wallIds = new List<ElementId>() { new ElementId(123), new ElementId(456) };
var voidIds = new List<ElementId>() { new ElementId(789) };

Autodesk.Revit.DB.InstanceVoidCutUtils.CutInstancesWithVoid(doc, wallIds, voidIds);

上述代码将会切割ID为123和456的Wall元素，根据与789元素重合的位置，开出新的洞。