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、全局参数
是用于定义全局的参数信息,这个参数可以不归属任何构件,但可以作为其他构件参数中的变量。
参数类型
成员名称 | 说明 |
---|---|
Number | 实数,可包括小数点 |
Moment | 力矩 |
AreaForce | 面力 |
LinearForce | 线性力 |
Force | 力 |
YesNo | 布尔值,表示为Yes或No |
Material | 材料属性值 |
URL | 文本字符串,表示网址 |
Angle | 角度。内部表示为弧度。用户可见为用户已选定的单位表示 |
Volume | 体积。内部表示为十进制立方英尺。用户可见为用户已选择的单位表示 |
Area | 面积。内部表示为十进制平方英尺。用户可见为用户已选择的单位表示 |
Integer | 整数,或正或负 |
Invalid | 参数类型无效,不应使用此值 |
Length | 长度。内部表示为十进制英尺。用户可见为用户已选择的单位表示 |
Text | 文本字符串 |
获取/修改参数
元素都有参数,可以通过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)无法被修改。
本文来自博客园,作者:Patrick-Rex,转载请注明原文链接:https://www.cnblogs.com/patrickrex/p/18028786
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 一个费力不讨好的项目,让我损失了近一半的绩效!
· 清华大学推出第四讲使用 DeepSeek + DeepResearch 让科研像聊天一样简单!
· 实操Deepseek接入个人知识库
· CSnakes vs Python.NET:高效嵌入与灵活互通的跨语言方案对比
· Plotly.NET 一个为 .NET 打造的强大开源交互式图表库