[ACR-564] deprecate unused API

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

diff --git a/src/ElmSharp/ElmSharp/FlipSelector.cs b/src/ElmSharp/ElmSharp/FlipSelector.cs
old mode 100755 (executable)
new mode 100644 (file)
index 58db381..b2d53c2
--- a/src/ElmSharp/ElmSharp/FlipSelector.cs
+++ b/src/ElmSharp/ElmSharp/FlipSelector.cs
@@ -20,8 +20,10 @@ using System.Collections.Generic;
 namespace ElmSharp
 {
     /// <summary>
-    /// A flip selector is a widget to show a set of text items,one at a time.with the same sheet switching style as the clock widget, when one changes the current displaying sheet.
+    /// The FlipSelector is a widget to show a set of text items, one at a time, with the same sheet switching style as the clock widget when one changes the current displaying sheet.
     /// </summary>
+    /// <since_tizen> preview </since_tizen>
+    [Obsolete("This has been deprecated in API12")]
     public class FlipSelector : Layout
     {
         SmartEvent _selected;
@@ -31,7 +33,9 @@ namespace ElmSharp
         /// <summary>
         /// Creates and initializes a new instance of the FlipSelector.
         /// </summary>
-        /// <param name="parent">Parent EvasObject </param>
+        /// <param name="parent">Parent EvasObject.</param>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public FlipSelector(EvasObject parent) : base(parent)
         {
             _selected = new SmartEvent(this, Handle, "selected");
@@ -44,21 +48,29 @@ namespace ElmSharp
         }
 
         /// <summary>
-        /// Selected will be triggered when be Selected
+        /// Selected will be triggered when selected.
         /// </summary>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public event EventHandler Selected;
         /// <summary>
-        /// Overflowed will be triggered when Overflowed
+        /// Overflowed will be triggered when overflowed.
         /// </summary>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public event EventHandler Overflowed;
         /// <summary>
-        /// Underflowed will be triggered when be Underflowed
+        /// Underflowed will be triggered when underflowed.
         /// </summary>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public event EventHandler Underflowed;
 
         /// <summary>
-        ///  Sets or gets the interval on time updates for an user mouse button hold on a flip selector widget.
+        /// Sets or gets the interval on time updates for a user mouse button to hold on the flip selector widget.
         /// </summary>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public double Interval
         {
             get
@@ -73,8 +85,10 @@ namespace ElmSharp
 
 
         /// <summary>
-        /// Gets the currently selected item in a flip selector widget.
+        /// Gets the currently selected item in the flip selector widget.
         /// </summary>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public FlipSelectorItem SelectedItem
         {
             get
@@ -87,6 +101,8 @@ namespace ElmSharp
         /// <summary>
         /// Gets the first item in the given flip selector widget's list of items.
         /// </summary>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public FlipSelectorItem FirstItem
         {
             get
@@ -99,6 +115,8 @@ namespace ElmSharp
         /// <summary>
         /// Gets the last item in the given flip selector widget's list of items.
         /// </summary>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public FlipSelectorItem LastItem
         {
             get
@@ -109,33 +127,37 @@ namespace ElmSharp
         }
 
         /// <summary>
-        /// Appends a (text) item to a flip selector widget.
+        /// Appends the (text) item to the flip selector widget.
         /// </summary>
         /// <param name="text">text value</param>
         /// <returns>
-        /// A handle to the item added or NULL, on errors
+        /// A handle to the item added, or null on errors.
         /// </returns>
         /// <remarks>
-        /// The widget's list of labels to show will be appended with the given value. If the user wishes so, a callback function pointer can be passed, which will get called when this same item is selected.
+        /// The widget's list of labels to show will be appended with the given value. If the user wishes so, a callback function pointer can be passed, which will get called when the same item is selected.
         /// </remarks>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public FlipSelectorItem Append(string text)
         {
-            FlipSelectorItem item = new FlipSelectorItem(text);
+            FlipSelectorItem item = new FlipSelectorItem(text, this);
             item.Handle = Interop.Elementary.elm_flipselector_item_append(Handle, text, null, (IntPtr)item.Id);
             return item;
         }
 
         /// <summary>
-        /// Prepend a (text) item to a flip selector widget.
+        /// Prepends the (text) item to a flip selector widget.
         /// </summary>
         /// <param name="text">Prepend text</param>
-        /// <returns>A handle to the item added or NULL, on errors</returns>
+        /// <returns>A handle to the item added, or null on errors.</returns>
         /// <remarks>
-        /// The widget's list of labels to show will be prepended with the given value. If the user wishes so, a callback function pointer can be passed, which will get called when this same item is selected.
+        /// The widget's list of labels to show will be prepended with the given value. If the user wishes so, a callback function pointer can be passed, which will get called when the same item is selected.
         /// </remarks>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public FlipSelectorItem Prepend(string text)
         {
-            FlipSelectorItem item = new FlipSelectorItem(text);
+            FlipSelectorItem item = new FlipSelectorItem(text, this);
             item.Handle = Interop.Elementary.elm_flipselector_item_prepend(Handle, text, null, (IntPtr)item.Id);
             return item;
         }
@@ -143,27 +165,33 @@ namespace ElmSharp
         /// <summary>
         /// To remove the given item.
         /// </summary>
-        /// <param name="item">FlipSelector's item</param>
+        /// <param name="item">FlipSelector's item.</param>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public void Remove(FlipSelectorItem item)
         {
-            if (item as FlipSelectorItem != null)
+            if (item != null)
                 item.Delete();
         }
 
         /// <summary>
-        /// Programmatically select the next item of a flip selector widget.
+        /// Programmatically select the next item of the flip selector widget.
         /// </summary>
         /// <remarks>
         /// The selection will be animated. Also, if it reaches the beginning of its list of member items, it will continue with the last one backwards.
         /// </remarks>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public void Next()
         {
             Interop.Elementary.elm_flipselector_flip_next(Handle);
         }
 
         /// <summary>
-        /// Programmatically select the previous item of a flip selector widget.
+        /// Programmatically select the previous item of the flip selector widget.
         /// </summary>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public void Prev()
         {
             Interop.Elementary.elm_flipselector_flip_prev(Handle);
@@ -172,8 +200,10 @@ namespace ElmSharp
         /// <summary>
         /// Creates a widget handle.
         /// </summary>
-        /// <param name="parent">Parent EvasObject</param>
-        /// <returns>Handle IntPtr</returns>
+        /// <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)
         {
             return Interop.Elementary.elm_flipselector_add(parent.Handle);