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(Reference, Line, FamilySymbol)

reference	Reference	A reference to a face.
position	Line	A line on the face defining where the symbol is to be placed.
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 or CurveBased.
→ returns	nullNothingnullptr→FamilyInstance	An instance of the new object if creation was successful, otherwise .

ItemFactoryBase.NewFamilyInstance(Reference, Line, FamilySymbol)

reference	Reference	A reference to a face.
position	Line	A line on the face defining where the symbol is to be placed.
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 or CurveBased.
→ returns	nullNothingnullptr→FamilyInstance	An instance of the new object if creation was successful, otherwise .

ItemFactoryBase.NewFamilyInstance(Reference, Line, FamilySymbol)

reference	Reference	A reference to a face.
position	Line	A line on the face defining where the symbol is to be placed.
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 or CurveBased.
→ returns	nullNothingnullptr→FamilyInstance	An instance of the new object if creation was successful, otherwise .

ItemFactoryBase.NewFamilyInstance(Reference, Line, FamilySymbol)

reference	Reference	A reference to a face.
position	Line	A line on the face defining where the symbol is to be placed.
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 or CurveBased.
→ returns	nullNothingnullptr→FamilyInstance	An instance of the new object if creation was successful, otherwise .

ItemFactoryBase.NewFamilyInstance(Reference, Line, FamilySymbol)

reference	Reference	A reference to a face.
position	Line	A line on the face defining where the symbol is to be placed.
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 or CurveBased.
→ returns	nullNothingnullptr→FamilyInstance	An instance of the new object if creation was successful, otherwise .