M

ItemFactoryBase.NewFamilyInstance

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

Remarks:
This overload applies only to 2D family line based detail symbols. 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 (10):

NewFamilyInstance

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,Level,StructuralType)

NewFamilyInstance(XYZ,FamilySymbol,StructuralType)

NewFamilyInstance(XYZ,FamilySymbol,View)

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

public FamilyInstance NewFamilyInstance(
	Line line,
	FamilySymbol symbol,
	View specView
)

Public Function NewFamilyInstance ( 
	line As Line,
	symbol As FamilySymbol,
	specView As View
) As FamilyInstance

public:
FamilyInstance^ NewFamilyInstance(
	Line^ line, 
	FamilySymbol^ symbol, 
	View^ specView
)

member NewFamilyInstance : 
        line : Line * 
        symbol : FamilySymbol * 
        specView : View -> FamilyInstance

Line

line

The line location of family instance. The line must in the plane of the view.
FamilySymbol

symbol

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

specView

A 2D view in which to display the family instance.

Return Value FamilyInstance FamilyInstance

ArgumentNullException

Thrown when input argument line or symbol or specView is.
ArgumentException

Thrown when input argument line or symbol or specView is invalid, or cannot make such type in the specView, or the line is not in the plane of specView.
InvalidOperationException

Thrown when failed to create the instance.
InvalidOperationException

Thrown when attempting to place a model-based family. Only 2D detail families can be placed in views.
ArgumentException

Thrown if The symbol is not active.