ElementTransformUtilsMoveElement Method

Moves one element by a given transformation.

Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 27.0.4.0 (27.0.4.0)

Syntax

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
)

static member MoveElement : 
        document : Document * 
        elementToMove : ElementId * 
        translation : XYZ -> unit

Parameters

document Document: The document that owns the elements.
elementToMove ElementId: The id of the element to move.
translation XYZ: The translation vector for the elements.

Exceptions

Exception	Condition
ArgumentException	The element elementToMove does not exist in the document
ArgumentNullException	A non-optional argument was null
InvalidOperationException	If we are not able to move the element (for example, if it is pinned). -or- Move operation failed.

Example

Copy

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);
}

Reference

ElementTransformUtils Class

Autodesk.Revit.DB Namespace