From 77ee0d9b043b4ce92c431a891173aa505e8d0a24 Mon Sep 17 00:00:00 2001
From: "everLEEst(SangHyeon Lee)" <sh10233.lee@samsung.com>
Date: Tue, 21 Jan 2025 21:44:02 +0900
Subject: [PATCH] [NUI] Add markup extension methods for view properties

Add C# MarkUp Extension methods for View Properties.

e.g)
View myView = new ().Size(10f, 10f)
		    .Position(10f, 10f)
		    .Layout(new LienarLayout)
		    .Padding(5f, 5f, 5f, 5f)
		    .BackgroundColor(1f, 1f, 1f, 1f)

Added Properties

- Color
- ImageShadow
- Borderline
- Opacity
- Scale
- Visibility
- Sensitive
- IsEnabled
- ClippingMode
- Layout
- Focusable
- FocusableChildren
- FocusableInTouch
- VoiceInteractionName
- OffScreenRendering

and few getters for UI struct types.
- Color
- BorderlineColor
---
 .../Markup/ViewExtensions.cs                  | 438 +++++++++++++++++-
 1 file changed, 413 insertions(+), 25 deletions(-)

diff --git a/src/Tizen.NUI.Extension/Markup/ViewExtensions.cs b/src/Tizen.NUI.Extension/Markup/ViewExtensions.cs
index 6405f630037..ca46f480a5f 100644
--- a/src/Tizen.NUI.Extension/Markup/ViewExtensions.cs
+++ b/src/Tizen.NUI.Extension/Markup/ViewExtensions.cs
@@ -15,6 +15,7 @@
  *
  */
 using System.ComponentModel;
+using Tizen.NUI;
 using Tizen.NUI.BaseComponents;
 
 namespace Tizen.NUI.Extension
@@ -38,6 +39,56 @@ public static T Self<T>(this T view, out T self) where T : View
             return view;
         }
 
+        /// <summary>
+        /// Sets the color of the view.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="r">The red component.</param>
+        /// <param name="g">The green component.</param>
+        /// <param name="b">The blue component.</param>
+        /// <param name="a">The alpha component.</param>
+        /// <returns>The view itself.</returns>
+        public static T Color<T>(this T view, float r, float g, float b, float a = 1f) where T : View
+        {
+            view.Color = new (r, g, b, a);
+            return view;
+        }
+
+        /// <summary>
+        /// Sets the color of the view.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="value">The value of 0xRRGGBB format.</param>
+        /// <param name="alpha">The alpha value between 0.0 and 1.0.</param>
+        /// <example>
+        /// <code>
+        ///     new UIColor(0xFF0000, 1f); // Solid red
+        ///     new UIColor(0x00FF00, 0.5f) // Half transparent green
+        /// </code>
+        /// </example>
+        /// <returns>The view itself.</returns>
+        public static T Color<T>(this T view, uint value, float alpha) where T : View
+        {
+            view.Color = (new UIColor(value, alpha)).ToReferenceType();
+            return view;
+        }
+
+        /// <summary>
+        /// Sets the color of the view.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="color">The color value.</param>
+        /// <returns>The view itself.</returns>
+        public static T Color<T>(this T view, UIColor color) where T : View
+        {
+            //FIXME: we need to set UI value type directly without converting reference value.
+            view.Color = color.ToReferenceType();
+            return view;
+        }
+
         /// <summary>
         /// Sets the background color of the view.
         /// </summary>
@@ -60,6 +111,12 @@ public static T BackgroundColor<T>(this T view, float r, float g, float b, float
         /// <param name="view">The extension target.</param>
         /// <param name="value">The value of 0xRRGGBB format.</param>
         /// <param name="alpha">The alpha value between 0.0 and 1.0.</param>
+        /// <example>
+        /// <code>
+        ///     new UIColor(0xFF0000, 1f); // Solid red
+        ///     new UIColor(0x00FF00, 0.5f) // Half transparent green
+        /// </code>
+        /// </example>
         /// <returns>The view itself.</returns>
         public static T BackgroundColor<T>(this T view, uint value, float alpha) where T : View
         {
@@ -79,16 +136,6 @@ public static T BackgroundColor<T>(this T view, UIColor color) where T : View
             return view;
         }
 
-        /// <summary>
-        /// Experimental getter for background color
-        /// </summary>
-        /// <param name="view">The extension target.</param>
-        /// <returns>The background color value.</returns>
-        public static UIColor BackgroundColor(this View view)
-        {
-            return Object.InternalRetrievingVisualPropertyColor(view.SwigCPtr, View.Property.BACKGROUND, ColorVisualProperty.MixColor);
-        }
-
         /// <summary>
         /// Sets the background image of the view.
         /// </summary>
@@ -96,7 +143,7 @@ public static UIColor BackgroundColor(this View view)
         /// <param name="view">The extension target.</param>
         /// <param name="url">The resource url.</param>
         /// <returns>The view itself.</returns>
-        public static TView BackgroundImage<TView>(this TView view, string url) where TView : View
+        public static T BackgroundImage<T>(this T view, string url) where T : View
         {
             view.BackgroundImage = url;
             return view;
@@ -229,19 +276,6 @@ public static T CornerRadius<T>(this T view, UICorner corner, bool isRelative =
             return view;
         }
 
-        /// <summary>
-        /// Gets the corner radius of the view.
-        /// </summary>
-        /// <typeparam name="T">The type of the view.</typeparam>
-        /// <param name="view">The extension target.</param>
-        /// <returns>The corner radius value.</returns>
-        public static UICorner CornerRadius(this View view)
-        {
-            // TODO Do not use Vector4 here
-            var corner = view.CornerRadius;
-            return new UICorner(corner.X, corner.Y, corner.Z, corner.W);
-        }
-
         /// <summary>
         /// Sets the box shadow of the view.
         /// </summary>
@@ -253,7 +287,7 @@ public static UICorner CornerRadius(this View view)
         /// <returns>The view itself.</returns>
         public static T BoxShadow<T>(this T view, float blurRadius, float offsetX = 0, float offsetY = 0) where T : View
         {
-            return view.BoxShadow(new UIShadow(blurRadius));
+            return view.BoxShadow(new UIShadow(blurRadius, offsetX, offsetY));
         }
 
         /// <summary>
@@ -283,5 +317,359 @@ public static T BoxShadow<T>(this T view, UIShadow shadow) where T : View
             view.SetBoxShadow(shadow);
             return view;
         }
+
+        /// <summary>
+        /// Sets the image shadow of the view.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="shadow">The image shadow value.</param>
+        /// <returns>The view itself.</returns>
+        public static T ImageShadow<T>(this T view, ImageShadow shadow) where T : View
+        {
+            view.ImageShadow = shadow;
+            return view;
+        }
+
+        /// <summary>
+        /// Sets the width for the borderline of the View.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="width">The width value.</param>
+        /// <returns>The view itself.</returns>
+        public static T BorderlineWidth<T>(this T view, float width) where T : View
+        {
+            view.BorderlineWidth = width;
+            return view;
+        }
+
+        /// <summary>
+        /// Sets the color for the borderline of the View.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="r">The red component.</param>
+        /// <param name="g">The green component.</param>
+        /// <param name="b">The blue component.</param>
+        /// <param name="a">The alpha component.</param>
+        /// <returns>The view itself.</returns>
+        public static T BorderlineColor<T>(this T view, float r, float g, float b, float a = 1f) where T : View
+        {
+            view.BorderlineColor = new (r, g, b, a);
+            return view;
+        }
+
+        /// <summary>
+        /// Sets the color for the borderline of the View.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="value">The value of 0xRRGGBB format.</param>
+        /// <param name="alpha">The alpha value between 0.0 and 1.0.</param>
+        /// <example>
+        /// <code>
+        ///     new UIColor(0xFF0000, 1f); // Solid red
+        ///     new UIColor(0x00FF00, 0.5f) // Half transparent green
+        /// </code>
+        /// </example>
+        /// <returns>The view itself.</returns>
+        public static T BorderlineColor<T>(this T view, uint value, float alpha) where T : View
+        {
+            view.BorderlineColor = (new UIColor(value, alpha)).ToReferenceType();
+            return view;
+        }
+
+
+        /// <summary>
+        /// Sets the color for the borderline of the View.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="color">The color value.</param>
+        /// <returns>The view itself.</returns>
+        public static T BorderlineColor<T>(this T view, UIColor color) where T : View
+        {
+            //FIXME: we need to set UI value type directly without converting reference value.
+            view.BorderlineColor = color.ToReferenceType();
+            return view;
+        }
+
+        /// <summary>
+        /// Sets the offset for the borderline of the View.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="offset">The offset value.</param>
+        /// <returns>The view itself.</returns>
+        public static T BorderlineOffset<T>(this T view, float offset) where T : View
+        {
+            view.BorderlineOffset = offset;
+            return view;
+        }
+
+        /// <summary>
+        /// Sets the borderline of the View.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="width">The width value.</param>
+        /// <param name="color">The color value.</param>
+        /// <param name="offset">The offset value.</param>
+        /// <returns>The view itself.</returns>
+        public static T Borderline<T>(this T view, float width, UIColor color, float offset) where T : View
+        {
+            view.BorderlineWidth = width;
+            //FIXME: we need to set UI value type directly without converting reference value.
+            view.BorderlineColor = color.ToReferenceType();
+            view.BorderlineOffset = offset;
+            return view;
+        }
+
+        /// <summary>
+        /// Sets the view's opacity
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="opacity">The opacity value.</param>
+        /// <returns>The view itself.</returns>
+        public static T Opacity<T>(this T view, float opacity) where T : View
+        {
+            view.Opacity = opacity;
+            return view;
+        }
+
+        /// <summary>
+        /// Sets the scale X factor applied to the view.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="scale">The scale value.</param>
+        /// <returns>The view itself.</returns>
+        public static T ScaleX<T>(this T view, float scale) where T : View
+        {
+            view.ScaleX = scale;
+            return view;
+        }
+
+        /// <summary>
+        /// Sets the scale Y factor applied to the view.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="scale">The scale value.</param>
+        /// <returns>The view itself.</returns>
+        public static T ScaleY<T>(this T view, float scale) where T : View
+        {
+            view.ScaleY = scale;
+            return view;
+        }
+
+        /// <summary>
+        /// Sets the scale factor applied to the view.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="scaleX">The scale x value.</param>
+        /// <param name="scaleY">The scale y value.</param>
+        /// <returns>The view itself.</returns>
+        public static T Scale<T>(this T view, float scaleX, float scaleY) where T : View
+        {
+            view.ScaleX = scaleX;
+            view.ScaleY = scaleY;
+            return view;
+        }
+
+        /// <summary>
+        /// Sets the visibility of the view.
+        /// <see cref="Tizen.NUI.BaseComponents.View.Visibility"/>
+        /// <seealso cref="Tizen.NUI.BaseComponents.View.Show()"/>
+        /// <seealso cref="Tizen.NUI.BaseComponents.View.Hide()"/>
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="visiblity">The visibility value.</param>
+        /// <returns>The view itself.</returns>
+        public static T Visibility<T>(this T view, bool visiblity) where T : View
+        {
+            if (view.Visibility != visiblity)
+            {
+                if (visiblity)
+                {
+                    view.Show();
+                }
+                else
+                {
+                    view.Hide();
+                }
+            }
+            return view;
+        }
+
+        /// <summary>
+        /// Sets the status of whether the view should emit touch or hover signals.
+        /// If a View is made insensitive, then the View and its children are not hittable.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="sensitive">The sensitive value.</param>
+        /// <returns>The view itself.</returns>
+        public static T Sensitive<T>(this T view, bool sensitive) where T : View
+        {
+            view.Sensitive = sensitive;
+            return view;
+        }
+
+        /// <summary>
+        /// Sets the status of whether the view should be enabled user interactions.
+        /// If a View is made disabled, then user interactions including touch, focus, and actiavation is disabled.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="enable">The enable value.</param>
+        /// <returns>The view itself.</returns>
+        public static T IsEnabled<T>(this T view, bool enable) where T : View
+        {
+            view.IsEnabled = enable;
+            return view;
+        }
+
+        /// <summary>
+        /// Sets the clipping behavior (mode) of it's children.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="type">The clipping mode type value.</param>
+        /// <returns>The view itself.</returns>
+        public static T ClippingMode<T>(this T view, ClippingModeType type) where T : View
+        {
+            view.ClippingMode = type;
+            return view;
+        }
+
+        /// <summary>
+        /// Set the layout on this View. Replaces any existing Layout.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="layout">The layout for the view.</param>
+        /// <returns>The view itself.</returns>
+        public static T Layout<T>(this T view, LayoutItem layout) where T : View
+        {
+            view.Layout = layout;
+            return view;
+        }
+
+        /// <summary>
+        /// Sets focusable of the view
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="focusable">The focusable value.</param>
+        /// <returns>The view itself.</returns>
+        public static T Focusable<T>(this T view, bool focusable) where T : View
+        {
+            view.Focusable = focusable;
+            return view;
+        }
+
+        /// <summary>
+        /// Sets whether the children of this view can be focusable by keyboard navigation.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="focusable">The focusable value.</param>
+        /// <returns>The view itself.</returns>
+        public static T FocusableChildren<T>(this T view, bool focusable) where T : View
+        {
+            view.FocusableChildren = focusable;
+            return view;
+        }
+
+        /// <summary>
+        /// Sets whether the view can focus by touch.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="focusable">The focusable value.</param>
+        /// <returns>The view itself.</returns>
+        public static T FocusableInTouch<T>(this T view, bool focusable) where T : View
+        {
+            view.FocusableInTouch = focusable;
+            return view;
+        }
+
+        /// <summary>
+        /// Set voice interaction name for Voice Touch.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="name">The name value.</param>
+        /// <returns>The view itself.</returns>
+        public static T VoiceInteractionName<T>(this T view, string name) where T : View
+        {
+            view.VoiceInteractionName = name;
+            return view;
+        }
+
+        /// <summary>
+        /// Set the current offscreen rendering type of the view.
+        /// </summary>
+        /// <typeparam name="T">The type of the view.</typeparam>
+        /// <param name="view">The extension target.</param>
+        /// <param name="type">The offscreen type value.</param>
+        /// <returns>The view itself.</returns>
+        public static T OffScreenRendering<T>(this T view, View.OffScreenRenderingType type) where T : View
+        {
+            view.OffScreenRendering = type;
+            return view;
+        }
+
+/* Getters */
+
+        /// <summary>
+        /// Gets the color for the View.
+        /// </summary>
+        /// <param name="view">The extension target.</param>
+        /// <returns>The color value.</returns>
+        public static UIColor Color(this View view)
+        {
+            //FIXME: we need to set UI value type directly without converting reference value.
+            return new UIColor(view.Color);
+        }
+
+        /// <summary>
+        /// Experimental getter for background color
+        /// </summary>
+        /// <param name="view">The extension target.</param>
+        /// <returns>The background color value.</returns>
+        public static UIColor BackgroundColor(this View view)
+        {
+            return Object.InternalRetrievingVisualPropertyColor(view.SwigCPtr, View.Property.BACKGROUND, ColorVisualProperty.MixColor);
+        }
+
+        /// <summary>
+        /// Gets the corner radius of the view.
+        /// </summary>
+        /// <param name="view">The extension target.</param>
+        /// <returns>The corner radius value.</returns>
+        public static UICorner CornerRadius(this View view)
+        {
+            // TODO Do not use Vector4 here
+            var corner = view.CornerRadius;
+            return new UICorner(corner.X, corner.Y, corner.Z, corner.W);
+        }
+
+        /// <summary>
+        /// Gets the color for the borderline of the View.
+        /// </summary>
+        /// <param name="view">The extension target.</param>
+        /// <returns>The borderline color value.</returns>
+        public static UIColor BorderlineColor(this View view)
+        {
+            //FIXME: we need to set UI value type directly without converting reference value.
+            return new UIColor(view.BorderlineColor);
+        }
+
     }
 }