M

ItemFactoryBase.NewFamilyInstance

Description:
Add a new family instance into the Autodesk Revit document, using an origin and a view where the instance should be placed.

Remarks:
This overload applies only to 2D family symbols (detail components, annotation symbols, titleblocks, etc.). The type/symbol that is used must be loaded into the document before this method is called. Families and their symbols can be loaded using the Document.LoadFamily or Document.LoadFamilySymbol methods.

Overloads (9):

NewFamilyInstance(Face,Line,FamilySymbol)

NewFamilyInstance(Face,XYZ,XYZ,FamilySymbol)

NewFamilyInstance(Line,FamilySymbol,View)

NewFamilyInstance(Reference,Line,FamilySymbol)

NewFamilyInstance(Reference,XYZ,XYZ,FamilySymbol)

NewFamilyInstance(XYZ,FamilySymbol,Element,StructuralType)

NewFamilyInstance(XYZ,FamilySymbol,StructuralType)

NewFamilyInstance(XYZ,FamilySymbol,View)

NewFamilyInstance(XYZ,FamilySymbol,XYZ,Element,StructuralType)

public FamilyInstance NewFamilyInstance(
	XYZ origin,
	FamilySymbol symbol,
	View specView
)

Public Function NewFamilyInstance ( _
	origin As XYZ, _
	symbol As FamilySymbol, _
	specView As View _
) As FamilyInstance

public:
FamilyInstance^ NewFamilyInstance(
	XYZ^ origin, 
	FamilySymbol^ symbol, 
	View^ specView
)

Autodesk.Revit.DB.XYZ

origin

The origin of family instance. If created on a ViewPlan, the origin will be projected onto the ViewPlan.
Autodesk.Revit.DB.FamilySymbol

symbol

A family symbol object that represents the type of the instance that is to be inserted.
Autodesk.Revit.DB.View

specView

The 2D view in which to place the family instance.

Return Value FamilyInstance If creation was successful then an instance to the new object is returned.

Autodesk.Revit.Exceptions.ArgumentNullException

One or more required arguments wasnullNothingnullptra null reference (Nothingin Visual Basic)
Autodesk.Revit.Exceptions.ArgumentException

The input family PlacementType was not ViewBased, the input view was not 2D, Thrown if The symbol is not active. or instances of the input FamilySymbol are not permitted on a view of this type.