Revert "[NUI] Add Extents type Padding in View"
[platform/core/csapi/tizenfx.git] / src / Tizen.NUI / src / public / BaseComponents / View.cs
index b523aa1..73218bc 100755 (executable)
@@ -23,6 +23,7 @@ namespace Tizen.NUI.BaseComponents
     /// <summary>
     /// View is the base class for all views.
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public class View : Container
     {
         private global::System.Runtime.InteropServices.HandleRef swigCPtr;
@@ -90,6 +91,7 @@ namespace Tizen.NUI.BaseComponents
         /// Retrieves the number of children held by the view.
         /// </summary>
         /// <seealso cref="Container.GetChildCount" />
+        /// <since_tizen> 4 </since_tizen>
         public override uint GetChildCount()
         {
             return Convert.ToUInt32(Children.Count);
@@ -99,6 +101,7 @@ namespace Tizen.NUI.BaseComponents
         /// Gets the views parent.
         /// </summary>
         /// <seealso cref="Container.GetParent()" />
+        /// <since_tizen> 4 </since_tizen>
         public override Container GetParent()
         {
             IntPtr cPtr = NDalicPINVOKE.Actor_GetParent(swigCPtr);
@@ -340,6 +343,7 @@ namespace Tizen.NUI.BaseComponents
         /// <summary>
         /// Event arguments that passed via the KeyEvent signal.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public class KeyEventArgs : EventArgs
         {
             private Key _key;
@@ -370,7 +374,7 @@ namespace Tizen.NUI.BaseComponents
         /// An event for the KeyPressed signal which can be used to subscribe or unsubscribe the event handler provided by the user.<br />
         /// The KeyPressed signal is emitted when the key event is received.<br />
         /// </summary>
-        /// <since_tizen> 4 </since_tizen>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandlerWithReturnType<object, KeyEventArgs, bool> KeyEvent
         {
             add
@@ -464,6 +468,7 @@ namespace Tizen.NUI.BaseComponents
         /// <summary>
         /// Event arguments that passed via the touch signal.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public class TouchEventArgs : EventArgs
         {
             private Touch _touch;
@@ -494,7 +499,7 @@ namespace Tizen.NUI.BaseComponents
         /// An event for the touched signal which can be used to subscribe or unsubscribe the event handler provided by the user.<br />
         /// The touched signal is emitted when the touch input is received.<br />
         /// </summary>
-        /// <since_tizen> 4 </since_tizen>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandlerWithReturnType<object, TouchEventArgs, bool> TouchEvent
         {
             add
@@ -538,6 +543,7 @@ namespace Tizen.NUI.BaseComponents
         /// <summary>
         /// Event arguments that passed via the hover signal.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public class HoverEventArgs : EventArgs
         {
             private Hover _hover;
@@ -568,7 +574,7 @@ namespace Tizen.NUI.BaseComponents
         /// An event for the hovered signal which can be used to subscribe or unsubscribe the event handler provided by the user.<br />
         /// The hovered signal is emitted when the hover input is received.<br />
         /// </summary>
-        /// <since_tizen> 4 </since_tizen>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandlerWithReturnType<object, HoverEventArgs, bool> HoverEvent
         {
             add
@@ -612,6 +618,7 @@ namespace Tizen.NUI.BaseComponents
         /// <summary>
         /// Event arguments that passed via the wheel signal.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public class WheelEventArgs : EventArgs
         {
             private Wheel _wheel;
@@ -642,7 +649,7 @@ namespace Tizen.NUI.BaseComponents
         /// An event for the WheelMoved signal which can be used to subscribe or unsubscribe the event handler provided by the user.<br />
         /// The WheelMoved signal is emitted when the wheel event is received.<br />
         /// </summary>
-        /// <since_tizen> 4 </since_tizen>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandlerWithReturnType<object, WheelEventArgs, bool> WheelEvent
         {
             add
@@ -773,6 +780,7 @@ namespace Tizen.NUI.BaseComponents
         /// <summary>
         /// Event arguments of visibility changed.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public class VisibilityChangedEventArgs : EventArgs
         {
             private View _view;
@@ -883,6 +891,7 @@ namespace Tizen.NUI.BaseComponents
         /// <summary>
         /// Event arguments of layout direction changed.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         public class LayoutDirectionChangedEventArgs : EventArgs
         {
             private View _view;
@@ -988,7 +997,7 @@ namespace Tizen.NUI.BaseComponents
         /// An event for the ResourcesLoadedSignal signal which can be used to subscribe or unsubscribe the event handler provided by the user.<br />
         /// This signal is emitted after all resources required by a view are loaded and ready.<br />
         /// </summary>
-        /// <since_tizen> 4 </since_tizen>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandler ResourcesLoaded
         {
             add
@@ -1153,7 +1162,9 @@ namespace Tizen.NUI.BaseComponents
         /// </summary>
         /// <param name="handle">A handle to an object.</param>
         /// <returns>A handle to a view or an uninitialized handle.</returns>
-        [Obsolete("Please do not use! this will be deprecated, instead please use as keyword.")]
+        /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Please do not use! This will be deprecated! Please use as keyword instead!")]
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public static View DownCast(BaseHandle handle)
         {
             View ret =  Registry.GetManagedBaseHandleFromNativePtr(handle) as View;
@@ -1165,7 +1176,8 @@ namespace Tizen.NUI.BaseComponents
         /// [Obsolete("Please do not use! this will be deprecated, instead please use as keyword.")]
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
-        [Obsolete("Please do not use! this will be deprecated, instead please use as keyword.")]
+        [Obsolete("Please do not use! This will be deprecated! Please use as keyword instead!")]
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public static T DownCast<T>(View view) where T : View
         {
             T ret = Registry.GetManagedBaseHandleFromNativePtr(view) as T;
@@ -1379,7 +1391,7 @@ namespace Tizen.NUI.BaseComponents
         /// Creates an animation to animate the background color visual. If there is no
         /// background visual, creates one with transparent black as it's mixColor.
         /// </summary>
-        /// <since_tizen> 4 </since_tizen>
+        /// <since_tizen> 3 </since_tizen>
         public Animation AnimateBackgroundColor( object destinationValue,
                                                  int startTime,
                                                  int endTime,
@@ -1401,7 +1413,7 @@ namespace Tizen.NUI.BaseComponents
         /// <summary>
         /// Creates an animation to animate the mixColor of the named visual.
         /// </summary>
-        /// <since_tizen> 4 </since_tizen>
+        /// <since_tizen> 3 </since_tizen>
         public Animation AnimateColor( string targetVisual, object destinationColor, int startTime, int endTime, AlphaFunction.BuiltinFunctions? alphaFunction = null, object initialColor = null )
         {
             Animation animation = null;
@@ -2096,7 +2108,8 @@ namespace Tizen.NUI.BaseComponents
         /// [Obsolete("Please do not use! this will be deprecated. Please use Visibility instead.")]
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
-        [Obsolete("Please do not use! this will be deprecated. Please use Visibility instead.")]
+        [Obsolete("Please do not use! This will be deprecated! Please use Visibility instead!")]
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public bool Visible
         {
             get
@@ -2164,7 +2177,7 @@ namespace Tizen.NUI.BaseComponents
         /// <remarks>If false, then the top-left of the view is used for the position.
         /// Setting this to false will allow scaling or rotation around the anchor-point without affecting the view's position.
         /// </remarks>
-        /// <since_tizen> 4 </since_tizen>
+        /// <since_tizen> 3 </since_tizen>
         public bool PositionUsesPivotPoint
         {
             get
@@ -2184,7 +2197,12 @@ namespace Tizen.NUI.BaseComponents
         /// </summary>
         /// Please do not use! this will be deprecated!
         /// Instead please use PositionUsesPivotPoint.
-        [Obsolete("Please do not use! this will be deprecated, instead please use PositionUsesPivotPoint")]
+        /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Please do not use! This will be deprecated! Please use PositionUsesPivotPoint instead! " +
+            "Like: " +
+            "View view = new View(); " +
+            "view.PivotPoint = PivotPoint.Center; " +
+            "view.PositionUsesPivotPoint = true;")]
         [EditorBrowsable(EditorBrowsableState.Never)]
         public bool PositionUsesAnchorPoint
         {
@@ -2268,7 +2286,11 @@ namespace Tizen.NUI.BaseComponents
         /// </remarks>
         /// /// Please do not use! this will be deprecated!
         /// Instead please use NaturalSize2D.
-        [Obsolete("Please do not use! this will be deprecated, please use NaturalSize2D instead")]
+        /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Please do not use! This will be deprecated! Please use NaturalSize2D instead! " +
+            "Like: " +
+            "TextLabel label = new TextLabel(\"Hello World!\"); " +
+            "Size2D size = label.NaturalSize2D;")]
         [EditorBrowsable(EditorBrowsableState.Never)]
         public Vector3 NaturalSize
         {
@@ -2421,7 +2443,7 @@ namespace Tizen.NUI.BaseComponents
         /// </summary>
         /// <remarks>Most resources are only loaded when the control is placed on the stage.
         /// </remarks>
-        /// <since_tizen> 4 </since_tizen>
+        /// <since_tizen> 3 </since_tizen>
         public bool IsResourceReady()
         {
             bool ret = NDalicPINVOKE.IsResourceReady(swigCPtr);
@@ -2529,7 +2551,15 @@ namespace Tizen.NUI.BaseComponents
             return ret;
         }
 
-        internal Layer GetLayer()
+        /// <summary>
+        /// Gets the parent layer of this view.If a view has no parent, this method does nothing.
+        /// </summary>
+        /// <pre>The view has been initialized. </pre>
+        /// <returns>the parent layer of view </returns>
+        /// <since_tizen> 5 </since_tizen>
+        /// This will be released at Tizen.NET API Level 5, so currently this would be used as inhouse API.
+        [EditorBrowsable(EditorBrowsableState.Never)]
+        public Layer GetLayer()
         {
             IntPtr cPtr = NDalicPINVOKE.Actor_GetLayer(swigCPtr);
             Layer ret = Registry.GetManagedBaseHandleFromNativePtr(cPtr) as Layer;
@@ -3146,7 +3176,7 @@ namespace Tizen.NUI.BaseComponents
             return ret;
         }
 
-        /// <since_tizen> 4 </since_tizen>
+        /// <since_tizen> 3 </since_tizen>
         public uint AddRenderer(Renderer renderer)
         {
             uint ret = NDalicPINVOKE.Actor_AddRenderer(swigCPtr, Renderer.getCPtr(renderer));
@@ -3163,7 +3193,7 @@ namespace Tizen.NUI.BaseComponents
             return ret;
         }
 
-        /// <since_tizen> 4 </since_tizen>
+        /// <since_tizen> 3 </since_tizen>
         public Renderer GetRendererAt(uint index)
         {
             IntPtr cPtr = NDalicPINVOKE.Actor_GetRendererAt(swigCPtr, index);
@@ -3174,7 +3204,7 @@ namespace Tizen.NUI.BaseComponents
             return ret;
         }
 
-        /// <since_tizen> 4 </since_tizen>
+        /// <since_tizen> 3 </since_tizen>
         public void RemoveRenderer(Renderer renderer)
         {
             NDalicPINVOKE.Actor_RemoveRenderer__SWIG_0(swigCPtr, Renderer.getCPtr(renderer));
@@ -3182,7 +3212,7 @@ namespace Tizen.NUI.BaseComponents
                 throw NDalicPINVOKE.SWIGPendingException.Retrieve();
         }
 
-        /// <since_tizen> 4 </since_tizen>
+        /// <since_tizen> 3 </since_tizen>
         public void RemoveRenderer(uint index)
         {
             NDalicPINVOKE.Actor_RemoveRenderer__SWIG_1(swigCPtr, index);
@@ -4157,7 +4187,7 @@ namespace Tizen.NUI.BaseComponents
         /// <summary>
         /// Gets the number of renderers held by the view.
         /// </summary>
-        /// <since_tizen> 4 </since_tizen>
+        /// <since_tizen> 3 </since_tizen>
         public uint RendererCount
         {
             get
@@ -4174,7 +4204,7 @@ namespace Tizen.NUI.BaseComponents
         /// <since_tizen> 3 </since_tizen>
         /// Please do not use! this will be deprecated!
         /// Instead please use TouchEvent.
-        [Obsolete("Please do not use! this will be deprecated, instead please use TouchEvent.")]
+        [Obsolete("Please do not use! This will be deprecated! Please use TouchEvent instead!")]
         [EditorBrowsable(EditorBrowsableState.Never)]
         public event EventHandlerWithReturnType<object, TouchEventArgs, bool> Touched
         {
@@ -4207,7 +4237,7 @@ namespace Tizen.NUI.BaseComponents
         /// <since_tizen> 3 </since_tizen>
         /// Please do not use! this will be deprecated!
         /// Instead please use HoverEvent.
-        [Obsolete("Please do not use! this will be deprecated, instead please use HoverEvent.")]
+        [Obsolete("Please do not use! This will be deprecated! Please use HoverEvent instead!")]
         [EditorBrowsable(EditorBrowsableState.Never)]
         public event EventHandlerWithReturnType<object, HoverEventArgs, bool> Hovered
         {
@@ -4240,7 +4270,7 @@ namespace Tizen.NUI.BaseComponents
         /// <since_tizen> 3 </since_tizen>
         /// Please do not use! this will be deprecated!
         /// Instead please use WheelEvent.
-        [Obsolete("Please do not use! this will be deprecated, instead please use WheelEvent.")]
+        [Obsolete("Please do not use! This will be deprecated! Please use WheelEvent instead!")]
         [EditorBrowsable(EditorBrowsableState.Never)]
         public event EventHandlerWithReturnType<object, WheelEventArgs, bool> WheelMoved
         {
@@ -4273,7 +4303,11 @@ namespace Tizen.NUI.BaseComponents
         /// <since_tizen> 3 </since_tizen>
         /// Please do not use! this will be deprecated!
         /// Instead please use PivotPoint.
-        [Obsolete("Please do not use! this will be deprecated, instead please use PivotPoint")]
+        [Obsolete("Please do not use! This will be deprecated! Please use PivotPoint instead! " +
+            "Like: " +
+            "View view = new View(); " +
+            "view.PivotPoint = PivotPoint.Center; " +
+            "view.PositionUsesPivotPoint = true;")]
         [EditorBrowsable(EditorBrowsableState.Never)]
         public Position AnchorPoint
         {
@@ -4293,7 +4327,11 @@ namespace Tizen.NUI.BaseComponents
         /// [Obsolete("Please do not use! this will be deprecated")]
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
-        [Obsolete("Please do not use! this will be deprecated, please use Size2D instead")]
+        [Obsolete("Please do not use! This will be deprecated! Please use Size2D instead! " +
+            "Like: " +
+            "View view = new View(); " +
+            "view.Size2D = new Size2D(100, 100);")]
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public Size Size
         {
             get
@@ -4314,7 +4352,7 @@ namespace Tizen.NUI.BaseComponents
         /// <since_tizen> 3 </since_tizen>
         /// Please do not use! this will be deprecated!
         /// Instead please use AddedToWindow.
-        [Obsolete("Please do not use! this will be deprecated, instead please use AddedToWindow")]
+        [Obsolete("Please do not use! This will be deprecated! Please use AddedToWindow instead!")]
         [EditorBrowsable(EditorBrowsableState.Never)]
         public event EventHandler OnWindowEvent
         {
@@ -4346,7 +4384,7 @@ namespace Tizen.NUI.BaseComponents
         /// <since_tizen> 3 </since_tizen>
         /// Please do not use! this will be deprecated!
         /// Instead please use RemovedFromWindow.
-        [Obsolete("Please do not use! this will be deprecated, instead please use RemovedFromWindow")]
+        [Obsolete("Please do not use! This will be deprecated! Please use RemovedFromWindow instead!")]
         [EditorBrowsable(EditorBrowsableState.Never)]
         public event EventHandler OffWindowEvent
         {
@@ -4378,7 +4416,7 @@ namespace Tizen.NUI.BaseComponents
         /// <since_tizen> 3 </since_tizen>
         /// Please do not use! this will be deprecated!
         /// Instead please use Relayout.
-        [Obsolete("Please do not use! this will be deprecated, instead please use Relayout")]
+        [Obsolete("Please do not use! This will be deprecated! Please use Relayout instead!")]
         [EditorBrowsable(EditorBrowsableState.Never)]
         public event EventHandler OnRelayoutEvent
         {
@@ -4409,8 +4447,11 @@ namespace Tizen.NUI.BaseComponents
         /// "Please DO NOT use! This will be deprecated! Please use 'Container GetParent() for derived class' instead!"
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
-        //"Please DO NOT use! This will be deprecated! Please use 'Container GetParent() for derived class' instead!"
-        [System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)]
+        [Obsolete("Please do not use! This will be deprecated! Please use 'Container GetParent() for derived class' instead! " +
+            "Like: " +
+            "Container parent =  view.GetParent(); " +
+            "View view = parent as View;")]
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public new View Parent
         {
             get
@@ -4477,6 +4518,7 @@ namespace Tizen.NUI.BaseComponents
         /// <summary>
         /// Gets or sets the Margin for use in layout.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         public Extents Margin
         {
             get
@@ -4494,6 +4536,7 @@ namespace Tizen.NUI.BaseComponents
         /// <summary>
         /// Gets or sets the Padding for use in layout.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         public Extents PaddingEX
         {
             get
@@ -4518,10 +4561,12 @@ namespace Tizen.NUI.BaseComponents
         /// <summary>
         /// Left to right.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         LTR,
         /// <summary>
         /// Right to left.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         RTL
     }
 }