Creates a new ImageType element and loads the image into it.

Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 21.0.0.0 (21.1.1.109)
Since:  2020

Syntax

C#
public static ImageType Create(
	Document document,
	ImageTypeOptions options
)
Visual Basic
Public Shared Function Create ( _
	document As Document, _
	options As ImageTypeOptions _
) As ImageType
Visual C++
public:
static ImageType^ Create(
	Document^ document, 
	ImageTypeOptions^ options
)

Parameters

document
Type: Autodesk.Revit.DB..::..Document
The document.
options
Type: Autodesk.Revit.DB..::..ImageTypeOptions
Options that specify what image to load.

Return Value

The new ImageType.

Remarks

The ImageType will be created but will not be placed into any view.

Exceptions

ExceptionCondition
Autodesk.Revit.Exceptions..::..ArgumentException The image filename is an empty string. -or- The image file is not a supported image file type. -or- The image file is password protected. -or- The image file does not contain the requested page number. -or- The image file could not be read and may be corrupt. -or- An error occurred while handling the external resource corresponding to the image.
Autodesk.Revit.Exceptions..::..ArgumentNullException A non-optional argument was NULL
Autodesk.Revit.Exceptions..::..FileArgumentNotFoundException The image file does not exist.
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.
Autodesk.Revit.Exceptions..::..OptionalFunctionalityNotAvailableException The image file is a PDF file, but PDF import is not available in the installed Revit.

See Also