[ACR-564] deprecate unused API

[platform/core/csapi/tizenfx.git] / src / ElmSharp / ElmSharp / Background.cs

diff --git a/src/ElmSharp/ElmSharp/Background.cs b/src/ElmSharp/ElmSharp/Background.cs
index e5348b0..045629c 100644 (file)
--- a/src/ElmSharp/ElmSharp/Background.cs
+++ b/src/ElmSharp/ElmSharp/Background.cs
@@ -22,50 +22,43 @@ namespace ElmSharp
     /// The Background is a widget that use for setting (solid) background decorations to a window (unless it has transparency enabled)
     /// or to any container object.
     /// </summary>
+    /// <since_tizen> preview </since_tizen>
+    [Obsolete("This has been deprecated in API12")]
     public class Background : Layout
     {
         /// <summary>
         /// Creates and initializes a new instance of the Background class.
         /// </summary>
-        /// <param name="parent">The EvasObject to which the new Background will be attached as a child.</param>
+        /// <param name="parent">The EvasObject to which the new background will be attached as a child.</param>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public Background(EvasObject parent) : base(parent)
         {
             Style = "transparent";
         }
 
         /// <summary>
-        /// Sets or gets color to Background.
+        /// Sets or gets the color to the background.
         /// </summary>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public override Color Color
         {
             get
             {
-                int r = 0;
-                int g = 0;
-                int b = 0;
-                int a = 0;
-                var swallowContent = GetPartContent("elm.swallow.rectangle");
-                if (swallowContent != IntPtr.Zero)
-                {
-                    Interop.Evas.evas_object_color_get(swallowContent, out r, out g, out b, out a);
-                }
-                return new Color(r, g, b, a);
+                return BackgroundColor;
             }
             set
             {
-                var swallowContent = GetPartContent("elm.swallow.rectangle");
-                if (swallowContent == IntPtr.Zero)
-                {
-                    Interop.Elementary.elm_bg_color_set(RealHandle, value.R, value.G, value.B);
-                    swallowContent = GetPartContent("elm.swallow.rectangle");
-                }
-                Interop.Evas.evas_object_color_set(swallowContent, value.R, value.G, value.B, value.A);
+                BackgroundColor = value;
             }
         }
 
         /// <summary>
-        /// Sets or gets image to Background.
+        /// Sets or gets the image to the background.
         /// </summary>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public string File
         {
             get
@@ -83,9 +76,11 @@ namespace ElmSharp
         /// </summary>
         /// <remarks>
         /// This sets how the background widget will display its image.
-        /// This will only work if the File was previously set with an image file on obj.
-        /// The image can be display tiled, scaled, centered or stretched. scaled by default.
+        /// This will only work if the file was previously set with an image file on object.
+        /// The image can be display tiled, scaled, centered, or stretched. Scaled by default.
         /// </remarks>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public BackgroundOptions BackgroundOption
         {
             get
@@ -99,13 +94,15 @@ namespace ElmSharp
         }
 
         /// <summary>
-        /// Set the size of the pixmap representation of the image set on a given background widget.
+        /// Sets the size of the pixmap representation of the image set on a given background widget.
         /// This method just makes sense if an image file was set.
         /// This is just a hint for the underlying system.
         /// The real size of the pixmap may differ depending on the type of image being loaded, being bigger than requested.
         /// </summary>
         /// <param name="w">The new width of the image pixmap representation.</param>
         /// <param name="h">The new height of the image pixmap representation.</param>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public void SetFileLoadSize(int w, int h)
         {
             if (File != null)
@@ -114,34 +111,37 @@ namespace ElmSharp
             }
             else
             {
-                throw new Exception("This method just makes sense if an image file was set.");
+                throw new InvalidOperationException("This method just makes sense if an image file was set.");
             }
         }
 
+        /// <summary>
+        /// Creates a widget handle.
+        /// </summary>
+        /// <param name="parent">Parent EvasObject.</param>
+        /// <returns>Handle IntPtr.</returns>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         protected override IntPtr CreateHandle(EvasObject parent)
         {
-            IntPtr handle = Interop.Elementary.elm_layout_add(parent.Handle);
-            Interop.Elementary.elm_layout_theme_set(handle, "layout", "elm_widget", "default");
-
-            RealHandle = Interop.Elementary.elm_bg_add(handle);
-            Interop.Elementary.elm_object_part_content_set(handle, "elm.swallow.content", RealHandle);
-
-            return handle;
+            return Interop.Elementary.elm_bg_add(parent.Handle);
         }
     }
 
     /// <summary>
-    /// Enumeration for the background type.
+    /// Enumeration for the background types.
     /// </summary>
+    /// <since_tizen> preview </since_tizen>
+    [Obsolete("This has been deprecated in API12")]
     public enum BackgroundOptions
     {
         /// <summary>
-        /// Centers the background image
+        /// Centers the background image.
         /// </summary>
         Center,
 
         /// <summary>
-        /// Scales the background image, retaining the aspect ratio
+        /// Scales the background image, retaining the aspect ratio.
         /// </summary>
         Scale,
 
@@ -151,8 +151,8 @@ namespace ElmSharp
         Stretch,
 
         /// <summary>
-        /// Tiles the background image at its original size
+        /// Tiles the background image at its original size.
         /// </summary>
         Tile
     }
-}
\ No newline at end of file
+}