Revit二次开发之创建并切换到新文档

发表于

通常方法

Revit API 中提供了Application.NewProjectDocument方法用于创建新项目，但这个方法仅在内存中对项目进行创建，Revit的界面并不会将这个项目显示出来。所以通常情况下，创建一个新项目文件需要分为三个步骤

  1. 使用Application.NewProjectDocument方法在内存中创建项目文档。
  2. 将文档进行保存并关闭。
  3. 通过OpenAndActivateDocument方法重新打开并激活该项目文档。

也就是说，目前在API提供的方法中，需要重新打开文档才能激活成活动文档。

下面的代码片段实现通常方法的项目创建

1
2
3
4
5
6
7
         	//创建
Document newDoc = uiapp.Application.NewProjectDocument(@"C:\ProgramData\Autodesk\RVT 2016\Templates\China\Construction-DefaultCHSCHS.rte");
            //保存后关闭
newDoc.SaveAs(filePath);
            newDoc.Close(false);
            //重新打开
uiapp.OpenAndActivateDocument(filePath);

第二种方法

经过查阅资料，发现有一种方法可以在不重新打开文档的情况下对活动文档进行切换。API中提供了ShowElements方法，该方法可以打开一个相关视图，以显示输入的元素。利用该方法，传入文档中被显示在某个视图中的一个元素，就可以将该文档切换成活动文档。

在使用ShowElements方法时，如果传入的元素的相关视图都没有被打开，则会弹出一个警告框，需要用户手动确认是否遍历全部视图。如果不想显示该警告框，则需要通过DialogBoxShowing事件来屏蔽该弹窗。

这种切换方法在进行多文档操作时会相对便利，因为使用OpenAndActivateDocument在文档间切换的效率比较低，尤其是在某个文档比较大时。

因此，如果想要创建一个文件并直接切换为活动文档，则可以通过以下步骤实现：

  1. 使用Application.NewProjectDocument方法在内存中创建项目文档。
  2. 临时在一个视图中创建一条详图线（如果使用了特定样板，则可以直接使用样板中的一个确定元素）。
  3. 使用ShowElements方法切换文档。
  4. 删除临时创建的详图线。

下面的代码片段实现了在Revit中创建一个新项目，并直接切换成活动文档

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
public Result Execute(ExternalCommandData commandData, ref string message, ElementSet elements)
{
    UIApplication uiapp = commandData.Application;

    uiapp.DialogBoxShowing += Uiapp_DialogBoxShowing;

    var doc = uiapp.Application.NewProjectDocument(UnitSystem.Metric);
    UIDocument uidoc = new UIDocument(doc);
    IList<Element> views = new FilteredElementCollector(doc).OfClass(typeof(ViewPlan)).ToElements();
    ViewPlan viewPlan = views.First() as ViewPlan;
    DetailCurve temCurve = null;
    
    //临时事件
    using (TransactionGroup transactionGroup = new TransactionGroup(doc, "temTransationGroup"))
    {
        transactionGroup.Start();

        using (Transaction tran = new Transaction(doc, "command1"))
        {
            tran.Start();
            temCurve = doc.Create.NewDetailCurve(viewPlan, Line.CreateBound(new XYZ(), new XYZ(0, 100, 0)));
            tran.Commit();
        }

        uidoc.ShowElements(temCurve);

        using (Transaction tran = new Transaction(doc, "command2"))
        {
            tran.Start();
            doc.Delete(temCurve.Id);
            tran.Commit();
        }
        transactionGroup.RollBack();
    }

    uiapp.DialogBoxShowing -= Uiapp_DialogBoxShowing;
    return Result.Succeeded;

}

private void Uiapp_DialogBoxShowing(object sender,Autodesk.Revit.UI.Events.DialogBoxShowingEventArgs e)
{
    e.OverrideResult((int)TaskDialogResult.Ok);
}

参考资料

https://blog.csdn.net/flower4wine/article/details/6838917

https://thebuildingcoder.typepad.com/blog/2010/11/mirroring-in-a-new-family-and-changing-active-view.html