FamilyItemFactory.NewOpening
Method
Description:
Create an opening to cut the wall or ceiling.
Create an opening to cut the wall or ceiling.
Parameters
| Parameter | Type | Description |
|---|---|---|
| host | Element | Host elements that new opening would lie in. The host can only be a wall or a ceiling. |
| profile | CurveArray | The profile of the newly created opening. This may contain more than one curve loop. Each loop must be a fully closed curve loop and the loops may not intersect. The profiles will be projected into the host plane. |
Return Value
| Type | Description |
|---|---|
| Opening | If successful, the newly created opening is returned, otherwise an exception with error information will be thrown. |
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | Thrown when the input argument host or profile is. |
| ArgumentException | Thrown when host isn't a wall or a ceiling. Thrown when profile doesn't contain any loops. |
| InvalidOperationException | Thrown when opening creation failed. |