NewFamilyInstance

Version comparison

2020 2021 2022 2023 2024 2025 2025.3 2026 2027

Per-version detail

Click a version below to see what changed in that release vs your current frame (2027).

Identical to 2027: 2025, 2025.3, 2026

2027 current

ItemFactoryBase.NewFamilyInstance(Face, XYZ, XYZ, FamilySymbol)

face	Face	A face of a geometry object.
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="7fcd2fda-21c3-9b9b-8ef3-ae2e53e02a05.htm">FamilyPlacementType</a> is WorkPlaneBased.
→ returns	nullNothingnullptr→FamilyInstance	An instance of the new object if creation was successful, otherwise .

ItemFactoryBase.NewFamilyInstance(Face, XYZ, XYZ, FamilySymbol)

face	Face	A face of a geometry object.
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="7fcd2fda-21c3-9b9b-8ef3-ae2e53e02a05.htm">FamilyPlacementType</a> is WorkPlaneBased.
→ returns	nullNothingnullptr→FamilyInstance	An instance of the new object if creation was successful, otherwise .

ItemFactoryBase.NewFamilyInstance(Face, XYZ, XYZ, FamilySymbol)

face	Face	A face of a geometry object.
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="7fcd2fda-21c3-9b9b-8ef3-ae2e53e02a05.htm">FamilyPlacementType</a> is WorkPlaneBased.
→ returns	nullNothingnullptr→FamilyInstance	An instance of the new object if creation was successful, otherwise .

ItemFactoryBase.NewFamilyInstance(Face, XYZ, XYZ, FamilySymbol)

face	Face	A face of a geometry object.
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="7fcd2fda-21c3-9b9b-8ef3-ae2e53e02a05.htm">FamilyPlacementType</a> is WorkPlaneBased.
→ returns	nullNothingnullptr→FamilyInstance	An instance of the new object if creation was successful, otherwise .

ItemFactoryBase.NewFamilyInstance(Face, XYZ, XYZ, FamilySymbol)

face	Face	A face of a geometry object.
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="7fcd2fda-21c3-9b9b-8ef3-ae2e53e02a05.htm">FamilyPlacementType</a> is WorkPlaneBased.
→ returns	nullNothingnullptr→FamilyInstance	An instance of the new object if creation was successful, otherwise .