ImageInstanceCreate Method |
Creates a new ImageInstance element placed in a view.
Namespace: Autodesk.Revit.DBAssembly: RevitAPI (in RevitAPI.dll) Version: 25.0.0.0 (25.0.0.0)
Syntaxpublic 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
- document Document
-
The document.
- view View
-
The view in which the image will be placed.
- imageTypeId ElementId
-
The id of the ImageType element for this ImageInstance.
- placementOptions ImagePlacementOptions
-
Options that specify where the ImageInstance should be placed.
Return Value
ImageInstance
The new ImageInstance.
ExceptionsException | 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.
|
See Also