UIElement.TransformMatrix Property


Gets or sets the transformation matrix to apply to the element.

Equivalent WinUI property: Microsoft.UI.Xaml.UIElement.TransformMatrix.

 property float4x4 TransformMatrix { float4x4 get(); void set(float4x4 value); };
float4x4 TransformMatrix();

void TransformMatrix(float4x4 value);
public Matrix4x4 TransformMatrix { get; set; }
var matrix4x4 = uIElement.transformMatrix;
uIElement.transformMatrix = matrix4x4;
Public Property TransformMatrix As Matrix4x4

Property Value


The transformation matrix to apply to the element.

Windows 10 requirements

Device family
Windows 10, version 1809 (introduced in 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v7.0)


This property is not compatible with ElementCompositionPreview.GetElementVisual. Attempting to use TransformMatrix after calling GetElementVisual will fail with the following error:

Access denied. Calling TransformMatrix API is not allowed on this object at this time, as this object currently has the ElementCompositionPreview.GetElementVisual property in use.

Applies to