| Revit 2023 API |
| FaceWall..::..Create Method |
| FaceWall Class See Also |
Creates a new instance of a wall attached to a non-vertical massing face.
Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 23.0.0.0 (23.1.0.0)
Since:
2011
Syntax
| C# |
|---|
public static FaceWall Create( Document document, ElementId wallType, WallLocationLine locationLine, Reference faceReference ) |
| Visual Basic |
|---|
Public Shared Function Create ( _ document As Document, _ wallType As ElementId, _ locationLine As WallLocationLine, _ faceReference As Reference _ ) As FaceWall |
| Visual C++ |
|---|
public: static FaceWall^ Create( Document^ document, ElementId^ wallType, WallLocationLine locationLine, Reference^ faceReference ) |
Parameters
- document
- Type: Autodesk.Revit.DB..::..Document
The document.
- wallType
- Type: Autodesk.Revit.DB..::..ElementId
The wall type. This must be a wall type accepted by IsWallTypeValidForFaceWall()
- locationLine
- Type: Autodesk.Revit.DB..::..WallLocationLine
The alignment of the wall location line.
- faceReference
- Type: Autodesk.Revit.DB..::..Reference
The reference from the massing face. This must pass IsValidFaceReferenceForFaceWall()
Return Value
The newly created face wall.Remarks
This method will regenerate the document.
Exceptions
| Exception | Condition |
|---|---|
| Autodesk.Revit.Exceptions..::..ArgumentException | The element wallType does not exist in the document -or- document is not a project document. -or- This wall type cannot be applied to a face wall. -or- This reference cannot be applied to a face wall. |
| Autodesk.Revit.Exceptions..::..ArgumentNullException | A non-optional argument was null |
| Autodesk.Revit.Exceptions..::..ArgumentOutOfRangeException | A value passed for an enumeration argument is not a member of that enumeration |
| Autodesk.Revit.Exceptions..::..ForbiddenForDynamicUpdateException | During a dynamic update, the newly created face wall is going to be joined to surrounding structures. |
| Autodesk.Revit.Exceptions..::..InvalidOperationException | The document is in failure mode: an operation has failed, and Revit requires the user to either cancel the operation or fix the problem (usually by deleting certain elements). -or- The element is a member of a loaded family. -or- The element is a member of a group type that is not being edited. |
| Autodesk.Revit.Exceptions..::..ModificationForbiddenException | The document is in failure mode: an operation has failed, and Revit requires the user to either cancel the operation or fix the problem (usually by deleting certain elements). -or- The document is being loaded, or is in the midst of another sensitive process. |
| Autodesk.Revit.Exceptions..::..ModificationOutsideTransactionException | The document has no open transaction. |