Namespace: Autodesk.Revit.DB Class: ImageInstance

ImageInstance.Create

Method

Description:
Creates a new ImageInstance element placed in a view.

Syntax

public static ImageInstance Create(
	Document document,
	View view,
	ElementId imageTypeId,
	ImagePlacementOptions placementOptions
)

Public Shared Function Create ( 
	document As Document,
	view As View,
	imageTypeId As ElementId,
	placementOptions As ImagePlacementOptions
) As ImageInstance

public:
static ImageInstance^ Create(
	Document^ document, 
	View^ view, 
	ElementId^ imageTypeId, 
	ImagePlacementOptions^ placementOptions
)

static member Create : 
        document : Document * 
        view : View * 
        imageTypeId : ElementId * 
        placementOptions : ImagePlacementOptions -> ImageInstance

Parameters

Parameter	Type	Description
document	Document	The document.
view	View	The view in which the image will be placed.
imageTypeId	ElementId	The id of the <a href="c6213f81-8dc8-158e-0522-70f87e9bdbb9.htm">ImageType</a> element for this ImageInstance.
placementOptions	ImagePlacementOptions	Options that specify where the ImageInstance should be placed.

Return Value

Type	Description
ImageInstance	The new ImageInstance.

Exceptions

Exception	Condition
ArgumentException	The given view cannot contain ImageInstance elements -or- The given imageTypeId can not be used as a ImageType for ImageInstance elements -or- The given placementOptions specify a location that is more than 10 miles from the origin of the model.
ArgumentNullException	A non-optional argument was null
ModificationForbiddenException	The document is in failure mode: an operation has failed, and Revit requires the user to either cancel the operation or fix the problem (usually by deleting certain elements). -or- The document is being loaded, or is in the midst of another sensitive process.
ModificationOutsideTransactionException	The document has no open transaction.