[NUI]Remove some unused APIs.
[platform/core/csapi/tizenfx.git] / src / Tizen.NUI / src / public / Size2D.cs
index 13006b4..ed1d4a7 100755 (executable)
@@ -19,11 +19,16 @@ namespace Tizen.NUI
 {
 
     /// <summary>
-    /// A two dimensional size
+    /// A two-dimensional size.
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public class Size2D : global::System.IDisposable
     {
         private global::System.Runtime.InteropServices.HandleRef swigCPtr;
+        /// <summary>
+        /// swigCMemOwn
+        /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         protected bool swigCMemOwn;
 
         internal Size2D(global::System.IntPtr cPtr, bool cMemoryOwn)
@@ -39,9 +44,16 @@ namespace Tizen.NUI
 
         //A Flag to check who called Dispose(). (By User or DisposeQueue)
         private bool isDisposeQueued = false;
-        //A Flat to check if it is already disposed.
+        /// <summary>
+        /// A Flat to check if it is already disposed.
+        /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         protected bool disposed = false;
 
+        /// <summary>
+        /// Dispose.
+        /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         ~Size2D()
         {
             if(!isDisposeQueued)
@@ -52,8 +64,9 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Dispose
+        /// Dispose.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public void Dispose()
         {
             //Throw excpetion if Dispose() is called in separate thread.
@@ -73,6 +86,10 @@ namespace Tizen.NUI
             }
         }
 
+        /// <summary>
+        /// Dispose.
+        /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         protected virtual void Dispose(DisposeTypes type)
         {
             if (disposed)
@@ -104,87 +121,95 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Addition operator for A+B
+        /// The addition operator for A+B.
         /// </summary>
-        /// <param name="arg1">Size, A</param>
-        /// <param name="arg2">Size to assign, B</param>
-        /// <returns>A Size containing the result of the addition</returns>
+        /// <param name="arg1">Size A.</param>
+        /// <param name="arg2">Size to assign B.</param>
+        /// <returns>A size containing the result of the addition.</returns>
+        /// <since_tizen> 3 </since_tizen>
         public static Size2D operator +(Size2D arg1, Size2D arg2)
         {
             return arg1.Add(arg2);
         }
 
         /// <summary>
-        /// Subtraction operator for A-B
+        /// The subtraction operator for A-B.
         /// </summary>
-        /// <param name="arg1">Size, A</param>
-        /// <param name="arg2">Size to subtract, B</param>
-        /// <returns>A Size containing the result of the subtraction</returns>
+        /// <param name="arg1">Size A.</param>
+        /// <param name="arg2">Size to subtract B.</param>
+        /// <returns>A size containing the result of the subtraction.</returns>
+        /// <since_tizen> 3 </since_tizen>
         public static Size2D operator -(Size2D arg1, Size2D arg2)
         {
             return arg1.Subtract(arg2);
         }
 
         /// <summary>
-        /// Unary negation operator.
+        /// The unary negation operator.
         /// </summary>
-        /// <param name="arg1">Size for unary negation</param>
-        /// <returns>A Size containg the negation</returns>
+        /// <param name="arg1">Size for unary negation.</param>
+        /// <returns>A size containing the negation.</returns>
+        /// <since_tizen> 3 </since_tizen>
         public static Size2D operator -(Size2D arg1)
         {
             return arg1.Subtract();
         }
 
         /// <summary>
-        /// Multiplication operator.
+        /// The multiplication operator.
         /// </summary>
-        /// <param name="arg1">Size for multiplication</param>
-        /// <param name="arg2">The Size to multipl</param>
-        /// <returns>A Size containing the result of the multiplication</returns>
+        /// <param name="arg1">Size for multiplication.</param>
+        /// <param name="arg2">Size to multiply.</param>
+        /// <returns>A size containing the result of the multiplication.</returns>
+        /// <since_tizen> 3 </since_tizen>
         public static Size2D operator *(Size2D arg1, Size2D arg2)
         {
             return arg1.Multiply(arg2);
         }
 
         /// <summary>
-        /// Multiplication operator.
+        /// The multiplication operator.
         /// </summary>
         /// <param name="arg1">Size for multiplication</param>
-        /// <param name="arg2">The int value to scale the Size</param>
-        /// <returns>A Size containing the result of the scaling</returns>
+        /// <param name="arg2">The integer value to scale the size.</param>
+        /// <returns>A size containing the result of the scaling.</returns>
 
+        /// <since_tizen> 3 </since_tizen>
         public static Size2D operator *(Size2D arg1, int arg2)
         {
             return arg1.Multiply(arg2);
         }
 
         /// <summary>
-        /// Division operator.
+        /// The division operator.
         /// </summary>
-        /// <param name="arg1">Size for division</param>
-        /// <param name="arg2">The Size to divide</param>
-        /// <returns>A Size containing the result of the division></returns>
+        /// <param name="arg1">Size for division.</param>
+        /// <param name="arg2">Size to divide.</param>
+        /// <returns>A size containing the result of the division.</returns>
+        /// <since_tizen> 3 </since_tizen>
         public static Size2D operator /(Size2D arg1, Size2D arg2)
         {
             return arg1.Divide(arg2);
         }
 
         /// <summary>
-        /// Division operator.
+        /// The division operator.
         /// </summary>
-        /// <param name="arg1">Size for division</param>
-        /// <param name="arg2">The int value to scale the Size by</param>
-        /// <returns>A Size containing the result of the scaling</returns>
+        /// <param name="arg1">Size for division.</param>
+        /// <param name="arg2">The integer value to scale the size by.</param>
+        /// <returns>A size containing the result of the scaling.</returns>
+        /// <since_tizen> 3 </since_tizen>
         public static Size2D operator /(Size2D arg1, int arg2)
         {
             return arg1.Divide(arg2);
         }
 
         /// <summary>
-        /// Array subscript operator.
+        /// The array subscript operator.
         /// </summary>
-        /// <param name="index">Subscript index</param>
-        /// <returns>The float at the given index</returns>
+        /// <param name="index">The subscript index.</param>
+        /// <returns>The float at the given index.</returns>
+        /// <since_tizen> 3 </since_tizen>
         public float this[uint index]
         {
             get
@@ -194,9 +219,9 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Get Size from pointer.
+        /// Gets the size from the pointer.
         /// </summary>
-        /// <param name="cPtr">Pointer of the Size</param>
+        /// <param name="cPtr">The pointer of the size.</param>
         /// <returns>Size</returns>
         internal static Size2D GetSize2DFromPtr(global::System.IntPtr cPtr)
         {
@@ -206,18 +231,20 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Constructor.
+        /// The constructor.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public Size2D() : this(NDalicPINVOKE.new_Vector2__SWIG_0(), true)
         {
             if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
         }
 
         /// <summary>
-        /// Constructor.
+        /// The constructor.
         /// </summary>
-        /// <param name="x">x (or width) component</param>
-        /// <param name="y">y (or height) component</param>
+        /// <param name="x">The x (or width) component.</param>
+        /// <param name="y">The y (or height) component.</param>
+        /// <since_tizen> 3 </since_tizen>
         public Size2D(int x, int y) : this(NDalicPINVOKE.new_Vector2__SWIG_1((float)x, (float)y), true)
         {
             if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
@@ -275,11 +302,12 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Check equality.<br>
-        /// Utilizes appropriate machine epsilon values.<br>
+        /// Checks equality.<br />
+        /// Utilizes appropriate machine epsilon values.<br />
         /// </summary>
-        /// <param name="rhs">The Size to test against</param>
-        /// <returns>True if the Sizes are equal</returns>
+        /// <param name="rhs">The size to test against.</param>
+        /// <returns>True if the sizes are equal.</returns>
+        /// <since_tizen> 3 </since_tizen>
         public bool EqualTo(Size2D rhs)
         {
             bool ret = NDalicPINVOKE.Vector2_EqualTo(swigCPtr, Size2D.getCPtr(rhs));
@@ -288,11 +316,12 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Check inequality.<br>
-        /// Utilizes appropriate machine epsilon values.<br>
+        /// Checks inequality.<br />
+        /// Utilizes appropriate machine epsilon values.<br />
         /// </summary>
-        /// <param name="rhs">The Size to test against</param>
-        /// <returns>True if the Sizes are not equal</returns>
+        /// <param name="rhs">The size to test against.</param>
+        /// <returns>True if the sizes are not equal.</returns>
+        /// <since_tizen> 3 </since_tizen>
         public bool NotEqualTo(Size2D rhs)
         {
             bool ret = NDalicPINVOKE.Vector2_NotEqualTo(swigCPtr, Size2D.getCPtr(rhs));
@@ -308,8 +337,9 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Property for width component of Size
+        /// The property for the width component of a size.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public int Width
         {
             set
@@ -326,8 +356,9 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Property for height component of Size
+        /// The property for the height component of a size.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public int Height
         {
             set
@@ -344,43 +375,26 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Type cast operator, Size2D to Vector2.
+        /// The type cast operator, Size2D to Vector2.
         /// </summary>
-        /// <param name="size">Object of Size2D type</param>
+        /// <param name="size">An object of the Size2D type.</param>
+        /// <returns>return a Vector2 instance</returns>
+        /// <since_tizen> 3 </since_tizen>
         public static implicit operator Vector2(Size2D size)
         {
             return new Vector2((float)size.Width, (float)size.Height);
         }
 
         /// <summary>
-        /// Type cast operator, Vector2 to Size2D type.
-        /// </summary>
-        /// <param name="vec">Object of Vector2 type</param>
-        public static implicit operator Size2D(Vector2 vec)
-        {
-            return new Size2D((int)vec.X, (int)vec.Y);
-        }
-
-        /// <summary>
-        /// Type cast operator, Size2D to Uint16Pair.
+        /// The type cast operator, Vector2 to Size2D type.
         /// </summary>
-        /// <param name="size2d">Object of Size2D type</param>
-        public static implicit operator Uint16Pair(Size2D size2d)
+        /// <param name="vector2">An object of the Vector2 type.</param>
+        /// <returns>return a Size2D instance</returns>
+        /// <since_tizen> 3 </since_tizen>
+        public static implicit operator Size2D(Vector2 vector2)
         {
-            return new Uint16Pair((uint)size2d.Width, (uint)size2d.Height);
+            return new Size2D((int)vector2.X, (int)vector2.Y);
         }
-
-        /// <summary>
-        /// Type cast operator, Uint16Pair to Size2D type.
-        /// </summary>
-        /// <param name="pair">Object of Vector2 type</param>
-        public static implicit operator Size2D(Uint16Pair pair)
-        {
-            return new Size2D((int)pair.GetWidth(), (int)pair.GetWidth());
-        }
-
-
     }
 
 }
-