•  

CopyElement Method

Copies an element and places the copy at a location indicated by a given transformation.

Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 24.0.0.0 (24.0.0.0)
Since: 2012

Syntax

C# 
public static ICollection<ElementId> CopyElement(
	Document document,
	ElementId elementToCopy,
	XYZ translation
)
Visual Basic 
Public Shared Function CopyElement ( _
	document As Document, _
	elementToCopy As ElementId, _
	translation As XYZ _
) As ICollection(Of ElementId)
Visual C++ 
public:
static ICollection<ElementId^>^ CopyElement(
	Document^ document, 
	ElementId^ elementToCopy, 
	XYZ^ translation
)

Parameters

document
Type: Autodesk.Revit.DB Document
The document that owns the element.
elementToCopy
Type: Autodesk.Revit.DB ElementId
The id of the element to copy.
translation
Type: Autodesk.Revit.DB XYZ
The translation vector for the new element.

Return Value

The ids of the newly created copied elements. More than one element may be created due to dependencies.

Exceptions

Exception Condition
Autodesk.Revit.Exceptions ArgumentException The element elementToCopy does not exist in the document -or- The input element is a Sketch member and there is no Sketch in the edit mode to place this element in.
Autodesk.Revit.Exceptions ArgumentNullException A non-optional argument was null
Autodesk.Revit.Exceptions InvalidOperationException It is not allowed to copy Sketch member to non-parallel sketch. -or- If we are not able to copy the element.

See Also