Autodesk.Revit.DB.Architecture.TopographyEditScope

介绍

Autodesk.Revit.DB.Architecture.TopographyEditScope是Revit API中的一个类，用于在特定的上下文环境中进行地形编辑。该类通常用于启动地形编辑操作，并在编辑完成后自动撤销对数据库的更改。

示例

以下示例演示了如何使用TopographyEditScope将地形高度高于500英尺的点删除：

// 获取Revit文档
Document doc = commandData.Application.ActiveUIDocument.Document;

// 获取要编辑的地形
TopographySurface surface = null;
if (null != doc.ActiveView)
{
    FilteredElementCollector collector = new FilteredElementCollector(doc, doc.ActiveView.Id);
    surface = collector.OfClass(typeof(TopographySurface)).Cast<TopographySurface>().FirstOrDefault();
}

if (null != surface)
{
    // 创建TopographyEditScope
    using (TopographyEditScope editScope = new TopographyEditScope(doc, "Delete Points"))
    {
        editScope.Start(surface.Id);

        // 遍历所有点
        foreach (UV point in surface.GetPoints())
        {
            double elevation = surface.GetElevation(point);
            if (elevation > 500)
            {
                surface.DeleteVertex(point);
            }
        }

        // 结束TopographyEditScope
        editScope.Commit(new TopographyEditScopeFinishOptions());
    }
}

方法

构造函数

TopographyEditScope(Document, String)

• 描述：创建一个新的TopographyEditScope
• 参数:
  • doc: 要操作的文档。
  • name: 上下文名称。

成员变量

bool IsActive

• 描述：获取或设置当前TopographyEditScope是否处于活动状态。

方法

void Start(ElementId)

• 描述：启动编辑操作。
• 参数:
  • id: 要编辑的TopographySurface的元素ID。

void Commit(TopographyEditScopeFinishOptions)

• 描述：完成编辑操作，并提交对数据库的更改。
• 参数:
  • options: 结束编辑操作时的选项。

void Dispose()

• 描述：释放所有由该对象持有的资源并撤销对数据库的更改。

注意事项

• TopographyEditScope不应跨多个线程使用。
• 始终在using语句块中使用TopographyEditScope对象，以确保及时处理所有资源。
• 始终使用Start方法来启动地形编辑操作，并使用Commit方法结束操作并提交对数据库的更改。
• 在使用TopographyEditScope时，应格外注意对文档的所有更改，因为会将整个TopographySurface传递给编辑操作，而不只是一个单独的数据点。如果在编辑操作期间进行了其他更改，则这些更改也将包含在已提交的更改集中。