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

原文链接：Create Dimension between Two Lines

如何创建尺寸是一个经常被问及的问题。我最近花了点儿时间研究并找到了一个解决方案，顺带纠正了 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 中就有相关的实现：

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：没有为以上这段代码添加事务。所以你需要在上面这段代码外围添加如下代码才能正确运行：

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

另外你还可以在我的博文 iterating
over the wall faces 和
FindReferencesByDirection to shoot a ray 中找到获取 Reference 的代码。