M

Document.NewFloor

Description:
Creates a floor within the project with the given horizontal profile and floor style on the specified level with the specified normal vector.

Remarks:
The curves of the profile must be contiguous and the Face formed by profile should be suitable to create floor.

Overloads (3):

NewFloor(CurveArray,Boolean)

NewFloor(CurveArray,FloorType,Level,Boolean)

NewFloor(CurveArray,FloorType,Level,Boolean,XYZ)

public Floor NewFloor(
	CurveArray profile,
	FloorType floorType,
	Level level,
	bool structural,
	XYZ normal
)

Public Function NewFloor ( _
	profile As CurveArray, _
	floorType As FloorType, _
	level As Level, _
	structural As Boolean, _
	normal As XYZ _
) As Floor

public:
Floor^ NewFloor(
	CurveArray^ profile, 
	FloorType^ floorType, 
	Level^ level, 
	bool structural, 
	XYZ^ normal
)

Autodesk.Revit.DB.CurveArray

profile

An array of planar lines and arcs that represent the horizontal profile of the floor.
Autodesk.Revit.DB.FloorType

floorType

A floor type to be used by the new floor instead of the default type.
Autodesk.Revit.DB.Level

level

The level on which the floor is to be placed.
Boolean

structural

If set, specifies that the floor is structural in nature.
Autodesk.Revit.DB.XYZ

normal

A vector that must be perpendicular to the profile which dictates which side of the floor is considered to be upper and down.

Return Value nullNothingnullptr if successful, a new floor object within the project, otherwise null Nothing nullptr a null reference ( Nothing in Visual Basic) .

Floor CreateFloor(UIApplication application, Level level)
{
    // Get the Revit document
    Autodesk.Revit.DB.Document document = application.ActiveUIDocument.Document;

    // Get the application creation object
    Autodesk.Revit.Creation.Application appCreation = application.Application.Create;

    // Get a floor type for floor creation
    FilteredElementCollector collector = new FilteredElementCollector(document);
    collector.OfClass(typeof(FloorType));
    FloorType floorType = collector.FirstElement() as FloorType;

    // Build a floor profile for the floor creation
    XYZ first = new XYZ(0, 0, 0);
    XYZ second = new XYZ(20, 0, 0);
    XYZ third = new XYZ(20, 15, 0);
    XYZ fourth = new XYZ(0, 15, 0);
    CurveArray profile = new CurveArray();
    profile.Append(Line.CreateBound(first, second));
    profile.Append(Line.CreateBound(second, third));
    profile.Append(Line.CreateBound(third, fourth));
    profile.Append(Line.CreateBound(fourth, first));

    // The normal vector (0,0,1) that must be perpendicular to the profile.
    XYZ normal = XYZ.BasisZ;

    return document.Create.NewFloor(profile, floorType, level, true, normal);
}

Private Function CreateFloor(application As UIApplication, level As Level) As Floor
    ' Get the Revit document
    Dim document As Autodesk.Revit.DB.Document = application.ActiveUIDocument.Document

    ' Get the application creation object
    Dim appCreation As Autodesk.Revit.Creation.Application = application.Application.Create

    ' Get a floor type for floor creation
    Dim collector As New FilteredElementCollector(document)
    collector.OfClass(GetType(FloorType))
    Dim floorType As FloorType = TryCast(collector.FirstElement(), FloorType)

    ' Build a floor profile for the floor creation
    Dim first As New XYZ(0, 0, 0)
    Dim second As New XYZ(20, 0, 0)
    Dim third As New XYZ(20, 15, 0)
    Dim fourth As New XYZ(0, 15, 0)
    Dim profile As New CurveArray()
    profile.Append(Line.CreateBound(first, second))
    profile.Append(Line.CreateBound(second, third))
    profile.Append(Line.CreateBound(third, fourth))
    profile.Append(Line.CreateBound(fourth, first))

    ' The normal vector (0,0,1) that must be perpendicular to the profile.
    Dim normal As XYZ = XYZ.BasisZ

    Return document.Create.NewFloor(profile, floorType, level, True, normal)
End Function

Autodesk.Revit.Exceptions.ArgumentException

Thrown if the floor type does not exist in the given document.
Autodesk.Revit.Exceptions.ArgumentException

Thrown if the level does not exist in the given document.