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)无法被修改。