Building Coder（Revit 二次开发）- 在两条线之间创建尺寸

如何创建尺寸是一个经常被问及的问题。我最近花了点儿时间研究并找到了一个解决方案，顺带纠正了 RevitLookup 中一个相关的错误。

问题

我尝试用编程的方式创建详细的图纸，特别是使用 ItemFactoryBase.NewDimension() 方法。我根据墙元素的几何特征在草图视图中绘制细节线(Detail Line)，然后想插入相关的尺寸。但问题是我如何获取用于 NewDimension() 方法的属于细节线(Reference)的引用对象呢？

Jeremy

我建议在遇到 Revit 二次开发的问题时，首先研究如下的资料：
The Revit API 帮助文档(RevitAPI.chm)
The Revit API 开发指南(2013开始没有PDF版本了，只能在 Autodesk WikiHelp 浏览)
译者注：个人认为 2012 版的也够用了。Revit API 从 2011 到 2012 有了较大改变，但是 2012 到 2013 改动不大。
The Revit SDK 例程
其实我也是这么做的。结果发现 RevitLookup 中就有相关的实现：

[csharp]
XYZ location1 = GeomUtils.kOrigin;
XYZ location2 = new XYZ( 20.0, 0.0, 0.0 );
XYZ location3 = new XYZ( 0.0, 20.0, 0.0 );
XYZ location4 = new XYZ( 20.0, 20.0, 0.0 );

Curve curve1 = m_revitApp.Application.Create.NewLine( location1, location2, true );
Curve curve2 = m_revitApp.Application.Create.NewLine( location3, location4, true );

DetailCurve dCurve1 = null;
DetailCurve dCurve2 = null;

if( !doc.IsFamilyDocument )
{
dCurve1 = doc.Create.NewDetailCurve( doc.ActiveView, curve1 );
dCurve2 = doc.Create.NewDetailCurve( doc.ActiveView, curve2 );
}
else
{
// 只有基于细节(Detail)的族文档才能创建细节曲线(Detail Curve)
if( null != doc.OwnerFamily
    && null != doc.OwnerFamily.FamilyCategory )
{
    if( !doc.OwnerFamily.FamilyCategory.Name.Contains( "Detail" ) )
    {
      MessageBox.Show(
        "Please make sure you open a detail based family template.",
        "RevitLookup", MessageBoxButtons.OK,
        MessageBoxIcon.Information );

      return;
    }
}
dCurve1 = doc.FamilyCreate.NewDetailCurve( doc.ActiveView, curve1 );
dCurve2 = doc.FamilyCreate.NewDetailCurve( doc.ActiveView, curve2 );
}

Line line = m_revitApp.Application.Create.NewLine( location2, location4, true );

ReferenceArray refArray = new ReferenceArray();

refArray.Append( dCurve1.GeometryCurve.Reference );
refArray.Append( dCurve2.GeometryCurve.Reference );

if( !doc.IsFamilyDocument )
{
doc.Create.NewDimension( doc.ActiveView, line, refArray );
}
else
{
doc.FamilyCreate.NewDimension( doc.ActiveView, line, refArray );
}

你可以通过 Add-Ins > Revit Lookup > Test Framework... > Object Hierarchy > APIObject > Element > Dimension 来调用 DimensionHardWired 外部命令。它实现了上面这段代码。不过这里 RevitLookup 有个小 BUG：没有为以上这段代码添加事务。所以你需要在上面这段代码外围添加如下代码才能正确运行：

[csharp]
using( Transaction tx = new Transaction( doc ) )
{
tx.Start( "DimensionHardWired" );
......
tx.Commit();
}

补充：软件开发 , C# ,