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、全局参数

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

参数类型

成员名称说明
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)无法被修改。

posted @   Patrick-Rex  阅读(374)  评论(0编辑  收藏  举报  
相关博文:
阅读排行:
· 一个费力不讨好的项目,让我损失了近一半的绩效!
· 清华大学推出第四讲使用 DeepSeek + DeepResearch 让科研像聊天一样简单!
· 实操Deepseek接入个人知识库
· CSnakes vs Python.NET:高效嵌入与灵活互通的跨语言方案对比
· Plotly.NET 一个为 .NET 打造的强大开源交互式图表库
点击右上角即可分享
微信分享提示