Stairs Components

Runs

Stairs by component are composed of runs, landings and supports.  Each of these items can be retrieved from the Stairs class.  A run is represented in the Revit API by the StairsRun class.  The following example gets each run for a Stairs object and makes sure that it begins and ends with a riser.

private void AddStartandEndRisers(Stairs stairs)
{
    ICollection<ElementId> runIds = stairs.GetStairsRuns();
            
    foreach (ElementId runId in runIds)
    {
        StairsRun run = stairs.Document.GetElement(runId) as StairsRun;
        if (null != run)
        {
            run.BeginsWithRiser = true;
            run.EndsWithRiser = true;
        }
    }
}

The StairsRun class provides access to run properties such as the StairsRunStyle (straight, winder, etc.), BaseElevation, TopElevation, and properties about the risers.  There are also methods in the StairsRun class to access the supports hosted by the run, either all, or just those on the left or right side of the run boundaries.  The GetStairsPath() method will return the curves representing the stairs path on the run, which are projected onto the base level of the stairs.  The GetFootprintBoundary() method returns the run's boundary curves which are also projected onto the stairs' base level.

There are three static methods of the StairsRun class for creating new runs.  These are covered in the Creating and Editing Stairs section.

The StairsRunType class represents the type of a StairsRun.  It contains many properties about the treads and risers of the run as well as other information about the run.  The following example gets the StairsRunType for the first run in a Stairs element and displays the riser and tread thicknesses along with the type's name.

private void GetRunType(Stairs stairs)
{
    ICollection<ElementId> runIds = stairs.GetStairsRuns();

    ElementId firstRunId = runIds.First();

    StairsRun firstRun = stairs.Document.GetElement(firstRunId) as StairsRun;
    if (null != firstRun)
    {
        StairsRunType runType = stairs.Document.GetElement(firstRun.GetTypeId()) as StairsRunType;
        // Format landing type info for display
        string info = "Stairs Run Type:  " + runType.Name;
        info += "\nRiser Thickness:  " + runType.RiserThickness;
        info += "\nTread Thickness:  " + runType.TreadThickness;

        TaskDialog.Show("Revit", info);
    }
}

Landings

Landings are represented by the StairsLanding class.  The following example finds the thickness for each landing of a Stairs object.

private void GetStairLandings(Stairs stairs)
{
    ICollection<ElementId> landingIds = stairs.GetStairsLandings();
    string info = "Number of landings:  " + landingIds.Count;

    int landingIndex = 0;
    foreach (ElementId landingId in landingIds)
    {
        landingIndex++;
        StairsLanding landing = stairs.Document.GetElement(landingId) as StairsLanding;
        if (null != landing)
        {
            info += "\nThickness of Landing " + landingIndex + ":  " + landing.Thickness;
        }
    }

    TaskDialog.Show("Revit", info);
}

Similar to StairsRun, StairsLanding has a GetStairsPath() method which returns the curves representing the stairs path on the landing projected onto the base level of the stairs and a GetFootprintBoundary() method which returns the landing's boundary curves, also projected onto the stairs' base level.  Also similar to StairsRun, there is a method to get all of the supports hosted by the landing.

The StairsLanding class has a method to create a new landing between two runs.  It is covered in the Creating and Editing Stairs section.

The StairsLandingType class represents a landing type in the Revit API.  The StairsLandingType class has only a couple of properties specific to it, namely IsMonolithic which is true if the stairs landing is monolithic, and Thickness, representing the thickness of the stairs landing.

Supports

The Revit API does not expose a class for stairs supports.  When getting the supports for Stairs, StairsRun, or a StairsLanding, the supports will be generic Revit Elements.  The following example gets the names of all the supports for a Stairs object.

private void GetStairSupports(Stairs stairs)
{
    ICollection<ElementId> supportIds = stairs.GetStairsSupports();
    string info = "Number of supports:  " + supportIds.Count;

    int supportIndex = 0;
    foreach (ElementId supportId in supportIds)
    {
        supportIndex++;
        Element support = stairs.Document.GetElement(supportId);
        if (null != support)
        {
            info += "\nName of support " + supportIndex + ":  " + support.Name;
        }
    }

    TaskDialog.Show("Revit", info);
}