Revit二次开发——参数获取和修改

Revit参数获取和修改

• 参数
• 获取/修改参数

参数

参数是记录Revit元素模型属性的对象。在Revit软件中，属性界面中的内容就是Revit参数的一种展现形式。参数作为Revit提供的一种编辑图元参数的通用机制，这里介绍这种机制是如何实现的，以及如何访问参数。

在Revit平台API中，参数在图元类中进行管理。可用以下这些方法访问参数:
●通过遍历某图元所有参数的Element.Parameters集合获取所选图元参数
●通过重载Element.Parameter属性直接访问参数。若参数不存在，则此属性返回null。
●由Element.ParametersMap集合，通过名称访问参数。

若已知名称字符串、内置ID、定义或GUID,则可从图元中检索参数对象。Parameter[String]属性重载根据其本地化名称获取参数，如果需在多个语言区域运行，并要按名称查找参数，那么编写的代码应能处理不同的语言。Parameter [GUID]属性重载根据其全局唯一标识 (GUID) 获取共享参数，当其创建时GUID即已被分配给共享参数。

参数归属
Revit的特点，就是其所有元素，都可以通过参数化驱动，参数之间可以进行计算，而驱动构件的运行，参数应用可划分为以下几个方面：

1、族参数

主要用于定义族的参数信息，用于驱动族的特点，其不会出现在明细表和标记之中，此参数存储在族文件本身。

2、项目参数

是之给当前项目中指定对象添加参数，此参数可以出现在明细表，但无法出现在标记中，此参数存储在项目文件之中。

3、共享参数

是文件外部定义的参数，这些参数需要共享文件来定义，其特点是可以由多个项目和族共享，也可以自由导出到任何明细表和标记中。

4、全局参数

是用于定义全局的参数信息，这个参数可以不归属任何构件，但可以作为其他构件参数中的变量。

参数类型

获取/修改参数

元素都有参数,可以通过Element.Parameters获取所有的参数，然后遍历找到需要的参数。也可以通过Element. get_ Parameter( 参数)来获取单个参数,这里“参数”有四种选择:string参数名字. BuiltInParameter参数枚举、Definition参数定义和Guid参数的guid.
注意:使用元素名字查找元素的时候，需要注意本地化的问题，因为不同语言的Revito版本的参数名字是不一样的，比如中文版的叫“长度”的参数,英文叫“Length",同样的程序(比如上面的例子)，在英文里面就会出问题。对此，我们建议尽量使用BuiltInParameter。效率上讲，最高的是BuiltInParameter参数,其次是Definition和Guid,最慢的是使用参数名字。

using System;
using System.Collections;
using System.Collections.Generic;
using System.Linq;
using Autodesk.Revit.DB;
using Autodesk.Revit.UI;namespace HelloRevitParameter
{[Autodesk.Revit.Attributes.Transaction(Autodesk.Revit.Attributes.TransactionMode.Manual)]public class RevitAllParameterCmd : IExternalCommand{public Autodesk.Revit.UI.Result Execute(ExternalCommandData commandData, ref string message,ElementSet elements){try{UIDocument uidoc = commandData.Application.ActiveUIDocument;//获取句柄Document doc = uidoc.Document;//获取文档ICollection<ElementId> selIds = uidoc.Selection.GetElementIds();//获取选择的图元id集合Element element = null;if (0 != selIds.Count){element = doc.GetElement(selIds.Last());}if (null != element){ParameterSet paramSet = element.Parameters;//获取参数集合if (paramSet.IsEmpty)//判空{TaskDialog.Show("参数", "当前元素参数为空！");}else{string msg = string.Empty;IEnumerator pIter = paramSet.GetEnumerator();//循环访问的枚举数while (pIter.MoveNext())//循环输出参数{Parameter param = (Parameter)pIter.Current;//获取枚举数当前位置的元素if (null != param){msg += string.Format("{0}:{1}\n", param.Definition.Name, param.AsValueString());}}TaskDialog.Show("参数", msg);}}else{TaskDialog.Show("选集", "当前选集没有元素！");}return Autodesk.Revit.UI.Result.Succeeded;}catch (Exception ex){message = ex.Message;return Autodesk.Revit.UI.Result.Failed;}}}
}

using System;
using System.Collections;
using System.Collections.Generic;
using System.Linq;
using Autodesk.Revit.DB;
using Autodesk.Revit.UI;namespace HelloRevitParameter
{[Autodesk.Revit.Attributes.Transaction(Autodesk.Revit.Attributes.TransactionMode.Manual)]public class RevitParameterCmd : IExternalCommand{public Autodesk.Revit.UI.Result Execute(ExternalCommandData commandData, ref string message,ElementSet elements){try{UIDocument uidoc = commandData.Application.ActiveUIDocument;Document doc = uidoc.Document;ICollection<ElementId> selIds = uidoc.Selection.GetElementIds();Element element = null;if (0 != selIds.Count){element = doc.GetElement(selIds.Last());}if (null != element){Parameter param = element.LookupParameter("类别");if (null == param){TaskDialog.Show("参数", "当前元素没有类别参数！");}else{string msg = string.Empty;msg += string.Format("{0}:{1}\n", param.Definition.Name, param.AsValueString());TaskDialog.Show("参数", msg);}}else{TaskDialog.Show("选集", "当前选集没有元素！");}return Autodesk.Revit.UI.Result.Succeeded;}catch (Exception ex){message = ex.Message;return Autodesk.Revit.UI.Result.Failed;}}}
}

使用BuiltInParameter获取长度

wall wall= null;
Parameter parameterLength = wall. get_ Parameter(BuiltInParameter.CURVE_ELEM_LENGTH);
if (parameterlength ! = null && parameterLength.StorageType = = StorageType . Double)
{double length = parameterLength.AsDouble( );//使用length
}

2)修改参数
获取到参数之后，进行修改就比较简单了,直接调用Parameter. Set(参数)这个函数。

可以做一些判断
判断该参数是否是ReadOnly (p.IsReadOnly)
判断该参数交互时是否可修改(p.UserModifiable)
判断该参数的StorageType
将要写入该参数的值转换为相应的数据类型，然后Set()

Parameter parameterBase0ffset = wall.get_ Parameter(BuiltInParameter.WALL BASE _OFFSET);
if (parameterBase0ffset ! = null && parameterBase0ffset.StorageType = = StorageType.
Double)
{if (! parameterBase0ffset.IsRead0nly)bool success = parameterBase0ffset.Set(10);if (! success)//更新错误报告}else//参数是只读的
}

①设置的值类型一定要和参数的存储类型匹配,如果参数类型是string,我们调用的是
Set(0. 123),就会出错。
②只读参数(即Parameter. IsReadOnly= = true)无法被修改。

本文来自互联网用户投稿，文章观点仅代表作者本人，不代表本站立场，不承担相关法律责任。如若转载，请注明出处。 如若内容造成侵权/违法违规/事实不符，请点击【内容举报】进行投诉反馈！