English Review: NUI public files (#434)
authorSurbhi Gupta <35525588+surbhig12@users.noreply.github.com>
Tue, 4 Sep 2018 00:39:31 +0000 (06:09 +0530)
committerdongsug-song <35130733+dongsug-song@users.noreply.github.com>
Tue, 4 Sep 2018 00:39:31 +0000 (09:39 +0900)
18 files changed:
src/Tizen.NUI/src/public/BaseHandle.cs
src/Tizen.NUI/src/public/FontClient.cs
src/Tizen.NUI/src/public/ImageLoading.cs
src/Tizen.NUI/src/public/ImfManager.cs
src/Tizen.NUI/src/public/InputMethodContext.cs
src/Tizen.NUI/src/public/LongPressGestureDetector.cs
src/Tizen.NUI/src/public/NUIApplication.cs
src/Tizen.NUI/src/public/NUIConstants.cs
src/Tizen.NUI/src/public/PanGestureDetector.cs
src/Tizen.NUI/src/public/PinchGestureDetector.cs
src/Tizen.NUI/src/public/PixelBuffer.cs
src/Tizen.NUI/src/public/PixelData.cs
src/Tizen.NUI/src/public/Property.cs
src/Tizen.NUI/src/public/StyleManager.cs
src/Tizen.NUI/src/public/TapGestureDetector.cs
src/Tizen.NUI/src/public/Touch.cs
src/Tizen.NUI/src/public/VisualMaps.cs
src/Tizen.NUI/src/public/Window.cs

index 214f758..14be715 100755 (executable)
@@ -30,7 +30,7 @@ namespace Tizen.NUI
     public class BaseHandle : Element, global::System.IDisposable
     {
         /// <summary>
-        /// Event which is occurred when a property is set
+        /// Event when a property is set.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
@@ -335,7 +335,7 @@ namespace Tizen.NUI
         /// <summary>
         /// Gets the the hash code of this baseHandle.
         /// </summary>
-        /// <returns>The Hash Code.</returns>
+        /// <returns>The hash code.</returns>
         /// <since_tizen> 5 </since_tizen>
         public override int GetHashCode()
         {
index 5d494e4..9744511 100755 (executable)
@@ -104,14 +104,14 @@ namespace Tizen.NUI
 
                 if (type == DisposeTypes.Explicit)
                 {
-                    //Called by User
+                    //Called by User.
                     //Release your own managed resources here.
                     //You should release all of your own disposable objects here.
                 }
 
                 //Release your own unmanaged resources here.
                 //You should not access any managed member here except static instance.
-                //because the execution order of Finalizes is non-deterministic.
+                //Because the execution order of Finalizes is non-deterministic.
 
                 if (swigCPtr.Handle != global::System.IntPtr.Zero)
                 {
@@ -195,7 +195,7 @@ namespace Tizen.NUI
         private static readonly FontClient instance = FontClient.Get();
 
         /// <summary>
-        /// Gets the singleton of the FontClient object.
+        /// Gets the singleton pattern of the FontClient object.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         public static FontClient Instance
@@ -300,7 +300,7 @@ namespace Tizen.NUI
         /// Whether the given character is supported by the font.
         /// </summary>
         /// <param name="fontId">The id of the font.</param>
-        /// <param name="character">The character.</param>
+        /// <param name="character">The character in a font.</param>
         /// <returns>True if the character is supported by the font.</returns>
         /// <since_tizen> 5 </since_tizen>
         public bool IsCharacterSupportedByFont(uint fontId, uint character)
@@ -311,12 +311,12 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Find the default font for displaying a UTF-32 character.
+        /// Finds the default font for displaying a UTF-32 character.
         /// </summary>
         /// <param name="charcode">The character for which a font is needed.</param>
-        /// <param name="requestedPointSize">The point size in 26.6 fractional points; the default point size is 12*64.</param>
+        /// <param name="requestedPointSize">The point size in 26.6 fractional points. The default point size is 12*64.</param>
         /// <param name="preferColor">True if a color font is preferred.</param>
-        /// <returns>A valid font identifier, or zero if the font does not exist.</returns>
+        /// <returns>A valid font identifier. Zero if the font does not exist.</returns>
         /// <since_tizen> 5 </since_tizen>
         public uint FindDefaultFont(uint charcode, uint requestedPointSize, bool preferColor)
         {
@@ -329,8 +329,8 @@ namespace Tizen.NUI
         /// Find the default font for displaying a UTF-32 character.
         /// </summary>
         /// <param name="charcode">The character for which a font is needed.</param>
-        /// <param name="requestedPointSize">The point size in 26.6 fractional points; the default point size is 12*64.</param>
-        /// <returns>A valid font identifier, or zero if the font does not exist.</returns>
+        /// <param name="requestedPointSize">The point size in 26.6 fractional points. The default point size is 12*64.</param>
+        /// <returns>A valid font identifier. Zero if the font does not exist.</returns>
         /// <since_tizen> 5 </since_tizen>
         public uint FindDefaultFont(uint charcode, uint requestedPointSize)
         {
@@ -343,7 +343,7 @@ namespace Tizen.NUI
         /// Find the default font for displaying a UTF-32 character.
         /// </summary>
         /// <param name="charcode">The character for which a font is needed.</param>
-        /// <returns>A valid font identifier, or zero if the font does not exist.</returns>
+        /// <returns>A valid font identifier. Zero if the font does not exist.</returns>
         /// <since_tizen> 5 </since_tizen>
         public uint FindDefaultFont(uint charcode)
         {
@@ -374,12 +374,12 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Retrieve the unique identifier for a font..
+        /// Retrieve the unique identifier for a font.
         /// </summary>
         /// <param name="path">The path to a font file.</param>
-        /// <param name="requestedPointSize">The point size in 26.6 fractional points; the default point size is 12*64.</param>
+        /// <param name="requestedPointSize">The point size in 26.6 fractional points. The default point size is 12*64.</param>
         /// <param name="faceIndex">The index of the font face.</param>
-        /// <returns>A valid font identifier, or zero if the font does not exist.</returns>
+        /// <returns>A valid font identifier. Zero if the font does not exist.</returns>
         /// <since_tizen> 5 </since_tizen>
         public uint GetFontId(string path, uint requestedPointSize, uint faceIndex)
         {
@@ -389,11 +389,11 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Retrieve the unique identifier for a font..
+        /// Retrieve the unique identifier for a font.
         /// </summary>
         /// <param name="path">The path to a font file.</param>
-        /// <param name="requestedPointSize">The point size in 26.6 fractional points; the default point size is 12*64.</param>
-        /// <returns>A valid font identifier, or zero if the font does not exist.</returns>
+        /// <param name="requestedPointSize">The point size in 26.6 fractional points. The default point size is 12*64.</param>
+        /// <returns>A valid font identifier. Zero if the font does not exist.</returns>
         /// <since_tizen> 5 </since_tizen>
         public uint GetFontId(string path, uint requestedPointSize)
         {
@@ -403,10 +403,10 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Retrieve the unique identifier for a font..
+        /// Retrieve the unique identifier for a font.
         /// </summary>
         /// <param name="path">The path to a font file.</param>
-        /// <returns>A valid font identifier, or zero if the font does not exist.</returns>
+        /// <returns>A valid font identifier. Zero if the font does not exist.</returns>
         /// <since_tizen> 5 </since_tizen>
         public uint GetFontId(string path)
         {
@@ -439,7 +439,7 @@ namespace Tizen.NUI
         /// <summary>
         /// Check to see if a font is scalable.
         /// </summary>
-        /// <param name="path">Path The path to a font file.</param>
+        /// <param name="path">The path where the font file is located.</param>
         /// <returns>True if scalable.</returns>
         /// <since_tizen> 5 </since_tizen>
         public bool IsScalable(string path)
@@ -529,7 +529,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Add custom fonts directory.
+        /// Adds custom fonts directory.
         /// </summary>
         /// <param name="path">Path to the fonts directory.</param>
         /// <returns>True if the fonts can be added.</returns>
index b04a085..cc815e6 100755 (executable)
@@ -23,7 +23,7 @@ namespace Tizen.NUI
     /// Loading an image.
     /// </summary>
     /// <since_tizen> 5 </since_tizen>
-    /// This will be released at Tizen.NET API Level 5, so currently this would be used as inhouse API.
+    /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
     [EditorBrowsable(EditorBrowsableState.Never)]
     public class ImageLoading
     {
@@ -37,7 +37,7 @@ namespace Tizen.NUI
         /// <param name="orientationCorrection">Reorient the image to respect any orientation metadata in its header.</param>
         /// <returns>Handle to the loaded PixelBuffer object or an empty handle in case loading failed.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static PixelBuffer LoadImageFromFile(string url, Size2D size, FittingModeType fittingMode, SamplingModeType samplingMode, bool orientationCorrection)
         {
@@ -74,7 +74,7 @@ namespace Tizen.NUI
         /// <param name="fittingMode">The method used to fit the shape of the image before loading to the shape defined by the size parameter.</param>
         /// <returns>Handle to the loaded PixelBuffer object or an empty handle in case loading failed.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static PixelBuffer LoadImageFromFile(string url, Size2D size, FittingModeType fittingMode)
         {
@@ -91,7 +91,7 @@ namespace Tizen.NUI
         /// <param name="size">The width and height to fit the loaded image to, 0.0 means whole image.</param>
         /// <returns>Handle to the loaded PixelBuffer object or an empty handle in case loading failed.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static PixelBuffer LoadImageFromFile(string url, Size2D size)
         {
@@ -107,7 +107,7 @@ namespace Tizen.NUI
         /// <param name="url">The URL of the image file to load.</param>
         /// <returns>Handle to the loaded PixelBuffer object or an empty handle in case loading failed.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static PixelBuffer LoadImageFromFile(string url)
         {
@@ -120,13 +120,13 @@ namespace Tizen.NUI
         /// Determine the size of an image that LoadImageFromFile will provide when given the same image loading parameters.
         /// </summary>
         /// <param name="filename">The name of the image.</param>
-        /// <param name="size">The requested size for the image</param>
+        /// <param name="size">The requested size for the image.</param>
         /// <param name="fittingMode">The method to use to map the source image to the desired dimensions.</param>
         /// <param name="samplingMode">The image filter to use if the image needs to be downsampled to the requested size.</param>
-        /// <param name="orientationCorrection">Whether to use image metadata to rotate or flip the image, e.g., from portrait to landscape.</param>
+        /// <param name="orientationCorrection">Whether to use image metadata to rotate or flip the image, for example, from portrait to landscape.</param>
         /// <returns>Dimensions that image will have if it is loaded with given parameters.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static Size2D GetClosestImageSize(string filename, Size2D size, FittingModeType fittingMode, SamplingModeType samplingMode, bool orientationCorrection)
         {
@@ -146,7 +146,7 @@ namespace Tizen.NUI
         /// <param name="samplingMode">The image filter to use if the image needs to be downsampled to the requested size.</param>
         /// <returns>Dimensions that image will have if it is loaded with given parameters.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static Size2D GetClosestImageSize(string filename, Size2D size, FittingModeType fittingMode, SamplingModeType samplingMode)
         {
@@ -165,7 +165,7 @@ namespace Tizen.NUI
         /// <param name="fittingMode">The method to use to map the source image to the desired dimensions.</param>
         /// <returns>Dimensions that image will have if it is loaded with given parameters.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static Size2D GetClosestImageSize(string filename, Size2D size, FittingModeType fittingMode)
         {
@@ -183,7 +183,7 @@ namespace Tizen.NUI
         /// <param name="size">The requested size for the image</param>
         /// <returns>Dimensions that image will have if it is loaded with given parameters.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static Size2D GetClosestImageSize(string filename, Size2D size)
         {
@@ -200,7 +200,7 @@ namespace Tizen.NUI
         /// <param name="filename">The name of the image.</param>
         /// <returns>Dimensions that image will have if it is loaded with given parameters.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static Size2D GetClosestImageSize(string filename)
         {
@@ -220,7 +220,7 @@ namespace Tizen.NUI
         /// <param name="orientationCorrection">Reorient the image to respect any orientation metadata in its header.</param>
         /// <returns>Handle to the loaded PixelBuffer object or an empty handle in case downloading or decoding failed.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static PixelBuffer DownloadImageSynchronously(string url, Size2D size, FittingModeType fittingMode, SamplingModeType samplingMode, bool orientationCorrection)
         {
@@ -239,7 +239,7 @@ namespace Tizen.NUI
         /// <param name="samplingMode">The filtering method used when sampling pixels from the input image while fitting it to desired size.</param>
         /// <returns>Handle to the loaded PixelBuffer object or an empty handle in case downloading or decoding failed.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static PixelBuffer DownloadImageSynchronously(string url, Size2D size, FittingModeType fittingMode, SamplingModeType samplingMode)
         {
@@ -257,7 +257,7 @@ namespace Tizen.NUI
         /// <param name="fittingMode">The method used to fit the shape of the image before loading to the shape defined by the size parameter.</param>
         /// <returns>Handle to the loaded PixelBuffer object or an empty handle in case downloading or decoding failed.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static PixelBuffer DownloadImageSynchronously(string url, Size2D size, FittingModeType fittingMode)
         {
@@ -274,7 +274,7 @@ namespace Tizen.NUI
         /// <param name="size">The width and height to fit the loaded image to, 0.0 means whole image.</param>
         /// <returns>Handle to the loaded PixelBuffer object or an empty handle in case downloading or decoding failed.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static PixelBuffer DownloadImageSynchronously(string url, Size2D size)
         {
@@ -290,7 +290,7 @@ namespace Tizen.NUI
         /// <param name="url">The URL of the image file to load.</param>
         /// <returns>Handle to the loaded PixelBuffer object or an empty handle in case downloading or decoding failed.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static PixelBuffer DownloadImageSynchronously(string url)
         {
@@ -304,7 +304,7 @@ namespace Tizen.NUI
         /// </summary>
         /// <param name="size">The maximum texture size to set.</param>
         /// <since_tizen> 5 </since_tizen>
-        /// This will be released at Tizen.NET API Level 5, so currently this would be used as inhouse API.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static void SetMaxTextureSize(uint size)
         {
@@ -317,7 +317,7 @@ namespace Tizen.NUI
         /// </summary>
         /// <returns>The maximum texture size.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static uint GetMaxTextureSize()
         {
index c101267..8f68927 100755 (executable)
@@ -54,7 +54,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Dispose
+        /// Dispose.
         /// </summary>
         /// <param name="type">Dispose Type</param>
         /// <since_tizen> 3 </since_tizen>
@@ -527,7 +527,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Destroy the context of the IMF.<br/>
+        /// Destroys the context of the IMF.<br/>
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         public void DestroyContext()
index ae10445..e7e5794 100755 (executable)
@@ -22,7 +22,7 @@ using System.ComponentModel;
 namespace Tizen.NUI
 {
     /// <summary>
-    /// Specifically manages the input method framework which enables the virtual or hardware keyboards.
+    /// Specifically manages the input method framework (IMF) that enables the virtual or hardware keyboards.
     /// </summary>
     /// <since_tizen> 5 </since_tizen>
     public class InputMethodContext : BaseHandle
@@ -57,7 +57,7 @@ namespace Tizen.NUI
 
             if (type == DisposeTypes.Explicit)
             {
-                //Called by User
+                //Called by User.
                 //Release your own managed resources here.
                 //You should release all of your own disposable objects here.
 
@@ -65,7 +65,7 @@ namespace Tizen.NUI
 
             //Release your own unmanaged resources here.
             //You should not access any managed member here except static instance.
-            //because the execution order of Finalizes is non-deterministic.
+            //Because the execution order of Finalizes is non-deterministic.
 
             if (_keyboardTypeChangedEventCallback != null)
             {
@@ -109,10 +109,10 @@ namespace Tizen.NUI
                 return (obj == null) ? new global::System.Runtime.InteropServices.HandleRef(null, IntPtr.Zero) : obj.swigCPtr;
             }
 
-            //A Flag to check who called Dispose(). (By User or DisposeQueue)
+            //A flag to check who called Dispose(). (By User or DisposeQueue)
             private bool isDisposeQueued = false;
             /// <summary>
-            /// A Flat to check if it is already disposed.
+            /// A flag to check if it is already disposed.
             /// </summary>
             /// <since_tizen> 5 </since_tizen>
             protected bool disposed = false;
@@ -166,7 +166,7 @@ namespace Tizen.NUI
 
                 if (type == DisposeTypes.Explicit)
                 {
-                    //Called by User
+                    //Called by User.
                     //Release your own managed resources here.
                     //You should release all of your own disposable objects here.
 
@@ -328,7 +328,7 @@ namespace Tizen.NUI
             //A Flag to check who called Dispose(). (By User or DisposeQueue)
             private bool isDisposeQueued = false;
             /// <summary>
-            /// A Flat to check if it is already disposed.
+            /// A Flag to check if it is already disposed.
             /// </summary>
             /// <since_tizen> 5 </since_tizen>
             protected bool disposed = false;
@@ -383,7 +383,7 @@ namespace Tizen.NUI
 
                 if (type == DisposeTypes.Explicit)
                 {
-                    //Called by User
+                    //Called by User.
                     //Release your own managed resources here.
                     //You should release all of your own disposable objects here.
 
@@ -391,7 +391,7 @@ namespace Tizen.NUI
 
                 //Release your own unmanaged resources here.
                 //You should not access any managed member here except static instance.
-                //because the execution order of Finalizes is non-deterministic.
+                //Because the execution order of Finalizes is non-deterministic.
 
                 if (swigCPtr.Handle != IntPtr.Zero)
                 {
@@ -455,7 +455,7 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// The current text string.
+            /// The current cursor position.
             /// </summary>
             /// <since_tizen> 5 </since_tizen>
             public int CursorPosition
@@ -493,7 +493,7 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// Flags if preedit reset is required.
+            /// Flags if the pre-edit reset is required.
             /// </summary>
             /// <since_tizen> 5 </since_tizen>
             public bool PreeditResetRequired
@@ -514,7 +514,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Destroy the context of the IMF.<br/>
+        /// Destroys the context of the IMF.<br/>
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         public void DestroyContext()
@@ -524,7 +524,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Destroy the context of the IMF.<br/>
+        /// Destroys the context of the IMF.<br/>
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         /// Please do not use! This will be deprecated, instead please USE Tizen.NUI.InputMethodContext.Instance.DestroyContext()!
@@ -562,8 +562,8 @@ namespace Tizen.NUI
 
         /// <summary>
         /// Activates the IMF.<br/>
-        /// It means that the text editing is started somewhere.<br/>
-        /// If the hardware keyboard isn't connected, then it will show the virtual keyboard.
+        /// It means that the text editing has started.<br/>
+        /// If the hardware keyboard is not connected, then it shows the virtual keyboard.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         public void Activate()
@@ -574,7 +574,7 @@ namespace Tizen.NUI
 
         /// <summary>
         /// Deactivates the IMF.<br/>
-        /// It means that the text editing is finished somewhere.
+        /// It means that the text editing is complete.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         public void Deactivate()
@@ -584,8 +584,8 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Gets the restoration status which controls if the keyboard is restored after the focus is lost and then regained.<br/>
-        /// If true, then the keyboard will be restored (activated) after focus is regained.
+        /// Gets the restoration status, which controls if the keyboard is restored after the focus is lost and then regained.<br/>
+        /// If true, then the keyboard will be restored (activated) after the focus is regained.
         /// </summary>
         /// <returns>The restoration status.</returns>
         /// <since_tizen> 5 </since_tizen>
@@ -599,7 +599,7 @@ namespace Tizen.NUI
         /// <summary>
         /// Sets the status whether the IMF has to restore the keyboard after losing focus.
         /// </summary>
-        /// <param name="toggle">True means that keyboard should be restored after the focus is lost and regained.</param>
+        /// <param name="toggle">True means that keyboard must be restored after the focus is lost and regained.</param>
         /// <since_tizen> 5 </since_tizen>
         public void SetRestoreAfterFocusLost(bool toggle)
         {
@@ -608,7 +608,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Sends a message reset to the preedit state or the IMF module.
+        /// Sends a message reset to the pre-edit state or the IMF module.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         public new void Reset()
@@ -618,7 +618,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Notifies the IMF context that the cursor position has changed, required for features like auto-capitalization.
+        /// Notifies the IMF context that the cursor position has changed, required for features such as auto-capitalization.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         public void NotifyCursorPosition()
@@ -685,7 +685,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Returns the text direction of the keyboard's current input language.
+        /// Returns the text direction of the current input language of the keyboard.
         /// </summary>
         /// <returns>The direction of the text.</returns>
         /// <since_tizen> 5 </since_tizen>
@@ -701,9 +701,9 @@ namespace Tizen.NUI
         /// The position is relative to whether the keyboard is visible or not.<br/>
         /// If the keyboard is not visible, then the position will be off the screen.<br/>
         /// If the keyboard is not being shown when this method is called, the keyboard is partially setup (IMFContext) to get/>
-        /// the values then taken down. So ideally, GetInputMethodArea() should be called after Show().
+        /// the values then taken down. So ideally, GetInputMethodArea() must be called after Show().
         /// </summary>
-        /// <returns>Rectangle which is keyboard panel x, y, width, height.</returns>
+        /// <returns>Rectangle which is keyboard panel x, y, width, and height.</returns>
         /// <since_tizen> 5 </since_tizen>
         public Rectangle GetInputMethodArea()
         {
@@ -719,7 +719,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Sets up the input-panel specific data.
+        /// Sets up the input panel specific data.
         /// </summary>
         /// <param name="text">The specific data to be set to the input panel.</param>
         /// <since_tizen> 5 </since_tizen>
@@ -754,7 +754,7 @@ namespace Tizen.NUI
 
         /// <summary>
         /// Sets the return key on the input panel to be visible or invisible.<br/>
-        /// The default is true.
+        /// The default value is true.
         /// </summary>
         /// <param name="visible">True if the return key is visible (enabled), false otherwise.</param>
         /// <since_tizen> 5 </since_tizen>
@@ -810,7 +810,7 @@ namespace Tizen.NUI
 
         /// <summary>
         /// Gets the current language locale of the input panel.<br/>
-        /// For example, en_US, en_GB, en_PH, fr_FR, ...
+        /// For example, en_US, en_GB, en_PH, fr_FR, and so on.
         /// </summary>
         /// <returns>The current language locale of the input panel.</returns>
         /// <since_tizen> 5 </since_tizen>
@@ -835,7 +835,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Gets/Sets whether the IM context allow to use the text prediction.
+        /// Gets or sets whether the IM context allows to use the text prediction.
         /// </summary>
         /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
         [EditorBrowsable(EditorBrowsableState.Never)]
@@ -923,7 +923,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// InputMethodContext event received event arguments.
+        /// InputMethodContext event receives event arguments.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         public class EventReceivedEventArgs : EventArgs
@@ -939,7 +939,7 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// EventData
+            /// EventData.
             /// </summary>
             /// <since_tizen> 5 </since_tizen>
             public EventData EventData
@@ -1023,7 +1023,7 @@ namespace Tizen.NUI
         public class StatusChangedEventArgs : EventArgs
         {
             /// <summary>
-            /// InputMethodContext status
+            /// InputMethodContext status.
             /// </summary>
             /// <since_tizen> 5 </since_tizen>
             public bool StatusChanged
@@ -1084,7 +1084,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// InputMethodContext resized event.
+        /// InputMethodContext resized event arguments.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         public class ResizedEventArgs : EventArgs
@@ -1150,13 +1150,13 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// InputMethodContext language changed event args.
+        /// InputMethodContext language changed event arguments.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         public class LanguageChangedEventArgs : EventArgs
         {
             /// <summary>
-            /// language changed.
+            /// Language changed.
             /// </summary>
             /// <since_tizen> 5 </since_tizen>
             public int LanguageChanged
@@ -1222,7 +1222,7 @@ namespace Tizen.NUI
         public class KeyboardTypeChangedEventArgs : EventArgs
         {
             /// <summary>
-            /// InputMethodContext keyboard type
+            /// InputMethodContext keyboard type.
             /// </summary>
             /// <since_tizen> 5 </since_tizen>
             public KeyboardType KeyboardType
@@ -1310,7 +1310,7 @@ namespace Tizen.NUI
             /// <since_tizen> 5 </since_tizen>
             Void,
             /// <summary>
-            /// Pre-Edit changed.
+            /// Pre-edit changed.
             /// </summary>
             /// <since_tizen> 5 </since_tizen>
             Preedit,
index 95ce253..052baf2 100755 (executable)
@@ -93,7 +93,7 @@ namespace Tizen.NUI
             private LongPressGesture _longPressGesture;
 
             /// <summary>
-            /// View the attached view.
+            /// View the attached view.
             /// </summary>
             /// <since_tizen> 5 </since_tizen>
             /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
@@ -145,7 +145,7 @@ namespace Tizen.NUI
             {
                 lock (this)
                 {
-                    // Restricted to only one listener
+                    // Restricted to only one listener.
                     if (_longPressGestureEventHandler == null)
                     {
                         _longPressGestureEventHandler += value;
@@ -174,13 +174,13 @@ namespace Tizen.NUI
         {
             DetectedEventArgs e = new DetectedEventArgs();
 
-            // Populate all members of "e" (LongPressGestureEventArgs) with real data
+            // Populate all members of "e" (LongPressGestureEventArgs) with real data.
             e.View = Registry.GetManagedBaseHandleFromNativePtr(actor) as View;
             e.LongPressGesture = Tizen.NUI.LongPressGesture.GetLongPressGestureFromPtr(longPressGesture);
 
             if (_longPressGestureEventHandler != null)
             {
-                //here we send all data to user event handlers
+                //Here we send all data to user event handlers.
                 _longPressGestureEventHandler(this, e);
             }
 
@@ -208,7 +208,7 @@ namespace Tizen.NUI
         /// Creates an initialized LongPressGestureDetector with the number of touches required.<br />
         /// A long press gesture will be emitted from this detector if the number of fingers touching the screen is equal to the touches required.<br />
         /// </summary>
-        /// <param name="touchesRequired">The number of touches required</param>
+        /// <param name="touchesRequired">The number of touches required.</param>
         /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public LongPressGestureDetector(uint touchesRequired) : this(NDalicPINVOKE.LongPressGestureDetector_New__SWIG_1(touchesRequired), true)
@@ -221,8 +221,8 @@ namespace Tizen.NUI
         /// Creates an initialized LongPressGestureDetector with the minimum and maximum number of touches required.<br />
         /// A long press gesture will be emitted from this detector if the number of fingers touching the screen falls between the minimum and maximum touches set.<br />
         /// </summary>
-        /// <param name="minTouches">The minimum number of touches required</param>
-        /// <param name="maxTouches">The maximum number of touches required</param>
+        /// <param name="minTouches">The minimum number of touches required.</param>
+        /// <param name="maxTouches">The maximum number of touches required.</param>
         /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public LongPressGestureDetector(uint minTouches, uint maxTouches) : this(NDalicPINVOKE.LongPressGestureDetector_New__SWIG_2(minTouches, maxTouches), true)
@@ -258,7 +258,7 @@ namespace Tizen.NUI
 
         /// <summary>
         /// Sets the number of touches required.<br />
-        /// The number of touches corresponds to the number of fingers a user has on the screen. The default is 1.<br />
+        /// The number of touches corresponds to the number of fingers a user has on the screen. The default value is 1.<br />
         /// </summary>
         /// <param name="touches">Touches required</param>
         /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
@@ -272,8 +272,8 @@ namespace Tizen.NUI
         /// <summary>
         /// Sets the minimum and maximum touches required.
         /// </summary>
-        /// <param name="minTouches">Minimum Touches required</param>
-        /// <param name="maxTouches">Maximum Touches required</param>
+        /// <param name="minTouches">Minimum touches required.</param>
+        /// <param name="maxTouches">Maximum touches required.</param>
         /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public void SetTouchesRequired(uint minTouches, uint maxTouches)
index bd2d361..2737672 100755 (executable)
@@ -62,10 +62,10 @@ namespace Tizen.NUI
         private Size2D _windowSize2D = null;
         private Position2D _windowPosition2D = null;
         /// <summary>
-        /// The constructor with window size and position
+        /// The constructor with window size and position.
         /// </summary>
-        /// <param name="windowSize">The window size</param>
-        /// <param name="windowPosition">The window position</param>
+        /// <param name="windowSize">The window size.</param>
+        /// <param name="windowPosition">The window position.</param>
         /// <since_tizen> 5 </since_tizen>
         /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
         [EditorBrowsable(EditorBrowsableState.Never)]
@@ -87,11 +87,11 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// The constructor with a stylesheet, window size and position
+        /// The constructor with a stylesheet, window size, and position.
         /// </summary>
-        /// <param name="styleSheet">The styleSheet url.</param>
-        /// <param name="windowSize">The window size</param>
-        /// <param name="windowPosition">The window position</param>
+        /// <param name="styleSheet">The styleSheet URL.</param>
+        /// <param name="windowSize">The window size.</param>
+        /// <param name="windowPosition">The window position.</param>
         /// <since_tizen> 5 </since_tizen>
         /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
         [EditorBrowsable(EditorBrowsableState.Never)]
@@ -114,12 +114,12 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// The constructor with a stylesheet, window mode, window size and position
+        /// The constructor with a stylesheet, window mode, window size, and position.
         /// </summary>
-        /// <param name="styleSheet">The styleSheet url</param>
-        /// <param name="windowMode">The windowMode</param>
-        /// <param name="windowSize">The window size</param>
-        /// <param name="windowPosition">The window position</param>
+        /// <param name="styleSheet">The styleSheet URL.</param>
+        /// <param name="windowMode">The windowMode.</param>
+        /// <param name="windowSize">The window size.</param>
+        /// <param name="windowPosition">The window position.</param>
         /// <since_tizen> 5 </since_tizen>
         /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
         [EditorBrowsable(EditorBrowsableState.Never)]
index 305209f..4aaefc0 100755 (executable)
@@ -651,18 +651,18 @@ namespace Tizen.NUI
     }
 
     /// <summary>
-    /// Specifies the Release Policy types <br />
-    /// Decides if the image should be cached in different conditions
+    /// Specifies the release policy types.<br />
+    /// Decides if the image should be cached in different conditions.
     /// </summary>
     /// <since_tizen> 5 </since_tizen>
     public enum ReleasePolicyType
     {
       /// <summary>
-      /// Image is released when visual detached from scene
+      /// Image is released when visual detached from scene.
       /// </summary>
       Detached = 0,
       /// <summary>
-      /// Image is only released when visual is destroyed
+      /// Image is only released when visual is destroyed.
       /// </summary>
       Destroyed,
       /// <summary>
@@ -672,8 +672,8 @@ namespace Tizen.NUI
     }
 
     /// <summary>
-    /// Specifies the Load Policy types <br />
-    /// Decides when the image texture should be loaded
+    /// Specifies the load policy types.<br />
+    /// Decides when the image texture should be loaded.
     /// </summary>
     /// <since_tizen> 5 </since_tizen>
     public enum LoadPolicyType
@@ -809,7 +809,7 @@ namespace Tizen.NUI
     }
 
     /// <summary>
-    /// The values of this enum determine how the visual should be fit to the view.
+    /// The values of this enum determines how the visual should fit into the view.
     /// </summary>
     /// <since_tizen> 5 </since_tizen>
     /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
@@ -964,7 +964,7 @@ namespace Tizen.NUI
             /// </summary>
             Text,
             /// <summary>
-            /// Renders an n-patch image.
+            /// Renders an NPatch image.
             /// </summary>
             NPatch,
             /// <summary>
@@ -1299,23 +1299,23 @@ namespace Tizen.NUI
         /// <since_tizen> 4 </since_tizen>
         public static readonly int FrameDelay = NDalic.IMAGE_VISUAL_FRAME_DELAY;
         /// <summary>
-        /// The number of times the AnimatedImageVisual will be looped
-        /// Default -1. if less than 0, loop unlimited. else, loop loopCount times.
+        /// The number of times the AnimatedImageVisual will be looped.
+        /// The default is -1. If the value is less than 0, loop unlimited. Otherwise, loop loopCount times.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         public static readonly int LoopCount = NDalic.IMAGE_VISUAL_LOOP_COUNT;
         /// <summary>
-        /// The policy to determine when an image should no longer be cached
+        /// The policy to determine when an image should no longer be cached.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         public static readonly int ReleasePolicy = NDalic.IMAGE_VISUAL_RELEASE_POLICY;
         /// <summary>
-        /// The policy to determine when an image should be loaded
+        /// The policy to determine when an image should be loaded.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         public static readonly int LoadPolicy = NDalic.IMAGE_VISUAL_LOAD_POLICY;
         /// <summary>
-        /// Determines if image orientation should be corrected so the image displays as it was intended
+        /// Determines if image orientation should be corrected so that the image displays as it was intended.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         public static readonly int OrientationCorrection = NDalic.IMAGE_VISUAL_ORIENTATION_CORRECTION;
@@ -2484,7 +2484,7 @@ namespace Tizen.NUI
     }
 
     /// <summary>
-    /// An enum of text direction.
+    /// An enum of text directions.
     /// </summary>
     /// <since_tizen> 5 </since_tizen>
     public enum TextDirection
@@ -2503,7 +2503,7 @@ namespace Tizen.NUI
     }
 
     /// <summary>
-    /// An enum of vertical line alignment.
+    /// An enum of vertical line alignments.
     /// </summary>
     /// <since_tizen> 5 </since_tizen>
     public enum VerticalLineAlignment
@@ -2722,7 +2722,7 @@ namespace Tizen.NUI
     }
 
     /// <summary>
-    /// Enumeration type for the glyph type
+    /// Enumeration type for the glyph type.
     /// </summary>
     /// <since_tizen> 5 </since_tizen>
     public enum GlyphType
index 92b88ef..ffb8d77 100755 (executable)
@@ -81,7 +81,7 @@ namespace Tizen.NUI
 
 
         /// <summary>
-        /// Event arguments that passed via the PanGestureEvent signal.
+        /// Event arguments that are passed via the PanGestureEvent signal.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
index 719e6fc..133164f 100755 (executable)
@@ -63,7 +63,7 @@ namespace Tizen.NUI
 
             //Release your own unmanaged resources here.
             //You should not access any managed member here except static instance.
-            //because the execution order of Finalizes is non-deterministic.
+            //Because the execution order of Finalizes is non-deterministic.
 
 
             if (swigCPtr.Handle != global::System.IntPtr.Zero)
@@ -172,13 +172,13 @@ namespace Tizen.NUI
         {
             DetectedEventArgs e = new DetectedEventArgs();
 
-            // Populate all members of "e" (DetectedEventArgs) with real data
+            // Populate all members of "e" (DetectedEventArgs) with real data.
             e.View = Registry.GetManagedBaseHandleFromNativePtr(actor) as View;
             e.PinchGesture = Tizen.NUI.PinchGesture.GetPinchGestureFromPtr(pinchGesture);
 
             if (_pinchGestureEventHandler != null)
             {
-                //here we send all data to user event handlers
+                //Here we send all data to user event handlers.
                 _pinchGestureEventHandler(this, e);
             }
 
index 6b5942c..79d977a 100755 (executable)
@@ -21,18 +21,18 @@ namespace Tizen.NUI
 
     /// <summary>
     /// The PixelBuffer object holds a pixel buffer.
-    /// The PixelBuffer keeps ownership of it's initial buffer however, the
-    /// user is free to modify the pixel data, either directly, or via image operations.
+    /// The PixelBuffer keeps ownership of its initial buffer. However, the
+    /// user is free to modify the pixel data, either directly or via image operations.
     ///
-    /// In order to upload the pixel data to texture memory, there are two
-    /// possibilities - either convert it back to a PixelData object, which
+    /// In order to upload the pixel data to the texture memory, there are two
+    /// possibilities, either convert it back to a PixelData object, which
     /// releases the PixelBuffer object, leaving the user with an empty handle
-    /// (ideal for one-time indirect image manipulation), or create a new
+    /// (ideal for one-time indirect image manipulation) or create a new
     /// PixelData object from this object, leaving the buffer intact (ideal
-    /// for continuous manipulation)
+    /// for continuous manipulation).
     /// </summary>
     /// <since_tizen> 5 </since_tizen>
-    /// This will be released at Tizen.NET API Level 5, so currently this would be used as inhouse API.
+    /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
     [EditorBrowsable(EditorBrowsableState.Never)]
     public class PixelBuffer : BaseHandle
     {
@@ -61,7 +61,7 @@ namespace Tizen.NUI
 
             if (type == DisposeTypes.Explicit)
             {
-                //Called by User
+                //Called by User.
                 //Release your own managed resources here.
                 //You should release all of your own disposable objects here.
 
@@ -69,7 +69,7 @@ namespace Tizen.NUI
 
             //Release your own unmanaged resources here.
             //You should not access any managed member here except static instance.
-            //because the execution order of Finalizes is non-deterministic.
+            //Because the execution order of Finalizes is non-deterministic.
             if (swigCPtr.Handle != global::System.IntPtr.Zero)
             {
                 if (swigCMemOwn)
@@ -84,13 +84,13 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Create a PixelBuffer with it's own data buffer.
+        /// Create a PixelBuffer with its own data buffer.
         /// </summary>
-        /// <param name="width">The pixel buffer width</param>
-        /// <param name="height">The pixel buffer height</param>
-        /// <param name="pixelFormat">The pixel format</param>
+        /// <param name="width">The pixel buffer width.</param>
+        /// <param name="height">The pixel buffer height.</param>
+        /// <param name="pixelFormat">The pixel format.</param>
         /// <since_tizen> 5 </since_tizen>
-        /// This will be released at Tizen.NET API Level 5, so currently this would be used as inhouse API.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public PixelBuffer(uint width, uint height, PixelFormat pixelFormat) : this(NDalicPINVOKE.PixelBuffer_New(width, height, (int)pixelFormat), true)
         {
@@ -110,15 +110,15 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Convert to a pixel data and release the pixelBuffer's object.
+        /// Convert to a pixel data and release the object of the pixelBuffer.
         /// This handle is left empty.
         /// Any other handles that keep a reference to this object
-        /// will be left with no buffer, trying to access it will return NULL.
+        /// will be left with no buffer. Trying to access it will return NULL.
         /// </summary>
-        /// <param name="pixelBuffer">A pixel buffer</param>
-        /// <returns>A new PixelData which takes ownership of the PixelBuffer's buffer.</returns>
+        /// <param name="pixelBuffer">A pixel buffer.</param>
+        /// <returns>A new PixelData that takes ownership of the buffer of the pixelBuffer.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public static PixelData Convert(PixelBuffer pixelBuffer)
         {
@@ -133,7 +133,7 @@ namespace Tizen.NUI
         /// </summary>
         /// <returns>The pixel data.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public PixelData CreatePixelData()
         {
@@ -155,7 +155,7 @@ namespace Tizen.NUI
         /// </summary>
         /// <returns>The width of the buffer in pixels.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public uint GetWidth()
         {
@@ -169,7 +169,7 @@ namespace Tizen.NUI
         /// </summary>
         /// <returns>The height of the buffer in pixels.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public uint GetHeight()
         {
@@ -183,7 +183,7 @@ namespace Tizen.NUI
         /// </summary>
         /// <returns>The pixel format.</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.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public PixelFormat GetPixelFormat()
         {
@@ -193,21 +193,21 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Apply the mask to this pixel data, and return a new pixel data containing
-        /// the masked image. If this PixelBuffer doesn't have an alpha channel, then
+        /// Apply the mask to this pixel data and return a new pixel data that contains
+        /// the masked image. If this PixelBuffer does not have an alpha channel, then
         /// the resultant PixelBuffer will be converted to a format that supports at
         /// least the width of the color channels and the alpha channel from the mask.
         ///
-        /// If cropToMask is set to true, then the contentScale is applied first to
+        /// If cropToMask is set to <c>true</c>, then the contentScale is applied first to
         /// this buffer, and the target buffer is cropped to the size of the mask. If
-        /// it's set to false, then the mask is scaled to match this buffer's size
+        /// it is set to <c>false</c>, then the mask is scaled to match the size of this buffer
         /// before the mask is applied.
         /// </summary>
         /// <param name="mask">The mask to apply.</param>
         /// <param name="contentScale">The scaling factor to apply to the content.</param>
         /// <param name="cropToMask">Whether to crop the output to the mask size (true) or scale the mask to the content size (false).</param>
         /// <since_tizen> 5 </since_tizen>
-        /// This will be released at Tizen.NET API Level 5, so currently this would be used as inhouse API.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public void ApplyMask(PixelBuffer mask, float contentScale, bool cropToMask)
         {
@@ -216,20 +216,20 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Apply the mask to this pixel data, and return a new pixel data containing
-        /// the masked image. If this PixelBuffer doesn't have an alpha channel, then
+        /// Apply the mask to this pixel data and return a new pixel data containing
+        /// the masked image. If this PixelBuffer does not have an alpha channel, then
         /// the resultant PixelBuffer will be converted to a format that supports at
         /// least the width of the color channels and the alpha channel from the mask.
         ///
-        /// If cropToMask is set to true, then the contentScale is applied first to
+        /// If cropToMask is set to <c>true</c>, then the contentScale is applied first to
         /// this buffer, and the target buffer is cropped to the size of the mask. If
-        /// it's set to false, then the mask is scaled to match this buffer's size
+        /// it is set to <c>false</c>, then the mask is scaled to match the size of this buffer
         /// before the mask is applied.
         /// </summary>
         /// <param name="mask">The mask to apply.</param>
         /// <param name="contentScale">The scaling factor to apply to the content.</param>
         /// <since_tizen> 5 </since_tizen>
-        /// This will be released at Tizen.NET API Level 5, so currently this would be used as inhouse API.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public void ApplyMask(PixelBuffer mask, float contentScale)
         {
@@ -238,19 +238,19 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Apply the mask to this pixel data, and return a new pixel data containing
-        /// the masked image. If this PixelBuffer doesn't have an alpha channel, then
+        /// Apply the mask to this pixel data and return a new pixel data containing
+        /// the masked image. If this PixelBuffer does not have an alpha channel, then
         /// the resultant PixelBuffer will be converted to a format that supports at
         /// least the width of the color channels and the alpha channel from the mask.
         ///
-        /// If cropToMask is set to true, then the contentScale is applied first to
+        /// If cropToMask is set to <c>true</c>, then the contentScale is applied first to
         /// this buffer, and the target buffer is cropped to the size of the mask. If
-        /// it's set to false, then the mask is scaled to match this buffer's size
+        /// it is set to <c>false</c>, then the mask is scaled to match the size of this buffer
         /// before the mask is applied.
         /// </summary>
         /// <param name="mask">The mask to apply.</param>
         /// <since_tizen> 5 </since_tizen>
-        /// This will be released at Tizen.NET API Level 5, so currently this would be used as inhouse API.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public void ApplyMask(PixelBuffer mask)
         {
@@ -264,7 +264,7 @@ namespace Tizen.NUI
         /// </summary>
         /// <param name="blurRadius">The radius for Gaussian blur. A value of 0 or negative value indicates no blur.</param>
         /// <since_tizen> 5 </since_tizen>
-        /// This will be released at Tizen.NET API Level 5, so currently this would be used as inhouse API.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public void ApplyGaussianBlur(float blurRadius)
         {
@@ -280,7 +280,7 @@ namespace Tizen.NUI
         /// <param name="width">The crop width.</param>
         /// <param name="height">The crop height.</param>
         /// <since_tizen> 5 </since_tizen>
-        /// This will be released at Tizen.NET API Level 5, so currently this would be used as inhouse API.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public void Crop(ushort x, ushort y, ushort width, ushort height)
         {
@@ -294,7 +294,7 @@ namespace Tizen.NUI
         /// <param name="width">The new width.</param>
         /// <param name="height">The new height.</param>
         /// <since_tizen> 5 </since_tizen>
-        /// This will be released at Tizen.NET API Level 5, so currently this would be used as inhouse API.
+        /// This will be released at Tizen.NET API Level 5. Therefore, currently this would be used as an in-house API.
         [EditorBrowsable(EditorBrowsableState.Never)]
         public void Resize(ushort width, ushort height)
         {
index 9754a3c..b5c776e 100755 (executable)
@@ -21,7 +21,7 @@ namespace Tizen.NUI
     /// <summary>
     ///  The PixelData object holds a pixel buffer.<br />
     ///  The PixelData takes over the ownership of the pixel buffer.<br />
-    ///  The buffer memory must NOT be released outside of this class, instead,
+    ///  The buffer memory must not be released outside of this class, instead,
     ///  the PixelData object will release it automatically when the reference count falls to zero.
     /// </summary>
     /// Please DO NOT use! This will be deprecated!
@@ -59,7 +59,7 @@ namespace Tizen.NUI
 
             if (type == DisposeTypes.Explicit)
             {
-                //Called by User
+                //Called by User.
                 //Release your own managed resources here.
                 //You should release all of your own disposable objects here.
 
@@ -67,7 +67,7 @@ namespace Tizen.NUI
 
             //Release your own unmanaged resources here.
             //You should not access any managed member here except static instance.
-            //because the execution order of Finalizes is non-deterministic.
+            //Because the execution order of Finalizes is non-deterministic.
 
 
             if (swigCPtr.Handle != global::System.IntPtr.Zero)
@@ -144,7 +144,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Enumeration for Function to release the pixel buffer.
+        /// Enumeration for function to release the pixel buffer.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         /// This will be released at Tizen.NET API Level 5, so currently this would be used as inhouse API.
index d8f381d..dd9c2de 100755 (executable)
@@ -1792,7 +1792,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Retrieves a Rotation value.
+        /// Retrieves a rotation value.
         /// </summary>
         /// <param name="quaternionValue">On return, a rotation value.</param>
         /// <returns>Returns true if the value is successfully retrieved, false if the type is not convertible.</returns>
index 4e57e16..49580b9 100644 (file)
@@ -140,13 +140,13 @@ namespace Tizen.NUI
         {
             StyleChangedEventArgs e = new StyleChangedEventArgs();
 
-            // Populate all members of "e" (StyleChangedEventArgs) with real data
+            // Populate all members of "e" (StyleChangedEventArgs) with real data.
             e.StyleManager = Registry.GetManagedBaseHandleFromNativePtr(styleManager) as StyleManager;
             e.StyleChange = styleChange;
 
             if (_styleManagerStyleChangedEventHandler != null)
             {
-                //here we send all data to user event handlers
+                //Here we send all data to user event handlers.
                 _styleManagerStyleChangedEventHandler(this, e);
             }
         }
index f4c85d5..460cf20 100755 (executable)
@@ -81,7 +81,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Event arguments that passed via the TapGestureEvent signal.
+        /// Event arguments that are passed via the TapGestureEvent signal.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
index e2fa49c..8944ea9 100755 (executable)
@@ -263,9 +263,9 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Get mouse device's button value (ex: right/left button)
+        /// Get mouse device's button value (for example, right or left button)
         /// </summary>
-        /// <param name="point">The point required</param>
+        /// <param name="point">The point required.</param>
         /// <returns></returns>
         /// <since_tizen> 5 </since_tizen>
         /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
@@ -280,7 +280,7 @@ namespace Tizen.NUI
     }
 
     /// <summary>
-    /// Mouse device button type
+    /// Mouse device button type.
     /// </summary>
     /// <since_tizen> 5 </since_tizen>
     /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
@@ -288,22 +288,22 @@ namespace Tizen.NUI
     public enum MouseButton
     {
         /// <summary>
-        /// No mouse button event or invalid data
+        /// No mouse button event or invalid data.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         Invalid = -1,
         /// <summary>
-        /// Primary(Left) mouse button
+        /// Primary(Left) mouse button.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         Primary = 1,
         /// <summary>
-        /// Secondary(Right) mouse button
+        /// Secondary(Right) mouse button.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         Secondary = 3,
         /// <summary>
-        /// Center(Wheel) mouse button
+        /// Center(Wheel) mouse button.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         Tertiary = 2,
index da62412..b16e752 100755 (executable)
@@ -614,7 +614,7 @@ namespace Tizen.NUI
 
         /// <summary>
         /// The fitting mode of the visual.
-        /// The default is defined by the type of visual (if it's suitable to be stretched or not).
+        /// The default is defined by the type of visual (if it is suitable to be stretched or not).
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
@@ -701,7 +701,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Overlays the auxiliary iamge on top of an NPatch image.
+        /// Overlays the auxiliary image on top of an NPatch image.
         /// The resulting visual image will be at least as large as the smallest possible n-patch or the auxiliary image, whichever is larger.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
@@ -955,8 +955,8 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Get or set the Image Visual release policy<br />
-        /// It decides if a texture should be released from the cache or kept to reduce loading time <br />
+        /// Gets or sets the Image Visual release policy.<br/>
+        /// It decides if a texture should be released from the cache or kept to reduce the loading time.<br/>
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         public ReleasePolicyType ReleasePolicy
@@ -974,8 +974,8 @@ namespace Tizen.NUI
 
 
         /// <summary>
-        /// Get or set the Image Visual image loading policy<br />
-        /// It decides if a texture should be loaded immediately after source set or only after visual is added to window <br />
+        /// Gets or sets the Image Visual image loading policy.<br />
+        /// It decides if a texture should be loaded immediately after source set or only after the visual is added to the window.<br />
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         public LoadPolicyType LoadPolicy
@@ -992,7 +992,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Get or set whether to automatically correct the orientation based on exif data.<br />
+        /// Gets or sets whether to automatically correct the orientation based on the Exchangeable Image File (EXIF) data.<br />
         /// If not specified, the default is true.<br />
         /// For JPEG images only.<br />
         /// Optional.
@@ -1012,7 +1012,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Whether to use the texture atlas.
+        /// Whether to use the texture atlas or not.
         /// Optional. By default atlasing is off.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
@@ -1346,7 +1346,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Gets or sets the Underline parameters.
+        /// Gets or sets the underline parameters.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
@@ -1365,7 +1365,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Gets or sets the Outline parameters.
+        /// Gets or sets the outline parameters.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
@@ -1384,7 +1384,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Gets or sets the Background parameters.
+        /// Gets or sets the background parameters.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
@@ -1564,7 +1564,7 @@ namespace Tizen.NUI
 
         /// <summary>
         /// Gets or sets whether to render if the MixColor is transparent.
-        /// By default it's false, i.e. ColorVisual will not render if the MIX_COLOR is transparent.
+        /// By default it is false, which means that the ColorVisual will not render if the MIX_COLOR is transparent.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API.
@@ -2563,8 +2563,8 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Gets and Sets the number of times the AnimatedImageVisual will be looped.
-        /// Default -1. if less than 0, loop unlimited. else, loop loopCount times.
+        /// Gets and sets the number of times the AnimatedImageVisual will be looped.
+        /// The default is -1. If the number is less than 0 then it loops unlimited,otherwise loop loopCount times.
         /// </summary>
         /// <since_tizen> 5 </since_tizen>
         public float LoopCount
index 288407f..8927c14 100755 (executable)
@@ -926,10 +926,10 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Sets keyboard repeat information.
+        /// Sets the keyboard repeat information.
         /// </summary>
-        /// <param name="rate">The key repeat rate value in seconds</param>
-        /// <param name="delay">The key repeat delay value in seconds</param>
+        /// <param name="rate">The key repeat rate value in seconds.</param>
+        /// <param name="delay">The key repeat delay value in seconds.</param>
         /// <returns>True if setting the keyboard repeat succeeds.</returns>
         /// <since_tizen> 5 </since_tizen>
         public bool SetKeyboardRepeatInfo(float rate, float delay)
@@ -940,10 +940,10 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Gets keyboard repeat information.
+        /// Gets the keyboard repeat information.
         /// </summary>
-        /// <param name="rate">The key repeat rate value in seconds</param>
-        /// <param name="delay">The key repeat delay value in seconds</param>
+        /// <param name="rate">The key repeat rate value in seconds.</param>
+        /// <param name="delay">The key repeat delay value in seconds.</param>
         /// <returns>True if setting the keyboard repeat succeeds.</returns>
         /// <since_tizen> 5 </since_tizen>
         public bool GetKeyboardRepeatInfo(out float rate, out float delay)
@@ -1498,7 +1498,7 @@ namespace Tizen.NUI
         /// <summary>
         /// Sets whether the window is transparent or not.
         /// </summary>
-        /// <param name="transparent">Whether the window is transparent.</param>
+        /// <param name="transparent">Whether the window is transparent or not.</param>
         /// <since_tizen> 5 </since_tizen>
         public void SetTransparency(bool transparent) {
             NDalicManualPINVOKE.SetTransparency(swigCPtr, transparent);
@@ -1694,7 +1694,7 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Feed a key-event into the window.
+        /// Feeds a key event into the window.
         /// </summary>
         /// <param name="keyEvent">The key event to feed.</param>
         /// <since_tizen> 5 </since_tizen>