NewFamilyInstance
Version comparisonPer-version detail
Click a version below to see what changed in that release vs your current frame (2022).
2022
current
ItemFactoryBase.NewFamilyInstance(Reference, XYZ, XYZ, FamilySymbol)
| reference | Reference | A reference to a face. |
| location | XYZ | Point on the face where the instance is to be placed. |
| referenceDirection | XYZ | A vector that defines the direction of the family instance. Note that this direction defines the rotation of the instance on the face, and thus cannot be parallel to the face normal. |
| symbol | FamilySymbol | A FamilySymbol object that represents the type of the instance that is to be inserted. Note that this symbol must represent a family whose <a href="/2022/7fcd2fda-21c3-9b9b-8ef3-ae2e53e02a05">FamilyPlacementType</a> is WorkPlaneBased. |
| → returns | FamilyInstance→nullNothingnullptr | An instance of the new object if creation was successful, otherwise null Nothing nullptr a null reference ( Nothing in Visual Basic) . |
ItemFactoryBase.NewFamilyInstance(Reference, XYZ, XYZ, FamilySymbol)
| reference | Reference | A reference to a face. |
| location | XYZ | Point on the face where the instance is to be placed. |
| referenceDirection | XYZ | A vector that defines the direction of the family instance. Note that this direction defines the rotation of the instance on the face, and thus cannot be parallel to the face normal. |
| symbol | FamilySymbol | A FamilySymbol object that represents the type of the instance that is to be inserted. Note that this symbol must represent a family whose <a href="/2022/7fcd2fda-21c3-9b9b-8ef3-ae2e53e02a05">FamilyPlacementType</a> is WorkPlaneBased. |
| → returns | FamilyInstance→nullNothingnullptr | An instance of the new object if creation was successful, otherwise null Nothing nullptr a null reference ( Nothing in Visual Basic) . |
ItemFactoryBase.NewFamilyInstance(Reference, XYZ, XYZ, FamilySymbol)
| reference | Reference | A reference to a face. |
| location | XYZ | Point on the face where the instance is to be placed. |
| referenceDirection | XYZ | A vector that defines the direction of the family instance. Note that this direction defines the rotation of the instance on the face, and thus cannot be parallel to the face normal. |
| symbol | FamilySymbol | A FamilySymbol object that represents the type of the instance that is to be inserted. Note that this symbol must represent a family whose <a href="/2022/7fcd2fda-21c3-9b9b-8ef3-ae2e53e02a05">FamilyPlacementType</a> is WorkPlaneBased. |
| → returns | FamilyInstance→nullNothingnullptr | An instance of the new object if creation was successful, otherwise null Nothing nullptr a null reference ( Nothing in Visual Basic) . |
ItemFactoryBase.NewFamilyInstance(Reference, XYZ, XYZ, FamilySymbol)
| reference | Reference | A reference to a face. |
| location | XYZ | Point on the face where the instance is to be placed. |
| referenceDirection | XYZ | A vector that defines the direction of the family instance. Note that this direction defines the rotation of the instance on the face, and thus cannot be parallel to the face normal. |
| symbol | FamilySymbol | A FamilySymbol object that represents the type of the instance that is to be inserted. Note that this symbol must represent a family whose <a href="/2022/7fcd2fda-21c3-9b9b-8ef3-ae2e53e02a05">FamilyPlacementType</a> is WorkPlaneBased. |
| → returns | FamilyInstance→nullNothingnullptr | An instance of the new object if creation was successful, otherwise null Nothing nullptr a null reference ( Nothing in Visual Basic) . |