UnitType 参数 revit 2022 - C#

在Revit开发中，许多API方法和属性都会使用UnitType参数。这个参数是一个枚举类型，用于指定单位类型，帮助我们在API中使用正确的单位。

在Revit 2022中，UnitType参数有多种选项，主要分为以下几类：

• 建筑单位（Architecture）：用于标识用于建筑设计的长度、面积和体积单位。这包括英制（英尺、平方英尺、立方英尺）和公制（米、平方米、立方米）单位。

UnitType.Feet;
UnitType.SquareFeet;
UnitType.CubicFeet;
UnitType.Meters;
UnitType.SquareMeters;
UnitType.CubicMeters;

• 枚举单位（Enumeration）：用于表示枚举类型的值。

UnitType.UT_Enum;

• 电力单位（Electrical）：用于表示电气设计中的电压和电流。这些包括伏特、安培和华特。

UnitType.Volts;
UnitType.Amps;
UnitType.Watts;

• 管道单位（Piping）：用于在管道和风道设计中表示长度、面积和体积。这包括英制（英尺、平方英尺、立方英尺）和公制（米、平方米、立方米）单位。

UnitType.FeetFractionalInches;
UnitType.FeetAndDecimalInches;
UnitType.SquareFeet;
UnitType.CubicFeet;
UnitType.Meters;
UnitType.SquareMeters;
UnitType.CubicMeters;

• 结构单位（Structural）：用于表示重量、长度和面积等结构设计上的单位。这包括伦（kips）、英制（英寸、英尺、平方英尺）和公制（千克、米、平方米）单位。

UnitType.Kips;
UnitType.Inches;
UnitType.Feet;
UnitType.SquareFeet;
UnitType.Kilograms;
UnitType.Meters;
UnitType.SquareMeters;

• 水暖单位（MEP）：用于在水暖设计中表示长度、面积和体积。这包括英制（英尺、平方英尺、立方英尺）和公制（米、平方米、立方米）单位。

UnitType.FeetFractionalInches;
UnitType.FeetAndDecimalInches;
UnitType.SquareFeet;
UnitType.CubicFeet;
UnitType.Meters;
UnitType.SquareMeters;
UnitType.CubicMeters;

使用UnitType参数时，我们需要根据应用程序的设计需求选择正确的单位类型。这有助于确保API使用正确的单位，从而避免单位转换错误。

示例代码

// 获取当前文档单位
UnitType currentUnitType = Document.GetUnits().GetDefaultUnit(ForgeTypeId) as ForgeUnitType;
string currentUnitSymbol = currentUnitType.GetUnitSymbol();
double currentFactor = currentUnitType.GetConversionFactor();

// 将距离转换为文档单位
double value = 100; // 比如 100 米
double convertedValue = UnitUtils.ConvertFromInternalUnits(value, currentUnitType);

// 将距离从文档单位转换为米
double distance = UnitUtils.ConvertToInternalUnits(convertedValue, currentUnitType);

以上代码示例展示了如何获取当前文档中使用的单位类型，以及如何通过UnitUtils类将距离从一个单位转换为另一个单位。