[ACR-564] deprecate unused API
[platform/core/csapi/tizenfx.git] / src / ElmSharp / ElmSharp / Slider.cs
old mode 100755 (executable)
new mode 100644 (file)
index 41fb507..fd354aa
@@ -21,10 +21,12 @@ namespace ElmSharp
     /// <summary>
     /// Enumeration for the Slider's indicator visiblity mode.
     /// </summary>
+    /// <since_tizen> preview </since_tizen>
+    [Obsolete("This has been deprecated in API12")]
     public enum SliderIndicatorVisibleMode
     {
         /// <summary>
-        /// Show indicator on mouse down or change in slider value.
+        /// Shows the indicator on mouse down or change in the slider value.
         /// </summary>
         Default,
 
@@ -47,6 +49,8 @@ namespace ElmSharp
     /// <summary>
     /// The Slider is a widget that adds a draggable slider widget for selecting the value of something within a range.
     /// </summary>
+    /// <since_tizen> preview </since_tizen>
+    [Obsolete("This has been deprecated in API12")]
     public class Slider : Layout
     {
         double _minimum = 0.0;
@@ -60,7 +64,9 @@ namespace ElmSharp
         /// <summary>
         /// Creates and initializes a new instance of the Slider class.
         /// </summary>
-        /// <param name="parent">The <see cref="EvasObject"/> to which the new Slider will be attached as a child.</param>
+        /// <param name="parent">The <see cref="EvasObject"/> to which the new slider will be attached as a child.</param>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public Slider(EvasObject parent) : base(parent)
         {
             _changed = new SmartEvent(this, this.RealHandle, "changed");
@@ -79,6 +85,8 @@ namespace ElmSharp
         /// <summary>
         /// ValueChanged will be triggered when the Slider value is changed by the user.
         /// </summary>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public event EventHandler ValueChanged;
 
         /// <summary>
@@ -86,16 +94,22 @@ namespace ElmSharp
         /// This will be called only when the user stops dragging for a very short period or when they release their finger/mouse,
         /// so it avoids possibly expensive reactions to the value change.
         /// </summary>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public event EventHandler DelayedValueChanged;
 
         /// <summary>
         /// DragStarted will be triggered when dragging the Slider indicator around has started.
         /// </summary>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public event EventHandler DragStarted;
 
         /// <summary>
         /// DragStopped will be triggered when dragging the Slider indicator around has stopped.
         /// </summary>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public event EventHandler DragStopped;
 
         /// <summary>
@@ -103,10 +117,12 @@ namespace ElmSharp
         /// </summary>
         /// <remarks>
         /// This sets the minimum width (when in the horizontal mode) or height (when in the vertical mode)
-        /// of the actual bar area of the slider obj. This in turn affects the object's minimum size.
+        /// of the actual bar area of the slider object. This in turn affects the object's minimum size.
         /// Use this when you're not setting other size hints expanding on the given direction
         /// (like weight and alignment hints), and you would like it to have a specific size.
         /// </remarks>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public int SpanSize
         {
             get
@@ -125,12 +141,14 @@ namespace ElmSharp
         /// <remarks>
         /// The slider may display its value somewhere other than the unit label,
         /// for example, above the slider knob that is dragged around. This function sets the format string
-        /// used for this.If NULL, the indicator label won't be visible. If not, it sets the format string
+        /// used for this. If null, the indicator label won't be visible. If not, it sets the format string
         /// for the label text. For the label text floating point value is provided, so the label text can
-        /// display up to 1 floating point value. Note that this is optional.Use a format string
+        /// display up to 1 floating point value. Note that this is optional. Use a format string
         /// such as "%1.2f meters" for example, and it displays values like: "3.14 meters" for a value
-        /// equal to 3.14159.By default, the indicator label is disabled.
+        /// equal to 3.14159. By default, the indicator label is disabled.
         /// </remarks>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public string IndicatorFormat
         {
             get
@@ -147,8 +165,10 @@ namespace ElmSharp
         /// Sets or gets the orientation of a given slider widget.
         /// </summary>
         /// <remarks>
-        /// The orientation may be vertically or horizontally.By default, it's displayed horizontally.
+        /// The orientation may be vertical or horizontal. By default, it's displayed horizontally.
         /// </remarks>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public bool IsHorizontal
         {
             get
@@ -167,8 +187,10 @@ namespace ElmSharp
         /// <remarks>
         /// This defines the allowed minimum values to be selected by the user.
         /// If the actual value is less than min, it is updated to min.
-        /// Actual value can be obtained with Value.By default, min is equal to 0.0.
+        /// Actual value can be obtained with value. By default, the minimum is equal to 0.0.
         /// </remarks>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public double Minimum
         {
             get
@@ -188,9 +210,11 @@ namespace ElmSharp
         /// <remarks>
         /// This defines the allowed maximum values to be selected by the user.
         /// If the actual value is bigger then max, it is updated to max.
-        /// Actual value can be obtained with Value.By default, min is equal to 0.0, and max is equal to 1.0.
+        /// Actual value can be obtained with value. By default, minimum is equal to 0.0 and maximum is equal to 1.0.
         /// Maximum must be greater than minimum, otherwise the behavior is undefined.
         /// </remarks>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public double Maximum
         {
             get
@@ -209,8 +233,10 @@ namespace ElmSharp
         /// </summary>
         /// <remarks>
         /// Value will be presented on the unit label following format specified with UnitFormat and
-        /// on indicator with IndicatorFormat.The value must to be between Minimum and Maximum values.
+        /// on indicator with IndicatorFormat. The value must be between minimum and maximum values.
         /// </remarks>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public double Value
         {
             get
@@ -229,9 +255,11 @@ namespace ElmSharp
         /// <remarks>
         /// This value is used when the draggable object is moved automatically i.e.,
         /// in case of a key event when up/down/left/right key is pressed or in case accessibility
-        /// is set and the flick event is used to inc/dec slider values.
+        /// is set and the flick event is used to increase or decrease the slider values.
         /// By default, the step value is equal to 0.05.
         /// </remarks>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public double Step
         {
             get
@@ -249,10 +277,12 @@ namespace ElmSharp
         /// </summary>
         /// <remarks>
         /// A slider may be inverted, in which case it gets its values inverted,
-        /// with high values being on the left or top and low values on the right or bottom,
+        /// with high values being on the left or top, and low values on the right or bottom,
         /// as opposed to normally have the low values on the former and high values on the latter,
         /// respectively, for the horizontal and vertical modes.
         /// </remarks>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public bool IsInverted
         {
             get
@@ -270,8 +300,10 @@ namespace ElmSharp
         /// </summary>
         /// <remarks>
         /// By default, the indicator is bigger when dragged by the user.
-        /// It won't display values set with IndicatorFormat if you disable the indicator.
+        /// It won't display the values set with IndicatorFormat if you disable the indicator.
         /// </remarks>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public bool IsIndicatorVisible
         {
             get
@@ -285,8 +317,10 @@ namespace ElmSharp
         }
 
         /// <summary>
-        /// Sets or gets the visible mode of slider indicator.
+        /// Sets or gets the visible mode of the slider indicator.
         /// </summary>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public SliderIndicatorVisibleMode IndicatorVisibleMode
         {
             get
@@ -300,8 +334,10 @@ namespace ElmSharp
         }
 
         /// <summary>
-        /// Sets or gets whether to Show the indicator of slider on focus.
+        /// Sets or gets whether to show the indicator of a slider on focus.
         /// </summary>
+        /// <since_tizen> preview </since_tizen>
+        [Obsolete("This has been deprecated in API12")]
         public bool IsIndicatorFocusable
         {
             get
@@ -314,6 +350,13 @@ namespace ElmSharp
             }
         }
 
+        /// <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);