M

ImageInstance.Create

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

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
)

Autodesk.Revit.DB.Document

document

The document.
Autodesk.Revit.DB.View

view

The view in which the image will be placed.
Autodesk.Revit.DB.ElementId

imageTypeId

The id of the ImageType element for this ImageInstance.
Autodesk.Revit.DB.ImagePlacementOptions

placementOptions

Options that specify where the ImageInstance should be placed.

Return Value The new ImageInstance. The new ImageInstance.

Autodesk.Revit.Exceptions.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.
Autodesk.Revit.Exceptions.ArgumentNullException

A non-optional argument was NULL
Autodesk.Revit.Exceptions.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.
Autodesk.Revit.Exceptions.ModificationOutsideTransactionException

The document has no open transaction.