【Revit 二次开发】创建带箭头的文字注释（字体设置+引线箭头设置）

此篇文章仅是自己的开发经验分享，不具备官方参考价值，如有不足，欢迎批评指正

开发目的：

创建一个带箭头的文字注释字体为新宋体，大小2.5mm,宽度系数0.7，箭头为30度实心箭头 like this

分析开发目标：

1、分析在Revit里面创建目标文字注释的步骤

第一步，Revit的菜单目录，“注释”——>“文字”，创建好以后发现，Revit创建文字注释默认没有箭头

第二步，选中文字注释，菜单栏出现如图右上角的图标，选择想要创建的样式和方向（可以试一下四个的效果，分别是左直线，右直线，左弧线，右弧线，这张图里面弧线是灰色的，若要使其正常，在上图左侧的属性栏里面勾选上“弧引线”即可）。由此步骤可以得知，在Revit二次开发的过程当中，引线也是可以选择是否创建，选择创建的方向（左还是右），选择创建样式（直线还是弧线），还可以改变位置，如图引线有两个点，查阅资料可得，这两点分别是Leader.Elbow（弯头点），和Leader.End（端点，即箭头上的那个点）

2、分析创建好了的文字注释的属性

第一步：选中创建好的文字注释，“编辑属性”

第二步：分析属性（一般要求会修改颜色，文字字体，宽度系数），我的开发目标还要修改引线箭头

开发：

我们可以查到创建文字注释在新版本中做了修改，以前是用文档对象进行创建，图片截自

https://blog.csdn.net/weixin_40626630/article/details/84108269

新版本：现在是用TextNote对象进行创建

那么我们回顾一下开发目的（创建一个带箭头的文字注释，字体为新宋体，大小2.5mm,宽度系数0.7，箭头为30度实心箭头）

代码如下：

using Autodesk.Revit.Attributes;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Autodesk.Revit.DB;
using Autodesk.Revit.UI;
using Autodesk.Revit.UI.Selection;namespace CreateTextNode
{[Regeneration(RegenerationOption.Manual)][Transaction(TransactionMode.Manual)]public class CreateTextNode : IExternalCommand{public Result Execute(ExternalCommandData cmdData,ref string msg,ElementSet elems){UIApplication uiapp = cmdData.Application;UIDocument uidoc = uiapp.ActiveUIDocument;Document doc = uidoc.Document;View view = doc.ActiveView;//若此视图没有工作平面则新建工作平面（比如二次开发在剖面是需要新建工作平面的）if (view.SketchPlane == null){Transaction ts1 = new Transaction(doc, "新建工作平面");ts1.Start();Plane plane = Plane.CreateByNormalAndOrigin(doc.ActiveView.ViewDirection, doc.ActiveView.Origin);SketchPlane sp = SketchPlane.Create(doc, plane);doc.ActiveView.SketchPlane = sp;view = doc.ActiveView;ts1.Commit();}Selection S1 = uidoc.Selection;XYZ textNodeLocationPt = null;try{textNodeLocationPt = S1.PickPoint("请选择文字注释创建位置");}catch (Autodesk.Revit.Exceptions.OperationCanceledException){}if (textNodeLocationPt != null){//创建文字注释OptionTextNoteOptions options = new TextNoteOptions();options.HorizontalAlignment = HorizontalTextAlignment.Left; //文字水平对齐方式options.TypeId = doc.GetDefaultElementTypeId(ElementTypeGroup.TextNoteType);options.VerticalAlignment = VerticalTextAlignment.Top;//文字垂直对齐方式double dWidth = 0.07;//文字宽度//箭头端点XYZ leaderEnd = new XYZ(textNodeLocationPt.X -1500/304.8, textNodeLocationPt.Y+1500/304.8, textNodeLocationPt.Z);using (Transaction tran = new Transaction(doc, "Create  Textnote")){tran.Start();//创建文字注释TextNote note = TextNote.Create(doc, doc.ActiveView.Id, textNodeLocationPt, dWidth, "净高控制线", options);note.AddLeader(TextNoteLeaderTypes.TNLT_STRAIGHT_L); //引线方向，一共四种，左直，右直，左弧，右弧note.LeaderLeftAttachment = LeaderAtachement.TopLine;//引线的位置，top代表引线位置在第一行文本的位置IList<Leader> leaderList = note.GetLeaders();foreach (Leader leader in leaderList){leader.End = leaderEnd;//给箭头端点设置值XYZ pointElbow = new XYZ(leaderEnd.X, leader.Anchor.Y, leaderEnd.Z);leader.Elbow = pointElbow;//给箭头弯头点设置值}//创建文字注释的族类型，族类型名称“宋体_2.5mm”,首先判断当前族类型是不是，不是就判断有没有该族类型，有就用，没有就创建了再用if (note.TextNoteType.Name != "宋体_2.5mm"){Parameter familyType = (note as Element).get_Parameter(BuiltInParameter.ELEM_FAMILY_AND_TYPE_PARAM);if (familyType != null && familyType.StorageType == StorageType.ElementId && familyType.AsElementId().IntegerValue >= 0){Element elem_2 = doc.GetElement(familyType.AsElementId());TextNoteType type = elem_2 as TextNoteType;if (type != null){ElementId elementId = null;bool symbolExist = false;FilteredElementCollector collectorSymbol = new FilteredElementCollector(doc);IList<Element> textSymbols = collectorSymbol.OfClass(typeof(TextNoteType)).ToElements();foreach (var item in collectorSymbol){if (item.Name == "宋体_2.5mm"){symbolExist = true;elementId = item.Id;}}if (symbolExist){(note as TextNote).ChangeTypeId(elementId);//依据ID改变族类型}else{TextNoteType duplicatedtextType = null;duplicatedtextType = type.Duplicate("宋体_2.5mm") as TextNoteType;string textNode = duplicatedtextType.LookupParameter("文字大小").AsString() + duplicatedtextType.LookupParameter("文字大小").AsValueString();string dut_gerneral = duplicatedtextType.LookupParameter("宽度系数").AsString() + duplicatedtextType.LookupParameter("宽度系数").AsValueString();string text_Form = duplicatedtextType.LookupParameter("文字字体").AsString() + duplicatedtextType.LookupParameter("文字字体").AsValueString();string text_Elbow = duplicatedtextType.LookupParameter("引线箭头").AsString() + duplicatedtextType.LookupParameter("引线箭头").AsValueString();if (textNode != null && textNode != "2.5mm"){duplicatedtextType.LookupParameter("文字大小").SetValueString("2.5mm");}if (dut_gerneral != null && dut_gerneral != 0.7.ToString()){duplicatedtextType.LookupParameter("宽度系数").Set(0.70);}if (text_Form != null && text_Form != "新宋体"){duplicatedtextType.LookupParameter("文字字体").Set("新宋体");}if (text_Elbow != null && text_Elbow != "楼梯碰头_30度实心箭头"){//创建族类型——楼梯碰头_30度实心箭头Element arrowType = doc.GetElement(duplicatedtextType.LookupParameter("引线箭头").AsElementId());arrowType.LookupParameter("箭头样式").Set(8);arrowType.Name = "楼梯碰头_30度实心箭头";arrowType.LookupParameter("箭头宽度角").Set(0.523598775598298);arrowType.LookupParameter("填充记号").Set(1);arrowType.LookupParameter("记号尺寸").Set(0.00984251968503937);}note.TextNoteType = duplicatedtextType;}}}}//设置显示颜色（也可修改文字注释颜色的属性）Color color = new Color((byte)255, (byte)128, (byte)128);OverrideGraphicSettings ogs = new OverrideGraphicSettings();ogs.SetProjectionLineColor(color);//投影表面线的颜色view.SetElementOverrides(note.Id, ogs);tran.Commit();}}return Result.Succeeded;}}
}

最后的效果，文字注释的族类型名称为“宋体_2.5mm”，引线箭头族类型是“楼梯碰头_30度实心箭头”，字体是新宋体，大小是2.5mm，宽度系数0.7

开发总结：

1、本Demo的例子的几个知识点，① 创建TextNote ②创建文字注释的族类型 ③ 创建箭头族类型

2、整个逻辑过程，①用户选择一个点，作为文字注释的位置 ② 箭头端点坐标为用户选择点的x向左偏1500，y向上偏1500。箭头弯头坐标是端点的x，引线锚点（引线与文本框的接触点）的y，端点的z ③创建一个默认文字注释 ④ 如果创建的文字注释用的族类型不叫"宋体_2.5mm"，则就找是否有这个族类型，有就直接用，没有就创建一个再用 ⑤创建该族类型的过程是，复制当前使用的族类型，再改相应属性的值，文字字体，字体大小，宽度系数可以直接改，引线箭头的值是箭头这个系统族下的族类型，所以再创建一个“楼梯碰头_30度实心箭头”