Autodesk.Revit.DB.ReferenceWithContext

Autodesk.Revit.DB.ReferenceWithContext类是Revit API提供的一个类，用于表示被选中构件并提供上下文环境，以进行与此构件相关的操作。

属性

• Reference: Autodesk.Revit.DB.Reference类型，表示被选中的构件所对应的Reference。
• OptionalContext: Autodesk.Revit.DB.Element类型，表示上下文环境中可能的构件，例如选择的墙体上的门的上下文环境中是墙体。

构造函数

• ReferenceWithContext(Autodesk.Revit.DB.Reference reference): 创建不包含上下文环境的ReferenceWithContext对象。
• ReferenceWithContext(Autodesk.Revit.DB.Reference reference, Autodesk.Revit.DB.Element optionalContext): 创建包含给定上下文环境的ReferenceWithContext对象。

方法

• GetGeometryObjectFromReference(): 获取被选中构件在Revit视图中的几何表示。

示例

public void AddWallPaint(Autodesk.Revit.UI.UIDocument uidoc)
{
    Autodesk.Revit.DB.ReferenceWithContext rwc = uidoc.Selection.PickObject(Autodesk.Revit.UI.Selection.ObjectType.Element, "Pick a wall");
    if (rwc != null)
    {
        Autodesk.Revit.DB.Element elem = uidoc.Document.GetElement(rwc.OptionalContext.Id);
        if (elem != null && elem is Wall)
        {
            XYZ wallMidpoint = ((Wall)elem).Location.PointAtParameter(0.5);
            XYZ paintLocation = wallMidpoint - new XYZ(0, 0, 1); //paint 1 foot below wall midpoint
            Autodesk.Revit.DB.Reference paintRef = rwc.Reference; //use the selected wall's Reference
            using (Transaction trans = new Transaction(uidoc.Document, "Paint Wall"))
            {
                trans.Start();
                uidoc.Document.Create.NewPaint(paintLocation, paintRef, "Red");
                trans.Commit();
            }
        }
    }
}

在上面的示例中，用户选中一堵墙，并将该墙传递给AddWallPaint方法中的ReferenceWithContext对象。在此墙的上下文环境中，该方法创建了一个新的油漆标记，其参照是选定的墙Reference。

参见

• Autodesk.Revit.DB.Reference类
• Autodesk.Revit.DB.Element类