namespace ElmSharp.Wearable
{
/// <summary>
- /// The Circle DateTime Selector is a widget to display and handle datetime value by rotary event
- /// Inherits <see cref="DateTimeSelector"/>
+ /// The Circle DateTime Selector is a widget to display and handle datetime value by the Rotary event.
+ /// Inherits <see cref="DateTimeSelector"/>.
/// </summary>
/// <since_tizen> preview </since_tizen>
public class CircleDateTimeSelector : DateTimeSelector, IRotaryActionWidget
CircleSurface _surface;
/// <summary>
- /// Creates and initializes a new instance of the Circle DateTime class
+ /// Creates and initializes a new instance of the Circle DateTime class.
/// </summary>
- /// <param name="parent">The parent of new Circle DateTime instance</param>
+ /// <param name="parent">The parent of the new Circle DateTime instance.</param>
/// <param name="surface">The surface for drawing circle features for this widget.</param>
/// <since_tizen> preview </since_tizen>
public CircleDateTimeSelector(EvasObject parent, CircleSurface surface) : base()
/// <summary>
/// Creates and initializes a new instance of the Circle DateTimeSelector class.
/// </summary>
- /// <param name="parent">The parent of new Circle CircleDateTimeSelector instance</param>
+ /// <param name="parent">The parent of the new Circle DateTimeSelector instance.</param>
/// <since_tizen> preview </since_tizen>
[Obsolete("It is not safe for guess circle surface from parent and create new surface by every new widget")]
[EditorBrowsable(EditorBrowsableState.Never)]
}
/// <summary>
- /// Gets the handle for Circle Widget.
+ /// Gets the handle for the Circle widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
public virtual IntPtr CircleHandle => _circleHandle;
/// <summary>
- /// Gets the handle for Circle Surface used in this widget
+ /// Gets the handle for the circle surface used in this widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
public virtual CircleSurface CircleSurface => _surface;
/// <summary>
- /// Sets or gets disabled state of this widget.
+ /// Sets or gets the disabled state of this widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
[Obsolete("Use IsEnabled")]
}
/// <summary>
- /// Sets or gets the color of the marker
+ /// Sets or gets the color of the marker.
/// </summary>
/// <since_tizen> preview </since_tizen>
public Color MarkerColor
}
/// <summary>
- /// Sets or gets the line width of the marker
+ /// Sets or gets the line width of the marker.
/// </summary>
/// <since_tizen> preview </since_tizen>
public int MarkerLineWidth
}
/// <summary>
- /// Sets or gets the radius at which the center of the marker lies
+ /// Sets or gets the radius at which the center of the marker lies.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double MarkerRadius
/// <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>
protected override IntPtr CreateHandle(EvasObject parent)
{
namespace ElmSharp.Wearable
{
/// <summary>
- /// The Circle GenList Selector is a widget to display and handle genlist items by rotary event
- /// Inherits <see cref="GenList"/>
+ /// The Circle GenList Selector is a widget to display and handle the genlist items by the Rotary event.
+ /// Inherits <see cref="GenList"/>.
/// </summary>
/// <since_tizen> preview </since_tizen>
public class CircleGenList : GenList, IRotaryActionWidget
CircleSurface _surface;
/// <summary>
- /// Creates and initializes a new instance of the Circle GenList class
+ /// Creates and initializes a new instance of the Circle GenList class.
/// </summary>
- /// <param name="parent">The parent of new Circle GenList instance</param>
- /// <param name="surface">The surface for drawing circle features for this widget.</param>
+ /// <param name="parent">The parent of the new Circle GenList instance.</param>
+ /// <param name="surface">The surface for drawing the circle features for this widget.</param>
/// <since_tizen> preview </since_tizen>
public CircleGenList(EvasObject parent, CircleSurface surface) : base()
{
/// <summary>
/// Creates and initializes a new instance of the Circle GenList class.
/// </summary>
- /// <param name="parent">The parent of new Circle CircleGenList instance</param>
+ /// <param name="parent">The parent of the new Circle CircleGenList instance.</param>
/// <since_tizen> preview </since_tizen>
[Obsolete("It is not safe for guess circle surface from parent and create new surface by every new widget")]
[EditorBrowsable(EditorBrowsableState.Never)]
}
/// <summary>
- /// Gets the handle for Circle Widget.
+ /// Gets the handle for the Circle widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
public virtual IntPtr CircleHandle => _circleHandle;
/// <summary>
- /// Gets the handle for Circle Surface used in this widget
+ /// Gets the handle for the circle surface used in this widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
public virtual CircleSurface CircleSurface => _surface;
/// <summary>
- /// Sets or gets disabled state of this widget.
+ /// Sets or gets the disabled state of this widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
[Obsolete("Use IsEnabled")]
}
/// <summary>
- /// Sets or gets the color of the scroll background
+ /// Sets or gets the color of the scroll background.
/// </summary>
/// <since_tizen> preview </since_tizen>
public Color VerticalScrollBackgroundColor
}
/// <summary>
- /// Sets or gets the line width of the scroll background
+ /// Sets or gets the line width of the scroll background.
/// </summary>
/// <since_tizen> preview </since_tizen>
public int VerticalScrollBackgroundLineWidth
}
/// <summary>
- /// Sets or gets the redius of the scroll background
+ /// Sets or gets the radius of the scroll background.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double VerticalScrollBackgroundRadius
}
/// <summary>
- /// Sets or gets the color of the scroll bar
+ /// Sets or gets the color of the scrollbar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public Color VerticalScrollBarColor
}
/// <summary>
- /// Sets or gets the line width of the scroll bar
+ /// Sets or gets the line width of the scrollbar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public int VerticalScrollBarLineWidth
}
/// <summary>
- /// Sets or gets the redius of the scroll bar
+ /// Sets or gets the radius of the scrollbar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double VerticalScrollBarRadius
}
/// <summary>
- /// Sets or gets the policy if the scroll bar is visible
+ /// Sets or gets the policy if the scrollbar is visible.
/// </summary>
/// <remarks>
- /// ScrollBarVisiblePolicy.Auto means the vertical scrollbar is made visible if it is needed, and otherwise kept hidden.
+ /// ScrollBarVisiblePolicy.Auto means the vertical scrollbar is made visible if it is needed, or otherwise kept hidden.
/// ScrollBarVisiblePolicy.Visible turns it on all the time, and ScrollBarVisiblePolicy.Invisible always keeps it off.
/// </remarks>
/// <since_tizen> preview </since_tizen>
/// <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>
protected override IntPtr CreateHandle(EvasObject parent)
{
{
/// <summary>
- /// The Circle ProgressBar is a widget for visually representing the progress status of a given job/task with the circular design.
+ /// The Circle ProgressBar is a widget for visually representing the progress status of a given job or task with the circular design.
/// </summary>
/// <since_tizen> preview </since_tizen>
public class CircleProgressBar : Widget, ICircleWidget
/// <summary>
/// Creates and initializes a new instance of the Circle Progressbar class.
/// </summary>
- /// <param name="parent">The parent of new Circle Progressbar instance</param>
+ /// <param name="parent">The parent of the new Circle Progressbar instance.</param>
/// <param name="surface">The surface for drawing circle features for this widget.</param>
/// <since_tizen> preview </since_tizen>
public CircleProgressBar(EvasObject parent, CircleSurface surface) : base()
/// <summary>
/// Creates and initializes a new instance of the Circle Progressbar class.
/// </summary>
- /// <param name="parent">The parent of new Circle Progressbar instance</param>
+ /// <param name="parent">The parent of the new Circle Progressbar instance.</param>
/// <since_tizen> preview </since_tizen>
[Obsolete("It is not safe for guess circle surface from parent and create new surface by every new widget")]
[EditorBrowsable(EditorBrowsableState.Never)]
}
/// <summary>
- /// Gets the handle for Circle Widget.
+ /// Gets the handle for the Circle widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
public virtual IntPtr CircleHandle => Handle;
/// <summary>
- /// Gets the handle for Circle Surface used in this widget
+ /// Gets the handle for the circle surface used in this widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
public virtual CircleSurface CircleSurface => _surface;
/// <summary>
- /// Sets or gets disabled state of this widget.
+ /// Sets or gets the disabled state of this widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
[Obsolete("Use IsEnabled")]
}
/// <summary>
- /// Sets or gets the value of ProgressBar.
+ /// Sets or gets the value of the ProgressBar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double Value
}
/// <summary>
- /// Sets or gets the maximum value of ProgressBar.
+ /// Sets or gets the maximum value of the ProgressBar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double Maximum
}
/// <summary>
- /// Sets or gets the minimum value of ProgressBar.
+ /// Sets or gets the minimum value of the ProgressBar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double Minimum
}
/// <summary>
- /// Sets or gets the angle value of ProgressBar.
+ /// Sets or gets the angle value of the ProgressBar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double BarAngle
}
/// <summary>
- /// Sets or gets the angle value of Background ProgressBar.
+ /// Sets or gets the angle value of the Background ProgressBar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double BackgroundAngle
}
/// <summary>
- /// Sets or gets the angle offset value of ProgressBar.
+ /// Sets or gets the angle offset value of the ProgressBar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double BarAngleOffset
}
/// <summary>
- /// Sets or gets the angle offset value of Background ProgressBar.
+ /// Sets or gets the angle offset value of the Background ProgressBar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double BackgroundAngleOffset
}
/// <summary>
- /// Sets or gets the maximum angle value of ProgressBar.
+ /// Sets or gets the maximum angle value of the ProgressBar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double BarAngleMaximum
}
/// <summary>
- /// Sets or gets the minimum angle value of ProgressBar.
+ /// Sets or gets the minimum angle value of the ProgressBar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double BarAngleMinimum
}
/// <summary>
- /// Sets or gets color of ProgressBar.
+ /// Sets or gets the color of the ProgressBar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public Color BarColor
}
/// <summary>
- /// Sets or gets color of Background ProgressBar.
+ /// Sets or gets the color of the Background ProgressBar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public override Color BackgroundColor
}
/// <summary>
- /// Sets or gets line width of ProgressBar.
+ /// Sets or gets the line width of the ProgressBar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public int BarLineWidth
}
/// <summary>
- /// Sets or gets line width of Background ProgressBar.
+ /// Sets or gets the line width of the Background ProgressBar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public int BackgroundLineWidth
}
/// <summary>
- /// Sets or gets radius of ProgressBar.
+ /// Sets or gets the radius of the ProgressBar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double BarRadius
}
/// <summary>
- /// Sets or gets radius of Background ProgressBar.
+ /// Sets or gets the radius of the Background ProgressBar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double BackgroundRadius
/// <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>
protected override IntPtr CreateHandle(EvasObject parent)
{
namespace ElmSharp.Wearable
{
/// <summary>
- /// Circle scroller provides scrollbar with circular movement and is scrolled by rotary event.
+ /// Circle scroller provides the scrollbar with a circular movement, and is scrolled by the Rotary event.
/// </summary>
/// <since_tizen> preview </since_tizen>
public class CircleScroller : Scroller, IRotaryActionWidget
/// <summary>
/// Creates and initializes a new instance of the Circle Scroller class.
/// </summary>
- /// <param name="parent">The parent of new Circle CircleScroller instance</param>
+ /// <param name="parent">The parent of the new Circle CircleScroller instance.</param>
/// <since_tizen> preview </since_tizen>
[Obsolete("It is not safe for guess circle surface from parent and create new surface by every new widget")]
[EditorBrowsable(EditorBrowsableState.Never)]
}
/// <summary>
- /// Gets the handle for Circle Widget.
+ /// Gets the handle for the Circle widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
public virtual IntPtr CircleHandle => _circleHandle;
/// <summary>
- /// Gets the handle for Circle Surface used in this widget
+ /// Gets the handle for the circle surface used in this widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
public virtual CircleSurface CircleSurface => _surface;
/// <summary>
- /// Sets or gets disabled state of this widget.
+ /// Sets or gets the disabled state of this widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
[Obsolete("Use IsEnabled")]
}
/// <summary>
- /// Sets or gets the value of HorizontalScrollBarVisiblePolicy
+ /// Sets or gets the value of HorizontalScrollBarVisiblePolicy.
/// </summary>
/// <remarks>
- /// ScrollBarVisiblePolicy.Auto means the horizontal scrollbar is made visible if it is needed, and otherwise kept hidden.
+ /// ScrollBarVisiblePolicy.Auto means the horizontal scrollbar is made visible if it is needed, otherwise kept hidden.
/// ScrollBarVisiblePolicy.Visible turns it on all the time, and ScrollBarVisiblePolicy.Invisible always keeps it off.
/// </remarks>
/// <since_tizen> preview </since_tizen>
}
/// <summary>
- /// Sets or gets the value of VerticalScrollBarVisiblePolicy
+ /// Sets or gets the value of VerticalScrollBarVisiblePolicy.
/// </summary>
/// <remarks>
- /// ScrollBarVisiblePolicy.Auto means the vertical scrollbar is made visible if it is needed, and otherwise kept hidden.
+ /// ScrollBarVisiblePolicy.Auto means the vertical scrollbar is made visible if it is needed, otherwise kept hidden.
/// ScrollBarVisiblePolicy.Visible turns it on all the time, and ScrollBarVisiblePolicy.Invisible always keeps it off.
/// </remarks>
/// <since_tizen> preview </since_tizen>
}
/// <summary>
- /// Sets or gets color of the vertical scroll bar.
+ /// Sets or gets the color of the vertical scroll bar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public Color VerticalScrollBarColor
}
/// <summary>
- /// Sets or gets color of the horizontal scroll bar.
+ /// Sets or gets the color of the horizontal scroll bar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public Color HorizontalScrollBarColor
}
/// <summary>
- /// Sets or gets color of the vertical scroll background.
+ /// Sets or gets the color of the vertical scroll background.
/// </summary>
/// <since_tizen> preview </since_tizen>
public Color VerticalScrollBackgroundColor
}
/// <summary>
- /// Sets or gets color of the horizontal scroll background.
+ /// Sets or gets the color of the horizontal scroll background.
/// </summary>
/// <since_tizen> preview </since_tizen>
public Color HorizontalScrollBackgroundColor
}
/// <summary>
- /// Sets or gets line width of the vertical scroll bar.
+ /// Sets or gets the line width of the vertical scroll bar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public int VerticalScrollBarLineWidth
}
/// <summary>
- /// Sets or gets line width of the horizontal scroll bar.
+ /// Sets or gets the line width of the horizontal scroll bar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public int HorizontalScrollBarLineWidth
}
/// <summary>
- /// Sets or gets line width of the vertical scroll background.
+ /// Sets or gets the line width of the vertical scroll background.
/// </summary>
/// <since_tizen> preview </since_tizen>
public int VerticalScrollBackgroundLineWidth
}
/// <summary>
- /// Sets or gets line width of the horizontal scroll background.
+ /// Sets or gets the line width of the horizontal scroll background.
/// </summary>
/// <since_tizen> preview </since_tizen>
public int HorizontalScrollBackgroundLineWidth
}
/// <summary>
- /// Sets or gets radius of the vertical scroll bar.
+ /// Sets or gets the radius of the vertical scroll bar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double VerticalScrollBarRadius
}
/// <summary>
- /// Sets or gets radius of the horizontal scroll bar.
+ /// Sets or gets the radius of the horizontal scroll bar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double HorizontalScrollBarRadius
}
/// <summary>
- /// Sets or gets radius of the vertical scroll background.
+ /// Sets or gets the radius of the vertical scroll background.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double VerticalScrollBackgroundRadius
}
/// <summary>
- /// Sets or gets radius of the horizontal scroll background.
+ /// Sets or gets the radius of the horizontal scroll background.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double HorizontalScrollBackgroundRadius
/// <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>
protected override IntPtr CreateHandle(EvasObject parent)
{
namespace ElmSharp.Wearable
{
/// <summary>
- /// Circle slider is circular designed widget to select a value in a range by rotary event.
+ /// Circle slider is a circular designed widget used to select a value in a range by the Rotary event.
/// </summary>
/// <since_tizen> preview </since_tizen>
public class CircleSlider : Widget, IRotaryActionWidget
/// Creates and initializes a new instance of the CircleSlider class.
/// </summary>
/// <param name="parent">The EvasObject to which the new CircleSlider will be attached as a child.</param>
- /// <param name="surface">The surface for drawing circle features for this widget.</param>
+ /// <param name="surface">The surface for drawing the circle features for this widget.</param>
/// <since_tizen> preview </since_tizen>
public CircleSlider(EvasObject parent, CircleSurface surface) : base()
{
/// <summary>
/// Creates and initializes a new instance of the Circle Slider class.
/// </summary>
- /// <param name="parent">The parent of new Circle CircleSlider instance</param>
+ /// <param name="parent">The parent of the new Circle CircleSlider instance.</param>
/// <since_tizen> preview </since_tizen>
[Obsolete("It is not safe for guess circle surface from parent and create new surface by every new widget")]
[EditorBrowsable(EditorBrowsableState.Never)]
public event EventHandler ValueChanged;
/// <summary>
- /// Gets the handle for Circle Widget.
+ /// Gets the handle for the Circle widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
public virtual IntPtr CircleHandle => RealHandle;
/// <summary>
- /// Gets the handle for Circle Surface used in this widget
+ /// Gets the handle for the circle surface used in this widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
public virtual CircleSurface CircleSurface => _surface;
/// Sets or gets the step by which the circle slider bar moves.
/// </summary>
/// <remarks>
- /// This value is used when circle slider value is changed by an drag or rotary event
+ /// This value is used when the circle slider value is changed by a drag or the Rotary event.
/// The value of the slider is increased/decreased by the step value.
/// </remarks>
/// <since_tizen> preview </since_tizen>
}
/// <summary>
- /// Sets or gets disabled state of this widget.
+ /// Sets or gets the disabled state of this widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
[Obsolete("Use IsEnabled")]
}
/// <summary>
- /// Sets or gets color of the circle slider bar.
+ /// Sets or gets the color of the circle slider bar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public Color BarColor
}
/// <summary>
- /// Sets or gets color of the circle slider background.
+ /// Sets or gets the color of the circle slider background.
/// </summary>
/// <since_tizen> preview </since_tizen>
public override Color BackgroundColor
}
/// <summary>
- /// Sets or gets the line with of the circle slider bar.
+ /// Sets or gets the line width of the circle slider bar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public int BarLineWidth
}
/// <summary>
- /// Sets or gets the line with of the circle slider background.
+ /// Sets or gets the line width of the circle slider background.
/// </summary>
/// <since_tizen> preview </since_tizen>
public int BackgroundLineWidth
/// <summary>
/// Sets or gets the angle offset for the slider bar.
- /// offset value means start position of the slider bar.
+ /// Offset value means start position of the slider bar.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double BarAngleOffset
/// <summary>
/// Sets or gets the angle offset for the circle slider background.
- /// offset value means start position of the slider background.
+ /// Offset value means start position of the slider background.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double BackgroundAngleOffset
/// </summary>
/// <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.
+ /// If the actual value is less than the minimum value, it is updated to the minimum value.
+ /// Actual value can be obtained with Value. By default, minimum value is equal to 0.0.
/// </remarks>
/// <since_tizen> preview </since_tizen>
public double Minimum
/// </summary>
/// <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.
+ /// If the actual value is bigger than the maximum value, it is updated to the maximum value.
+ /// Actual value can be obtained with Value. By default, the minimum value is equal to 0.0, and the maximum value is equal to 1.0.
/// Maximum must be greater than minimum, otherwise the behavior is undefined.
/// </remarks>
/// <since_tizen> preview </since_tizen>
/// Gets or sets the value displayed by the circle slider.
/// </summary>
/// <remarks>
- /// The value must to be between Minimum and Maximum values.
+ /// The value must be between minimum and maximum.
/// </remarks>
/// <since_tizen> preview </since_tizen>
public double Value
}
/// <summary>
- /// The callback of Realized Event
+ /// The callback of the Realized event.
/// </summary>
/// <since_tizen> preview </since_tizen>
protected override void OnRealized()
/// <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>
protected override IntPtr CreateHandle(EvasObject parent)
{
{
/// <summary>
- /// The Circle Spinner is a widget to display and handle spinner value by rotary event
+ /// The Circle Spinner is a widget to display and handle the spinner value by the Rotary event.
/// Inherits <see cref="Spinner"/>.
/// </summary>
/// <since_tizen> preview </since_tizen>
/// <summary>
/// Creates and initializes a new instance of the Circle Spinner class.
/// </summary>
- /// <param name="parent">The parent of new Circle Spinner instance</param>
+ /// <param name="parent">The parent of the new Circle Spinner instance.</param>
/// <param name="surface">The surface for drawing circle features for this widget.</param>
/// <since_tizen> preview </since_tizen>
public CircleSpinner(EvasObject parent, CircleSurface surface) : base()
/// <summary>
/// Creates and initializes a new instance of the Circle Spinner class.
/// </summary>
- /// <param name="parent">The parent of new Circle CircleSpinner instance</param>
+ /// <param name="parent">The parent of the new Circle Spinner instance.</param>
/// <since_tizen> preview </since_tizen>
[Obsolete("It is not safe for guess circle surface from parent and create new surface by every new widget")]
[EditorBrowsable(EditorBrowsableState.Never)]
}
/// <summary>
- /// Gets the handle for Circle Widget.
+ /// Gets the handle for Circle widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
public virtual IntPtr CircleHandle => _circleHandle;
/// <summary>
- /// Gets the handle for Circle Surface used in this widget
+ /// Gets the handle for the circle surface used in this widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
public virtual CircleSurface CircleSurface => _surface;
}
/// <summary>
- /// Sets or gets disabled state of this widget.
+ /// Sets or gets the disabled state of this widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
[Obsolete("Use IsEnabled")]
}
/// <summary>
- /// Sets or gets the line width of the marker
+ /// Sets or gets the line width of the marker.
/// </summary>
/// <since_tizen> preview </since_tizen>
public int MarkerLineWidth
}
/// <summary>
- /// Sets or gets the color of the marker
+ /// Sets or gets the color of the marker.
/// </summary>
/// <since_tizen> preview </since_tizen>
public Color MarkerColor
}
/// <summary>
- /// Sets or gets the radius at which the center of the marker lies
+ /// Sets or gets the radius at which the center of the marker lies.
/// </summary>
/// <since_tizen> preview </since_tizen>
public double MarkerRadius
/// <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>
protected override IntPtr CreateHandle(EvasObject parent)
{
namespace ElmSharp.Wearable
{
/// <summary>
- /// The CircleSurface presents a surface for drawing circular feature of circle widgets
+ /// The CircleSurface presents a surface for drawing the circular feature of circle widgets.
/// </summary>
/// <since_tizen> preview </since_tizen>
public class CircleSurface
IntPtr _handle;
/// <summary>
- /// Creates and initializes a new instance of the CircleSurface class with surface on the Conformant widget.
+ /// Creates and initializes a new instance of the CircleSurface class with a surface on the Conformant widget.
/// </summary>
- /// <param name="conformant">Conformant widget to create a surface.</param>
+ /// <param name="conformant">The Conformant widget to create a surface.</param>
/// <since_tizen> preview </since_tizen>
public CircleSurface(Conformant conformant)
{
}
/// <summary>
- /// Creates and initializes a new instance of the CircleSurface class with surface on the Layout widget.
+ /// Creates and initializes a new instance of the CircleSurface class with a surface on the Layout widget.
/// </summary>
- /// <param name="layout">Layout widget to create a surface.</param>
+ /// <param name="layout">The Layout widget to create a surface.</param>
/// <since_tizen> preview </since_tizen>
public CircleSurface(Layout layout)
{
}
/// <summary>
- /// Creates and initializes a new instance of the CircleSurface class with surface on the Naviframe widget.
+ /// Creates and initializes a new instance of the CircleSurface class with a surface on the Naviframe widget.
/// </summary>
- /// <param name="naviframe">Naviframe widget to create a surface.</param>
+ /// <param name="naviframe">The Naviframe widget to create a surface.</param>
/// <since_tizen> preview </since_tizen>
public CircleSurface(Naviframe naviframe)
{
}
/// <summary>
- /// Creates and initializes a new instance of the CircleSurface class with no surface
+ /// Creates and initializes a new instance of the CircleSurface class with no surface.
/// </summary>
/// <since_tizen> preview </since_tizen>
public CircleSurface()
}
/// <summary>
- /// Gets the handle for CircleSurface
+ /// Gets the handle for CircleSurface.
/// </summary>
/// <since_tizen> preview </since_tizen>
public IntPtr Handle => _handle;
/// <summary>
- /// Delete the given CirclrSurface
+ /// Deletes the given CircleSurface.
/// </summary>
/// <since_tizen> preview </since_tizen>
public void Delete()
namespace ElmSharp.Wearable
{
/// <summary>
- /// The ICircleWidget is the interface for a widget to display and handle with circle surface
+ /// The ICircleWidget is the interface for a widget to display and handle with the CircleSurface.
/// </summary>
/// <since_tizen> preview </since_tizen>
public interface ICircleWidget
{
/// <summary>
- /// Gets the handle for Circle Widget.
+ /// Gets the handle for the Circle widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
IntPtr CircleHandle { get; }
/// <summary>
- /// Gets the CircleSurface used in this widget
+ /// Gets the CircleSurface used in this widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
CircleSurface CircleSurface { get; }
}
/// <summary>
- /// The IRotaryActionWidget is the interface for a widget has action by rotary event
+ /// The IRotaryActionWidget is the interface for a widget that has action by the Rotary event.
/// </summary>
/// <since_tizen> preview </since_tizen>
public interface IRotaryActionWidget : ICircleWidget
namespace ElmSharp.Wearable
{
/// <summary>
- /// The MoreOption is a widget composed of the toggle(cue button) and more option view, and MoreOption can change a visibility through the toggle.
+ /// The MoreOption is a widget composed of the toggle (cue button) and more option view that can change a visibility through the toggle.
/// Inherits Layout
/// </summary>
/// <since_tizen> preview </since_tizen>
public class MoreOption : Layout
{
/// <summary>
- /// Sets or gets the list of more option item
+ /// Sets or gets the list of the more option item.
/// </summary>
/// <since_tizen> preview </since_tizen>
public IList<MoreOptionItem> Items { get; private set; }
/// <since_tizen> preview </since_tizen>
public event EventHandler<MoreOptionItemEventArgs> Clicked;
/// <summary>
- /// Opened will be triggered when more option view is shown.
+ /// Opened will be triggered when the more option view is shown.
/// </summary>
/// <since_tizen> preview </since_tizen>
public event EventHandler Opened;
/// <summary>
- /// Closed will be triggered when more option view is hidden.
+ /// Closed will be triggered when the more option view is hidden.
/// </summary>
/// <since_tizen> preview </since_tizen>
public event EventHandler Closed;
SmartEvent _closedEvent;
/// <summary>
- /// Creates and initializes a new instance of MoreOption class.
+ /// Creates and initializes a new instance of the MoreOption class.
/// </summary>
- /// <param name="parent">The parent is a given container which will be attached by MoreOption as a child. It's <see cref="EvasObject"/> type.</param>
+ /// <param name="parent">The parent is a given container, which will be attached by the MoreOption as a child. It's <see cref="EvasObject"/> type.</param>
/// <since_tizen> preview </since_tizen>
public MoreOption(EvasObject parent) : base(parent)
{
/// <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>
protected override IntPtr CreateHandle(EvasObject parent)
{
}
/// <summary>
- /// Sets or gets the visibility of more option view.
+ /// Sets or gets the visibility of the more option view.
/// </summary>
/// <since_tizen> preview </since_tizen>
public bool IsOpened
}
/// <summary>
- /// Enumeration for More Option Direction type.
+ /// Enumeration for the more option direction types.
/// </summary>
/// <since_tizen> preview </since_tizen>
public enum MoreOptionDirection
{
/// <summary>
- /// Top direction
+ /// Top direction.
/// </summary>
Top,
/// <summary>
- /// Bottom direction
+ /// Bottom direction.
/// </summary>
Bottom,
/// <summary>
- /// Left direction
+ /// Left direction.
/// </summary>
Left,
/// <summary>
- /// Right direction
+ /// Right direction.
/// </summary>
Right
}
namespace ElmSharp.Wearable
{
/// <summary>
- /// The MoreOptionItem is a item of MoreOption widget.
+ /// The MoreOptionItem is an item of the MoreOption widget.
/// </summary>
/// <since_tizen> preview </since_tizen>
public class MoreOptionItem
}
/// <summary>
- /// Creates and initializes a new instance of MoreOptionItem class.
+ /// Creates and initializes a new instance of the MoreOptionItem class.
/// </summary>
/// <since_tizen> preview </since_tizen>
public MoreOptionItem()
}
/// <summary>
- /// Sets or gets the main text of a more option object.
+ /// Sets or gets the main text of the more option object.
/// </summary>
/// <since_tizen> preview </since_tizen>
public string MainText
}
/// <summary>
- /// Sets or gets the sub text of a more option object.
+ /// Sets or gets the subtext of the more option object.
/// </summary>
/// <since_tizen> preview </since_tizen>
public string SubText
}
/// <summary>
- /// Sets or gets the icon image
+ /// Sets or gets the icon image.
/// </summary>
/// <since_tizen> preview </since_tizen>
public Image Icon
namespace ElmSharp.Wearable
{
/// <summary>
- /// The MoreOptionItemEventArgs is a event args class for MoreOptionItem.
+ /// The MoreOptionItemEventArgs is an event arguments class for the MoreOptionItem.
/// Inherits EventArgs
/// </summary>
/// <since_tizen> preview </since_tizen>
public class MoreOptionItemEventArgs : EventArgs
{
/// <summary>
- /// Sets or gets the more option item
+ /// Sets or gets the more option item.
/// </summary>
/// <since_tizen> preview </since_tizen>
public MoreOptionItem Item { get; set; }
List<MoreOptionItem> Items { get; set; }
/// <summary>
- /// Sets or gets the count of Items
+ /// Sets or gets the count of items.
/// </summary>
public int Count => Items.Count;
/// <summary>
- /// Sets or gets whether it is read only
+ /// Sets or gets whether it is read-only.
/// </summary>
public bool IsReadOnly => false;
/// <summary>
- /// Sets or gets the item with the index
+ /// Sets or gets the item with the index.
/// </summary>
- /// <param name="index">the position of item in items</param>
- /// <returns></returns>
+ /// <param name="index">The position of item in items.</param>
+ /// <returns>MoreOptionItem object on the index.</returns>
public MoreOptionItem this[int index]
{
get
}
/// <summary>
- /// Creates and initializes a new instance of MoreOptionList class.
+ /// Creates and initializes a new instance of the MoreOptionList class.
/// </summary>
- /// <param name="owner">the object of more option</param>
+ /// <param name="owner">The object of more option.</param>
public MoreOptionList(MoreOption owner)
{
Owner = owner;
}
/// <summary>
- /// Append a new item to a more option.
+ /// Appends a new item to the more option.
/// </summary>
- /// <param name="item">The more option item</param>
+ /// <param name="item">The more option item.</param>
public void Add(MoreOptionItem item)
{
item.Handle = Interop.Eext.eext_more_option_item_append(Owner);
}
/// <summary>
- /// add a new item to a more option at the first.
+ /// Adds a new item to the more option at the first.
/// </summary>
- /// <param name="item">The more option item</param>
+ /// <param name="item">The more option item.</param>
public void AddFirst(MoreOptionItem item)
{
item.Handle = Interop.Eext.eext_more_option_item_prepend(Owner);
}
/// <summary>
- /// add a new item to a more option at the last.
+ /// Adds a new item to the more option at the last.
/// </summary>
- /// <param name="item">The more option item</param>
+ /// <param name="item">The more option item.</param>
public void AddLast(MoreOptionItem item)
{
Add(item);
}
/// <summary>
- /// Get the index of item
+ /// Get the index of an item.
/// </summary>
- /// <param name="item">The more option item</param>
- /// <returns>the index of item</returns>
+ /// <param name="item">The more option item.</param>
+ /// <returns>The index of an item.</returns>
public int IndexOf(MoreOptionItem item)
{
return Items.IndexOf(item);
}
/// <summary>
- /// Insert a new item into the more option after more option item with the index.
+ /// Inserts a new item into the more option, after the more option item with the index.
/// </summary>
- /// <param name="index">the index of item which is insert after</param>
- /// <param name="item">The more option item</param>
+ /// <param name="index">The index of an item, which is inserted after.</param>
+ /// <param name="item">The more option item.</param>
public void Insert(int index, MoreOptionItem item)
{
if (Items.Count < index + 1 || index < 0)
}
/// <summary>
- /// Delete an item which is the given item index
+ /// Deletes an item, which is the given item index.
/// </summary>
/// <param name="index">the item index which will be deleted</param>
public void RemoveAt(int index)
}
/// <summary>
- /// Remove all items from a given more option list object.
+ /// Removes all the items from a given more option list object.
/// </summary>
public void Clear()
{
}
/// <summary>
- /// Check the item whether is contained
+ /// Checks the item whether it is contained.
/// </summary>
- /// <param name="item">The more option item</param>
- /// <returns>If contain return true, otherwise false</returns>
+ /// <param name="item">The more option item.</param>
+ /// <returns>If contained return true, otherwise false.</returns>
public bool Contains(MoreOptionItem item)
{
return Items.Contains(item);
}
/// <summary>
- /// Copy Items
+ /// Copies the items.
/// </summary>
- /// <param name="array">the target array</param>
- /// <param name="arrayIndex">which index the item will copy to</param>
+ /// <param name="array">The target array.</param>
+ /// <param name="arrayIndex">The index to which the item will be copied.</param>
public void CopyTo(MoreOptionItem[] array, int arrayIndex)
{
Items.CopyTo(array, arrayIndex);
}
/// <summary>
- /// Remove a item
+ /// Removes the item.
/// </summary>
- /// <param name="item">the item will be removed</param>
- /// <returns>if remove success return true, otherwise false</returns>
+ /// <param name="item">The item will be removed.</param>
+ /// <returns>If removed is successful return true, otherwise false.</returns>
public bool Remove(MoreOptionItem item)
{
if (Items.Contains(item))
}
/// <summary>
- /// Return an enumerator that iterates through IEnumerator
+ /// Returns an enumerator that iterates through IEnumerator.
/// </summary>
/// <returns></returns>
public IEnumerator<MoreOptionItem> GetEnumerator()
namespace ElmSharp.Wearable
{
/// <summary>
- /// RotaryEventManager serve functions for global Rotary event like Galaxy Gear.
+ /// The RotaryEventManager serves functions for the global Rotary event like Galaxy Gear.
/// </summary>
/// <since_tizen> preview </since_tizen>
public static class RotaryEventManager
static Dictionary<RotaryEventHandler, Interop.Eext.Eext_Rotary_Handler_Cb> s_rotaryEventHandlers = new Dictionary<RotaryEventHandler, Interop.Eext.Eext_Rotary_Handler_Cb>();
/// <summary>
- /// Rotated will triggered when rotatable device like Galaxy Gear Bezel is rotated.
+ /// Rotated will be triggered when the rotatable device like the Galaxy Gear Bezel is rotated.
/// </summary>
/// <since_tizen> preview </since_tizen>
public static event RotaryEventHandler Rotated
/// <summary>
- /// RotaryEventManager serve extension functions for Rotary event to EvasObject on device like Galaxy Gear.
+ /// The RotaryEventManager serves extension functions for the Rotary event to EvasObject on a device like Galaxy Gear.
/// </summary>
/// <since_tizen> preview </since_tizen>
public static class RotaryEventExtensions
static Dictionary<EvasObject, Interop.Eext.Eext_Rotary_Event_Cb> s_rotaryObjectEventMap = new Dictionary<EvasObject, Interop.Eext.Eext_Rotary_Event_Cb>();
/// <summary>
- /// Add a handler for Rotary event on specific EvasObject.
+ /// Adds a handler for the Rotary event on a specific EvasObject.
/// </summary>
- /// <param name="obj">Target EvasObject</param>
- /// <param name="handler">Event handler for Rotary event</param>
+ /// <param name="obj">Target EvasObject.</param>
+ /// <param name="handler">Event handler for the Rotary event.</param>
/// <since_tizen> preview </since_tizen>
public static void AddRotaryEventHandler(this EvasObject obj, RotaryEventHandler handler)
{
}
/// <summary>
- /// Remove a handler on specific EvasObject for Rotary event.
+ /// Removes a handler on a specific EvasObject for the Rotary event.
/// </summary>
- /// <param name="obj">Target EvasObject</param>
- /// <param name="handler">Event handler for Rotary event</param>
+ /// <param name="obj">Target EvasObject.</param>
+ /// <param name="handler">Event handler for Rotary event.</param>
/// <since_tizen> preview </since_tizen>
public static void RemoveRotaryEventHandler(this EvasObject obj, RotaryEventHandler handler)
{
}
/// <summary>
- /// Activate this circle widget can take Rotary event.
+ /// Activates this Circle widget that can take the Rotary event.
/// </summary>
- /// <param name="widget">Target circle widget</param>
+ /// <param name="widget">Target the Circle widget.</param>
/// <since_tizen> preview </since_tizen>
public static void Activate(this IRotaryActionWidget widget)
{
}
/// <summary>
- /// Deactivate this circle widget is blocked from Rotary event.
+ /// Deactivates this circle widget that is blocked from the Rotary event.
/// </summary>
- /// <param name="widget">Target circle widget</param>
+ /// <param name="widget">Target the Circle widget.</param>
/// <since_tizen> preview </since_tizen>
public static void Deactivate(this IRotaryActionWidget widget)
{
}
/// <summary>
- /// Activate this object can take Rotary event.
+ /// Activates this object that can take the Rotary event.
/// </summary>
- /// <param name="obj">Target object</param>
+ /// <param name="obj">Target object.</param>
/// <since_tizen> preview </since_tizen>
public static void Activate(this EvasObject obj)
{
}
/// <summary>
- /// Deactivate this object is blocked from Rotary event.
+ /// Deactivates this object that is blocked from the Rotary event.
/// </summary>
- /// <param name="obj">Target object</param>
+ /// <param name="obj">Target object.</param>
/// <since_tizen> preview </since_tizen>
public static void Deactivate(this EvasObject obj)
{
}
/// <summary>
- /// Handler for Rotary event
+ /// Handler for the Rotary event.
/// </summary>
- /// <param name="args">Rotary event information</param>
+ /// <param name="args">The Rotary event information.</param>
/// <since_tizen> preview </since_tizen>
public delegate void RotaryEventHandler(RotaryEventArgs args);
/// <summary>
- /// RotaryEventArgs serve information for triggered rotary event.
+ /// The RotaryEventArgs serves information for the triggered Rotary event.
/// </summary>
/// <since_tizen> preview </since_tizen>
public class RotaryEventArgs : EventArgs
{
/// <summary>
- /// IsClockwise is true when Rotary device rotated clockwise direction or false on counter clockwise.
+ /// IsClockwise is true when the Rotary device rotated in the clockwise direction, or false on counter clockwise.
/// </summary>
/// <since_tizen> preview </since_tizen>
public bool IsClockwise { get; set; }
/// <summary>
- /// Timestamp of rotary event
+ /// Timestamp of the Rotary event.
/// </summary>
/// <since_tizen> preview </since_tizen>
public uint Timestamp { get; set; }
namespace ElmSharp.Wearable
{
/// <summary>
- /// The Rotary Selector is a widget to display a selector and multiple items surrounding the selector.
- /// And an item can be selected by rotary event or user item click.
+ /// The RotarySelector is a widget to display a selector and multiple items surrounding the selector.
+ /// An item can be selected by the Rotary event or user item click.
/// Inherits <see cref="Layout"/>.
/// </summary>
/// <since_tizen> preview </since_tizen>
const string ItemClickedEventName = "item,clicked";
/// <summary>
- /// Selected will be triggered when selected an item.
+ /// Selected will be triggered when selecting an item.
/// </summary>
/// <since_tizen> preview </since_tizen>
public event EventHandler<RotarySelectorItemEventArgs> Selected;
/// <summary>
- /// Clicked will be triggered when selecting again the alredy selected item or selecting a selector.
+ /// Clicked will be triggered when selecting again the already selected item or selecting a selector.
/// </summary>
/// <since_tizen> preview </since_tizen>
public event EventHandler<RotarySelectorItemEventArgs> Clicked;
/// <summary>
/// Creates and initializes a new instance of the Rotary Selector class.
/// </summary>
- /// <param name="parent">The parent of new Rotary Selector instance</param>
+ /// <param name="parent">The parent of the new Rotary Selector instance.</param>
/// <since_tizen> preview </since_tizen>
public RotarySelector(EvasObject parent) : base(parent)
{
/// <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>
protected override IntPtr CreateHandle(EvasObject parent)
{
namespace ElmSharp.Wearable
{
/// <summary>
- /// A instance to the Rotary Selector Item added. And an item can be selected by rotary event or user item click.
+ /// An instance to the Rotary Selector item is added. An item can be selected by the Rotary event or user item click.
/// </summary>
/// <since_tizen> preview </since_tizen>
public class RotarySelectorItem
public string MainText { set => setPart(ref _mainText, MainTextPartName, value); get => _mainText; }
/// <summary>
- /// Sets or gets the sub text of a rotary selector item object.
+ /// Sets or gets the subtext of a rotary selector item object.
/// </summary>
/// <since_tizen> preview </since_tizen>
public string SubText { set => setPart(ref _subText, SubTextPartName, value); get => _subText; }
/// <summary>
- /// Sets or gets the sub text color of a rotary selector item object.
+ /// Sets or gets the subtext color of a rotary selector item object.
/// </summary>
/// <since_tizen> preview </since_tizen>
public Color MainTextColor { set => setPart(ref _mainTextColor, MainTextPartName, ItemState.Normal, value); get => _mainTextColor; }
/// <summary>
- /// Sets or gets the sub text color of a rotary selector item object.
+ /// Sets or gets the subtext color of a rotary selector item object.
/// </summary>
/// <since_tizen> preview </since_tizen>
public Color SubTextColor { set => setPart(ref _subTextColor, SubTextPartName, ItemState.Normal, value); get => _subTextColor; }
public Image NormalIconImage { set => setPart(ref _normalIconImage, IconPartName, ItemState.Normal, value); get => _normalIconImage; }
/// <summary>
- /// Sets or gets the press icon image of a rotary selector item object.
+ /// Sets or gets the pressed icon image of a rotary selector item object.
/// </summary>
/// <since_tizen> preview </since_tizen>
public Image PressedIconImage { set => setPart(ref _pressedIconImage, IconPartName, ItemState.Pressed, value); get => _pressedIconImage; }
/// <summary>
- /// Sets or gets the disable icon image of a rotary selector item object.
+ /// Sets or gets the disabled icon image of a rotary selector item object.
/// </summary>
/// <since_tizen> preview </since_tizen>
public Image DisabledIconImage { set => setPart(ref _disabledIconImage, IconPartName, ItemState.Disabled, value); get => _disabledIconImage; }
namespace ElmSharp.Wearable
{
/// <summary>
- /// <see cref="RotarySelector.Selected"/> and <see cref="RotarySelector.Clicked"/> events of RotarySelector contain RotarySelectorItemEventArgs as a parameter.
+ /// <see cref="RotarySelector.Selected"/> and <see cref="RotarySelector.Clicked"/> events of the RotarySelector contain the RotarySelectorItemEventArgs as a parameter.
/// Inherits <see cref="EventArgs"/>.
/// </summary>
/// <since_tizen> preview </since_tizen>