Added VisualExtensions.Translation property

Author: Sergio0694

Microsoft.Toolkit.Uwp.UI/Extensions/VisualExtensions.cs

@@ -114,6 +114,36 @@ public static void SetOffset(DependencyObject obj, string value)
             obj.SetValue(OffsetProperty, value);
         }
 
+        /// <summary>
+        /// Gets the <see cref="Visual.TransformMatrix"/>.<see cref="Matrix4x4.Translation"/> property of a <see cref="UIElement"/> in a <see cref="string"/> form.
+        /// </summary>
+        /// <param name="obj">The <see cref="DependencyObject"/> instance.</param>
+        /// <returns>A <see cref="Vector3"/> <see cref="string"/> representation of the <see cref="Visual.TransformMatrix"/>.<see cref="Matrix4x4.Translation"/> property.</returns>
+        public static string GetTranslation(DependencyObject obj)
+        {
+            if (!DesignTimeHelpers.IsRunningInLegacyDesignerMode && obj is UIElement element)
+            {
+                return GetTranslationForElement(element);
+            }
+
+            return (string)obj.GetValue(TranslationProperty);
+        }
+
+        /// <summary>
+        /// Sets the <see cref="Visual.TransformMatrix"/>.<see cref="Matrix4x4.Translation"/> property of a <see cref="UIElement"/> in a <see cref="string"/> form.
+        /// </summary>
+        /// <param name="obj">The <see cref="DependencyObject"/> instance.</param>
+        /// <param name="value">The <see cref="string"/> representation of the <see cref="Vector3"/> to be set.</param>
+        public static void SetTranslation(DependencyObject obj, string value)
+        {
+            if (!DesignTimeHelpers.IsRunningInLegacyDesignerMode && obj is UIElement element)
+            {
+                SetTranslationForElement(value, element);
+            }
+
+            obj.SetValue(TranslationProperty, value);
+        }
+
         /// <summary>
         /// Gets the <see cref="Visual.Opacity"/> of a UIElement
         /// </summary>
@@ -334,6 +364,12 @@ public static void SetNormalizedCenterPoint(DependencyObject obj, string value)
         public static readonly DependencyProperty OffsetProperty =
             DependencyProperty.RegisterAttached("Offset", typeof(string), typeof(VisualExtensions), new PropertyMetadata(null, OnOffsetChanged));
 
+        /// <summary>
+        /// Identifies the Translation attached property.
+        /// </summary>
+        public static readonly DependencyProperty TranslationProperty =
+            DependencyProperty.RegisterAttached("Translation", typeof(string), typeof(VisualExtensions), new PropertyMetadata(null, OnTranslationChanged));
+
         /// <summary>
         /// Identifies the Opacity attached property.
         /// </summary>
@@ -400,6 +436,14 @@ private static void OnOffsetChanged(DependencyObject d, DependencyPropertyChange
             }
         }
 
+        private static void OnTranslationChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
+        {
+            if (e.NewValue is string str)
+            {
+                SetTranslation(d, str);
+            }
+        }
+
         private static void OnOpacityChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
         {
             if (e.NewValue is double dbl)
@@ -503,6 +547,23 @@ private static void SetOffsetForElement(string value, UIElement element)
             visual.Offset = value.ToVector3();
         }
 
+        private static string GetTranslationForElement(UIElement element)
+        {
+            return GetVisual(element).TransformMatrix.Translation.ToString();
+        }
+
+        private static void SetTranslationForElement(string value, UIElement element)
+        {
+            ElementCompositionPreview.SetIsTranslationEnabled(element, true);
+
+            Visual visual = GetVisual(element);
+            Matrix4x4 transform = visual.TransformMatrix;
+
+            transform.Translation = value.ToVector3();
+
+            visual.TransformMatrix = transform;
+        }
+
         private static double GetOpacityForElement(UIElement element)
         {
             var visual = GetVisual(element);