DocumentImport(String, AXMImportOptions, View) Method |
Imports an AXM file into the document.
Namespace: Autodesk.Revit.DBAssembly: RevitAPI (in RevitAPI.dll) Version: 25.0.0.0 (25.0.0.0)
Syntaxpublic ElementId Import(
string file,
AXMImportOptions options,
View pDBView
)
Public Function Import (
file As String,
options As AXMImportOptions,
pDBView As View
) As ElementId
public:
ElementId^ Import(
String^ file,
AXMImportOptions^ options,
View^ pDBView
)
member Import :
file : string *
options : AXMImportOptions *
pDBView : View -> ElementId
Parameters
- file String
-
Full path of the file to import. File must exist and must be a valid AXM file.
- options AXMImportOptions
-
Various import options applicable to the AXM format. If , all options will be set to their respective default values.
Import FormIt support Preserve color mode, center-to-center and origin-to-origin placement, other options are not supported.
Import FormIt does not support orient to view and this view only option.
- pDBView View
-
View used to aid placement of the imported file. If the options specify center-to-center placement, this argument is required and the imported
file will be placed in the center of the specified view. Otherwise, this view is used to obtain a base level to associate with the imported
file. If not specified, an existing view will be chosen instead and may open a view or associate the imported file to an arbitrary level.
Return Value
ElementId
Returns the element Id of the imported instance.
ExceptionsException | Condition |
---|
ArgumentException |
Not a valid file for AXM import (.axm files are valid).
-or-
The provided view is not valid for the options provided.
-or-
Visible layer only option is not false or layers are specified in SetLayerSelection.
-or-
Import levels is only supported in project document or conceptual mass document for AXM import.
-or-
Not all AXM import option settings are valid. For more details, please refer to AXMImportOptions.
-or-
The scale is not valid as a CustomScale for use during import.
-or-
NullOrEmpty
-or-
The view is not printable.
|
ArgumentNullException |
A non-optional argument was null
|
FileArgumentNotFoundException |
The given file does not exist.
|
InvalidOperationException |
Import is temporarily disabled.
|
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.
|
OptionalFunctionalityNotAvailableException |
The AXM Import/Link module is not available in the installed Revit.
|
See Also