Autodesk.Revit.DB.Architecture.StairsRun

Autodesk.Revit.DB.Architecture.StairsRun是Revit API中的一个类，用于表示楼梯中的一段梯段。每个梯段包含一个或多个踏板和一个或多个板间隔。该类提供了访问和操作梯段和其相关元素的方法和属性。

构造函数

Autodesk.Revit.DB.Architecture.StairsRun类的构造函数有多个重载，可以根据需要进行选择。其中包括：

• StairsRun()： 默认构造函数，创建一个空的梯段对象。
• StairsRun(StairsContainingFeature, StairsRunCreationData)： 使用包含该梯段的楼梯对象和该梯段的创建数据创建一个新的梯段对象。
• StairsRun(StairsContainingFeature, int)： 使用包含该梯段的楼梯对象和梯段的索引号创建一个新的梯段对象。

属性

Autodesk.Revit.DB.Architecture.StairsRun类提供了以下常用属性：

• BottomElevation： 梯段底部的高程。
• Height： 梯段的高度。
• Index： 梯段在整个楼梯中的顺序索引号。
• LandingHeight： 梯段与楼层之间的平台高度。
• NumRisers： 梯段中踏板数目。
• RiserHeight： 每个踏板的高度。
• RunWidth： 梯段的宽度。

方法

Autodesk.Revit.DB.Architecture.StairsRun类提供了以下常用方法：

• GetBounds()： 获取梯段的边界框对象。
• GetRiserPosition(int)： 获取第n个踏板的位置。
• SetRiserPosition(int, double)： 设置第n个踏板的位置。

示例

以下示例展示了如何使用Autodesk.Revit.DB.Architecture.StairsRun类创建一个新的梯段对象，并设置其踏板位置：

// 获取当前文档
Document doc = __revit__.ActiveUIDocument.Document;

// 获取包含新梯段的楼梯对象
StairsContainingFeature stairs = doc.GetElement(new ElementId(12345)) as StairsContainingFeature;

// 创建梯段创建数据对象
StairsRunCreationData data = new StairsRunCreationData();
data.RiserHeight = 0.15;  // 设置踏板高度
data.RunWidth = 1.2;  // 设置梯段宽度
data.NumberOfRisers = 6;  // 设置踏板数
double[] riserPositions = new double[] { 0, 0.25, 0.5, 0.75, 1.0, 1.2 };  // 设置踏板位置
data.SetRiserPositionArray(riserPositions);

// 创建新的梯段对象
StairsRun newRun = new StairsRun(stairs, data);

// 将新梯段添加到文档中
doc.Create.AddStairsRun(stairs.Id, newRun);

以上示例创建了一个包含6个踏板的新梯段对象，并且将其添加到了文档中。踏板位置由riserPositions数组指定，分别位于0、0.25、0.5、0.75、1.0和1.2处。