Creates a FabricArea based on a host boundary.

Namespace: Autodesk.Revit.DB.Structure
Assembly: RevitAPI (in RevitAPI.dll) Version: 24.0.0.0 (24.0.0.0)
Since: 2015

Syntax

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

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

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

Parameters

aDoc: Type: Autodesk.Revit.DBDocument
The document.

hostElement: Type: Autodesk.Revit.DBElement
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.

majorDirection: Type: Autodesk.Revit.DBXYZ
A vector to define the major direction of the FabricArea.

fabricAreaTypeId: Type: Autodesk.Revit.DBElementId
The id of the FabricAreaType.

fabricSheetTypeId: Type: Autodesk.Revit.DBElementId
The id of the FabricSheetType.

Return Value

The newly created FabricArea.

Examples

CopyC#

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;
}

CopyVB.NET

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

Exceptions

Exception	Condition
Autodesk.Revit.ExceptionsArgumentException	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.ExceptionsArgumentNullException	A non-optional argument was null
Autodesk.Revit.ExceptionsArgumentOutOfRangeException	majorDirection has zero length.

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

Syntax

Parameters

Return Value

Examples

Exceptions

See Also

Stop fighting Revit automation.