FamilyItemFactory
The Family Item Factory object is used to create new instances of elements within the Autodesk Revit Family.
Inheritance Hierarchy
System.Object
Autodesk.Revit.DB.APIObject
Autodesk.Revit.Creation.ItemFactoryBase
Autodesk.Revit.Creation.FamilyItemFactory
Namespace: Autodesk.Revit.Creation
Assembly: RevitAPI (in RevitAPI.dll) Version: 25.0.0.0 (25.0.0.0)
Syntax
public class FamilyItemFactory : ItemFactoryBaseThe FamilyItemFactory type exposes the following members.
Properties
Name
Description
Public Property
Code Example
IsReadOnly
Identifies if the object is read-only or modifiable.
(Inherited from APIObject)
Methods
Name
Description
Public Method
Dispose
Causes the object to release immediately any resources it may be utilizing.
(Inherited from APIObject)
Public Method
Equals
Determines whether the specified object is equal to the current object.
(Inherited from Object)
Public Method
GetHashCode
Serves as the default hash function.
(Inherited from Object)
Public Method
GetType
Gets the Type of the current instance.
(Inherited from Object)
Public Method
NewAlignment
Add a new locked alignment into the Autodesk Revit document.
(Inherited from ItemFactoryBase)
Public Method
NewAngularDimension(View, Arc, Reference, Reference)
Creates a new angular dimension object using the default dimension type.
Public Method
NewAngularDimension(View, Arc, Reference, Reference, DimensionType)
Creates a new angular dimension object using the specified dimension type.
Public Method
Code Example
NewArcLengthDimension(View, Arc, Reference, Reference, Reference)
Creates a new arc length dimension object using the default dimension type.
Public Method
NewArcLengthDimension(View, Arc, Reference, Reference, Reference, DimensionType)
Creates a new arc length dimension object using the specified dimension type.
Public Method
Code Example
NewBlend
Add a new Blend instance into the Autodesk Revit family document.
Public Method
NewControl
Add a new control into the Autodesk Revit family document.
Public Method
Code Example
NewCurveByPoints
Create a 3d curve through two or more points in an Autodesk Revit family document.
Public Method
NewDetailCurve
Creates a new detail curve element.
(Inherited from ItemFactoryBase)
Public Method
NewDetailCurveArray
Creates an array of new detail curve elements.
(Inherited from ItemFactoryBase)
Public Method
NewDiameterDimension
Creates a new diameter dimension object using the default dimension type.
Public Method
Code Example
NewDimension(View, Line, ReferenceArray)
Creates a new linear dimension object using the default dimension style.
(Inherited from ItemFactoryBase)
Public Method
NewDimension(View, Line, ReferenceArray, DimensionType)
Creates a new linear dimension object using the specified dimension style.
(Inherited from ItemFactoryBase)
Public Method
Code Example
NewExtrusion
Add a new Extrusion instance into the Autodesk Revit family document.
Public Method
Code Example
NewExtrusionForm
Create new Form element by Extrude operation, and add it into the Autodesk Revit family document.
Public Method
Code Example
NewFamilyInstance(Face, Line, FamilySymbol)
Inserts a new instance of a family onto a face of an existing element, using a line on that face for its position, and a type/symbol.
(Inherited from ItemFactoryBase)
Public Method
Code Example
NewFamilyInstance(Line, FamilySymbol, View)
Add a line based detail family instance into the Autodesk Revit document, using an line and a view where the instance should be placed.
(Inherited from ItemFactoryBase)
Public Method
Code Example
NewFamilyInstance(Reference, Line, FamilySymbol)
Inserts a new instance of a family onto a face referenced by the input Reference instance, using a line on that face for its position, and a type/symbol.
(Inherited from ItemFactoryBase)
Public Method
NewFamilyInstance(XYZ, FamilySymbol, StructuralType)
Inserts a new instance of a family into the document, using a location and a type/symbol.
(Inherited from ItemFactoryBase)
Public Method
NewFamilyInstance(XYZ, FamilySymbol, View)
Add a new family instance into the Autodesk Revit document, using an origin and a view where the instance should be placed.
(Inherited from ItemFactoryBase)
Public Method
Code Example
NewFamilyInstance(Face, XYZ, XYZ, FamilySymbol)
Inserts a new instance of a family onto a face of an existing element, using a location, reference direction, and a type/symbol.
(Inherited from ItemFactoryBase)
Public Method
Code Example
NewFamilyInstance(Reference, XYZ, XYZ, FamilySymbol)
Inserts a new instance of a family onto a face referenced by the input Reference instance, using a location, reference direction, and a type/symbol.
(Inherited from ItemFactoryBase)
Public Method
Code Example
NewFamilyInstance(XYZ, FamilySymbol, Element, StructuralType)
Inserts a new instance of a family into the document, using a location, type/symbol, and the host element.
(Inherited from ItemFactoryBase)
Public Method
NewFamilyInstance(XYZ, FamilySymbol, Level, StructuralType)
Inserts a new instance of a family into the document, using a location, type/symbol, and the level.
(Inherited from ItemFactoryBase)
Public Method
Code Example
NewFamilyInstance(XYZ, FamilySymbol, XYZ, Element, StructuralType)
Inserts a new instance of a family into the document, using a location, type/symbol, the host element and a reference direction.
(Inherited from ItemFactoryBase)
Public Method
Code Example
NewFamilyInstances2
Creates Family instances within the document.
(Inherited from ItemFactoryBase)
Public Method
NewFormByCap
Create new Form element by cap operation (to create a single-surface form), and add it into the Autodesk Revit family document.
Public Method
NewFormByThickenSingleSurface
Create a new Form element by thickening a single-surface form, and add it into the Autodesk Revit family document.
Public Method
Code Example
NewGroup
Creates a new type of group.
(Inherited from ItemFactoryBase)
Public Method
Code Example
NewLinearDimension(View, Line, ReferenceArray)
Generate a new linear dimension object using the default dimension type.
Public Method
NewLinearDimension(View, Line, ReferenceArray, DimensionType)
Creates a new linear dimension object using the specified dimension type.
Public Method
Code Example
NewLoftForm
Create new Form element by Loft operation, and add it into the Autodesk Revit family document.
Public Method
Code Example
NewModelCurve
Creates a new model line element.
(Inherited from ItemFactoryBase)
Public Method
NewModelCurveArray
Creates an array of new model line elements.
(Inherited from ItemFactoryBase)
Public Method
NewModelText
Create a model text in the Autodesk Revit family document.
Public Method
NewOpening
Create an opening to cut the wall or ceiling.
Public Method
NewRadialDimension(View, Reference, XYZ)
Creates a new radial dimension object using the default dimension type.
Public Method
NewRadialDimension(View, Reference, XYZ, DimensionType)
Generate a new radial dimension object using a specified dimension type.
Public Method
Code Example
NewReferencePlane
Creates a new instance of ReferencePlane.
(Inherited from ItemFactoryBase)
Public Method
Code Example
NewReferencePlane2
Creates a new instance of ReferencePlane.
(Inherited from ItemFactoryBase)
Public Method
NewReferencePoint(PointElementReference)
Create a reference point on an existing reference in an Autodesk Revit family document.
Public Method
NewReferencePoint(Transform)
Create a reference point at a given location and with a given coordinate system in an Autodesk Revit family document.
Public Method
NewReferencePoint(XYZ)
Create a reference point at a given location in an Autodesk Revit family document.
Public Method
Code Example
NewRevolution
Add a new Revolution instance into the Autodesk Revit family document.
Public Method
Code Example
NewRevolveForms
Create new Form elements by revolve operation, and add them into the Autodesk Revit family document.
Public Method
NewSweep(Boolean, ReferenceArray, SweepProfile, Int32, ProfilePlaneLocation)
Adds a new sweep form into the family document, using an array of selected references as a 3D path.
Public Method
Code Example
NewSweep(Boolean, CurveArray, SketchPlane, SweepProfile, Int32, ProfilePlaneLocation)
Adds a new sweep form to the family document, using a path of curve elements.
Public Method
NewSweptBlend(Boolean, Reference, SweepProfile, SweepProfile)
Adds a new swept blend into the family document, using a selected reference as the path.
Public Method
Code Example
NewSweptBlend(Boolean, Curve, SketchPlane, SweepProfile, SweepProfile)
Add a new swept blend into the family document, using a curve as the path.
Public Method
NewSweptBlendForm
Create new Form element by swept blend operation, and add it into the Autodesk Revit family document.
Public Method
NewSymbolicCurve
Create a symbolic curve in an Autodesk Revit family document.
Public Method
PlaceGroup
Place an instance of a Model Group into the Autodesk Revit document, using a location and a group type.
(Inherited from ItemFactoryBase)
Public Method
ToString
Returns a string that represents the current object.
(Inherited from Object)
Remarks
The Family Item Factory object is a utility object that is used to create new instances of elements within the Autodesk Revit Family Document. This object should be used to create elements instead of using New. This object ensures that the elements created are added to the family document correctly.