M

FabricArea.Create

Description:
Creates a FabricArea based on a host boundary.

Overloads (2):

Create(Document,Element,IList[CurveLoop],XYZ,XYZ,ElementId,ElementId)

Create(Document,Element,XYZ,ElementId,ElementId)

public static FabricArea Create(
	Document aDoc,
	Element hostElement,
	XYZ majorDirection,
	ElementId fabricAreaTypeId,
	ElementId fabricSheetTypeId
)

Public Shared Function Create ( _
	aDoc As Document, _
	hostElement As Element, _
	majorDirection As XYZ, _
	fabricAreaTypeId As ElementId, _
	fabricSheetTypeId As ElementId _
) As FabricArea

public:
static FabricArea^ Create(
	Document^ aDoc, 
	Element^ hostElement, 
	XYZ^ majorDirection, 
	ElementId^ fabricAreaTypeId, 
	ElementId^ fabricSheetTypeId
)

Autodesk.Revit.DB.Document

aDoc

The document.
Autodesk.Revit.DB.Element

hostElement

The element that will host the FabricArea. The host can be a Structural Floor, Structural Wall, Structural Slab, or a Part created from a structural layer belonging to one of those element types.
Autodesk.Revit.DB.XYZ

majorDirection

A vector to define the major direction of the FabricArea.
Autodesk.Revit.DB.ElementId

fabricAreaTypeId

The id of the FabricAreaType.
Autodesk.Revit.DB.ElementId

fabricSheetTypeId

The id of the FabricSheetType.

Return Value FabricArea The newly created FabricArea.

private FabricArea CreateNewFabricArea(Document document, Element wall)
{
    FabricArea system = null;

    // create default types if they aren't already in the model
    ElementId fabricAreaTypeId = FabricAreaType.CreateDefaultFabricAreaType(document);
    ElementId fabricSheetTypeId = FabricSheetType.CreateDefaultFabricSheetType(document);

    system = FabricArea.Create(document, wall, new XYZ(1, 0, 0), fabricAreaTypeId, fabricSheetTypeId);
    // call regenerate to generate fabric sheets in fabric area
    document.Regenerate();

    // get the list of elementIds for the sheets automatically generated in the fabric area
    IList<ElementId> sheetIds = system.GetFabricSheetElementIds();

    TaskDialog.Show("Revit", string.Format("{0} fabric sheets created", sheetIds.Count));

    return system;
}

Private Function CreateNewFabricArea(document As Document, wall As Element) As FabricArea
    Dim system As FabricArea = Nothing

    ' create default types if they aren't already in the model
    Dim fabricAreaTypeId As ElementId = FabricAreaType.CreateDefaultFabricAreaType(document)
    Dim fabricSheetTypeId As ElementId = FabricSheetType.CreateDefaultFabricSheetType(document)

    system = FabricArea.Create(document, wall, New XYZ(1, 0, 0), fabricAreaTypeId, fabricSheetTypeId)
    ' call regenerate to generate fabric sheets in fabric area
    document.Regenerate()

    ' get the list of elementIds for the sheets automatically generated in the fabric area
    Dim sheetIds As IList(Of ElementId) = system.GetFabricSheetElementIds()

    TaskDialog.Show("Revit", String.Format("{0} fabric sheets created", sheetIds.Count))

    Return system
End Function

Autodesk.Revit.Exceptions.ArgumentException

The element hostElement was not found in the given document. -or- the host Element is not a valid host for Area Reinforcement, Path Reinforcement, Fabric Area or Fabric Sheet. -or- fabricAreaTypeId should refer to an FabricAreaType element. -or- fabricSheetTypeId should refer to an FabricSheetType element.
Autodesk.Revit.Exceptions.ArgumentNullException

A non-optional argument was null
Autodesk.Revit.Exceptions.ArgumentOutOfRangeException

majorDirection has zero length.
Autodesk.Revit.Exceptions.DisabledDisciplineException

None of the following disciplines is enabled: Structural.