M

ElementTransformUtils.MoveElement

Description:
Moves one element by a given transformation.

public static void MoveElement(
	Document document,
	ElementId elementToMove,
	XYZ translation
)

Public Shared Sub MoveElement ( _
	document As Document, _
	elementToMove As ElementId, _
	translation As XYZ _
)

public:
static void MoveElement(
	Document^ document, 
	ElementId^ elementToMove, 
	XYZ^ translation
)

Autodesk.Revit.DB.Document

document

The document that owns the elements.
Autodesk.Revit.DB.ElementId

elementToMove

The id of the element to move.
Autodesk.Revit.DB.XYZ

translation

The translation vector for the elements.

public void MoveColumn(Autodesk.Revit.DB.Document document, FamilyInstance column)
{
    // get the column current location
    LocationPoint columnLocation = column.Location as LocationPoint;

    XYZ oldPlace = columnLocation.Point;

    // Move the column to new location.
    XYZ newPlace = new XYZ(10, 20, 30);
    ElementTransformUtils.MoveElement(document, column.Id, newPlace);

    // now get the column's new location
    columnLocation = column.Location as LocationPoint;
    XYZ newActual = columnLocation.Point;

    string info = "Original Z location: " + oldPlace.Z +
                  "\nNew Z location: " + newActual.Z;

    TaskDialog.Show("Revit",info);
}

Public Sub MoveColumn(document As Autodesk.Revit.DB.Document, column As FamilyInstance)
    ' get the column current location
    Dim columnLocation As LocationPoint = TryCast(column.Location, LocationPoint)

    Dim oldPlace As XYZ = columnLocation.Point

    ' Move the column to new location.
    Dim newPlace As New XYZ(10, 20, 30)
    ElementTransformUtils.MoveElement(document, column.Id, newPlace)

    ' now get the column's new location
    columnLocation = TryCast(column.Location, LocationPoint)
    Dim newActual As XYZ = columnLocation.Point

    Dim info As String = ("Original Z location: " + oldPlace.Z & vbLf & "New Z location: ") + newActual.Z

    TaskDialog.Show("Revit", info)
End Sub

Autodesk.Revit.Exceptions.ArgumentException

The element elementToMove does not exist in the document
Autodesk.Revit.Exceptions.ArgumentNullException

A non-optional argument was null
Autodesk.Revit.Exceptions.InvalidOperationException

If we are not able to move the element (for example, if it is pinned). -or- Move operation failed.