X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=src%2FElmSharp%2FElmSharp%2FLayout.cs;h=b2c6f8e7b96cc67f8811c2da233c2b0a25f93692;hb=4a9d296866c560d5b83b1e16dd27beba8f7caa59;hp=af5ab1018aaceb9701a1a222192f4502e42d6691;hpb=ffb47341007a36f7643ac2f081f0dc641dd3f249;p=platform%2Fcore%2Fcsapi%2Ftizenfx.git

diff --git a/src/ElmSharp/ElmSharp/Layout.cs b/src/ElmSharp/ElmSharp/Layout.cs
index af5ab10..b2c6f8e 100644
--- a/src/ElmSharp/ElmSharp/Layout.cs
+++ b/src/ElmSharp/ElmSharp/Layout.cs
@@ -19,8 +19,8 @@ using System;
 namespace ElmSharp
 {
     /// <summary>
-    /// This is a container widget that takes a standard Edje design file and wraps it very thinly in a widget.
-    /// Inherits Widget
+    /// This is a container widget that takes a standard edje design file and wraps it very thinly in a widget.
+    /// Inherits Widget.
     /// </summary>
     /// <since_tizen> preview </since_tizen>
     public class Layout : Container
@@ -31,16 +31,16 @@ namespace ElmSharp
         IntPtr _edjeHandle;
 
         /// <summary>
-        /// Creates and initializes a new instance of Layout class.
+        /// Creates and initializes a new instance of the Layout class.
         /// </summary>
-        /// <param name="parent">The parent is a given container which will be attached by Layout as a child. It's <see cref="EvasObject"/> type.</param>
+        /// <param name="parent">The parent is a given container, which will be attached by the layout as a child. It's <see cref="EvasObject"/> type.</param>
         /// <since_tizen> preview </since_tizen>
         public Layout(EvasObject parent) : base(parent)
         {
         }
 
         /// <summary>
-        /// Creates and initializes a new instance of Layout class.
+        /// Creates and initializes a new instance of the Layout class.
         /// </summary>
         /// <since_tizen> preview </since_tizen>
         protected Layout() : base()
@@ -74,7 +74,7 @@ namespace ElmSharp
         }
 
         /// <summary>
-        /// Gets or sets accessibility state of texblock(text) parts in the layout object.
+        /// Gets or sets the accessibility state of texblock (text) parts in a layout object.
         /// </summary>
         /// <since_tizen> preview </since_tizen>
         public bool TextBlockAccessibility
@@ -91,10 +91,10 @@ namespace ElmSharp
 
         /// <summary>
         /// Freezes the Elementary layout object.
-        /// This function puts all changes on hold.
+        /// This function puts all the changes on hold.
         /// Successive freezes will nest, requiring an equal number of thaws.
         /// </summary>
-        /// <returns>The frozen state or 0 if the object is not frozen or on error.</returns>
+        /// <returns>The frozen state, or 0 if the object is not frozen or on error.</returns>
         /// <since_tizen> preview </since_tizen>
         public int Freeze()
         {
@@ -105,7 +105,7 @@ namespace ElmSharp
         /// Thaws the Elementary object.
         /// If sucessives freezes were done, an equal number of thaws will be required.
         /// </summary>
-        /// <returns>The frozen state or 0 if the object is not frozen or on error.</returns>
+        /// <returns>The frozen state, or 0 if the object is not frozen or on error.</returns>
         /// <since_tizen> preview </since_tizen>
         public int Thaw()
         {
@@ -117,7 +117,7 @@ namespace ElmSharp
         /// Manually forces a sizing re-evaluation.
         /// This is useful when the minimum size required by the edje theme of this layout has changed.
         /// The change on the minimum size required by the edje theme is not immediately reported to the elementary layout, so one needs to call this function in order to tell the widget (layout) that it needs to reevaluate its own size.
-        /// The minimum size of the theme is calculated based on minimum size of parts, the size of elements inside containers like box and table, etc.
+        /// The minimum size of the theme is calculated based on the minimum size of parts, the size of elements inside containers like the box and table, etc.
         /// All of this can change due to state changes, and that's when this function should be called.
         /// </summary>
         /// <since_tizen> preview </since_tizen>
@@ -127,11 +127,11 @@ namespace ElmSharp
         }
 
         /// <summary>
-        /// Request sizing reevaluation, restricted to current width and/or height.
-        /// Useful mostly when there are TEXTBLOCK parts defining the height of the object and nothing else restricting it to a minimum width.Calling this function will restrict the minimum size in the Edje calculation to whatever size it the layout has at the moment.
+        /// Requests sizing re-evaluation, restricted to the current width and/or height.
+        /// Useful mostly when there are TEXTBLOCK parts defining the height of an object and nothing else, restricting it to a minimum width. Calling this function will restrict minimum size in the Edje calculation to whatever size the layout has at the moment.
         /// </summary>
-        /// <param name="width">Restrict minimum size ot the current width.</param>
-        /// <param name="height">Restrict minimum size ot the current height.</param>
+        /// <param name="width">Restrict minimum size of the current width.</param>
+        /// <param name="height">Restrict minimum size of the current height.</param>
         /// <since_tizen> preview </since_tizen>
         public void Resizing(bool width, bool height)
         {
@@ -139,12 +139,12 @@ namespace ElmSharp
         }
 
         /// <summary>
-        /// Get the edje data from the given layout.
-        /// This function fetches data specified inside the edje theme of this layout.
-        /// This function return NULL if data is not found.
+        /// Gets the edje data from the given layout.
+        /// This function fetches the data specified inside the edje theme of this layout.
+        /// This function returns null if the data is not found.
         /// </summary>
-        /// <param name="key">The data key</param>
-        /// <returns>The data</returns>
+        /// <param name="key">The data key.</param>
+        /// <returns>The data.</returns>
         /// <since_tizen> preview </since_tizen>
         public string GetEdjeData(string key)
         {
@@ -154,7 +154,7 @@ namespace ElmSharp
         /// <summary>
         /// Gets the text set in the given part.
         /// </summary>
-        /// <param name="part">The TEXT part to retrieve the text off.</param>
+        /// <param name="part">The text part to retrieve the text off.</param>
         /// <returns></returns>
         /// <since_tizen> preview </since_tizen>
         public override string GetPartText(string part)
@@ -165,7 +165,7 @@ namespace ElmSharp
         /// <summary>
         /// Sets the text set in the given part.
         /// </summary>
-        /// <param name="part">The TEXT part to retrieve the text off.</param>
+        /// <param name="part">The text part to retrieve the text off.</param>
         /// <param name="text">The text to set.</param>
         /// <returns></returns>
         /// <since_tizen> preview </since_tizen>
@@ -175,13 +175,13 @@ namespace ElmSharp
         }
 
         /// <summary>
-        /// Append child to layout box part.
-        /// Once the object is appended, it will become child of the layout.
-        /// Its lifetime will be bound to the layout, whenever the layout dies the child will be deleted automatically.
+        /// Appends a child to the layout box part.
+        /// Once the object is appended, it will become a child of the layout.
+        /// Its lifetime will be bound to the layout. Whenever the layout dies, the child will be deleted automatically.
         /// </summary>
-        /// <param name="part">The part</param>
-        /// <param name="child">The Object to append</param>
-        /// <returns>Sucess is true</returns>
+        /// <param name="part">The part.</param>
+        /// <param name="child">The object to append.</param>
+        /// <returns>Success is true.</returns>
         /// <since_tizen> preview </since_tizen>
         public bool BoxAppend(string part, EvasObject child)
         {
@@ -190,13 +190,13 @@ namespace ElmSharp
         }
 
         /// <summary>
-        /// Prepend child to layout box part.
-        /// Once the object is prepended, it will become child of the layout.
-        /// Its lifetime will be bound to the layout, whenever the layout dies the child will be deleted automatically.
+        /// Prepends a child to the layout box part.
+        /// Once the object is prepended, it will become a child of the layout.
+        /// Its lifetime will be bound to the layout. Whenever the layout dies, the child will be deleted automatically.
         /// </summary>
-        /// <param name="part">The part</param>
-        /// <param name="child">The Object to prepend</param>
-        /// <returns>Sucess is true</returns>
+        /// <param name="part">The part.</param>
+        /// <param name="child">The object to prepend.</param>
+        /// <returns>Success is true.</returns>
         /// <since_tizen> preview </since_tizen>
         public bool BoxPrepend(string part, EvasObject child)
         {
@@ -205,12 +205,12 @@ namespace ElmSharp
         }
 
         /// <summary>
-        /// Remove a child of the given part box.
+        /// Removes a child from the given part box.
         /// The object will be removed from the box part and its lifetime will not be handled by the layout anymore.
         /// </summary>
-        /// <param name="part">The part</param>
-        /// <param name="child">The Object to remove</param>
-        /// <returns>Sucess is true</returns>
+        /// <param name="part">The part.</param>
+        /// <param name="child">The object to remove.</param>
+        /// <returns>Success if true</returns>
         /// <since_tizen> preview </since_tizen>
         public bool BoxRemove(string part, EvasObject child)
         {
@@ -219,12 +219,12 @@ namespace ElmSharp
         }
 
         /// <summary>
-        /// Remove all children of the given part box.
+        /// Removes all the children from the given part box.
         /// The objects will be removed from the box part and their lifetime will not be handled by the layout anymore.
         /// </summary>
-        /// <param name="part">The part</param>
-        /// <param name="clear">If true, then all objects will be deleted as well, otherwise they will just be removed and will be dangling on the canvas.</param>
-        /// <returns>Sucess is true</returns>
+        /// <param name="part">The part.</param>
+        /// <param name="clear">If true, then all the objects will be deleted as well, otherwise they will just be removed and will be dangling on the canvas.</param>
+        /// <returns>Success if true.</returns>
         /// <since_tizen> preview </since_tizen>
         public bool BoxRemoveAll(string part, bool clear)
         {
@@ -233,14 +233,14 @@ namespace ElmSharp
         }
 
         /// <summary>
-        /// Insert child to layout box part at a given position.
-        /// Once the object is inserted, it will become child of the layout.
-        /// Its lifetime will be bound to the layout, whenever the layout dies the child will be deleted automatically.
+        /// Inserts a child to the layout box part at a given position.
+        /// Once the object is inserted, it will become a child of the layout.
+        /// Its lifetime will be bound to the layout. Whenever the layout dies, the child will be deleted automatically.
         /// </summary>
-        /// <param name="part">The part</param>
-        /// <param name="child">The child object to insert into box.</param>
+        /// <param name="part">The part.</param>
+        /// <param name="child">The child object to insert into the box.</param>
         /// <param name="position">The numeric position >=0 to insert the child.</param>
-        /// <returns>Sucess is true</returns>
+        /// <returns>Success if true.</returns>
         /// <since_tizen> preview </since_tizen>
         public bool BoxInsertAt(string part, EvasObject child, uint position)
         {
@@ -249,14 +249,14 @@ namespace ElmSharp
         }
 
         /// <summary>
-        /// Insert child to layout box part before a reference object.
+        /// Inserts a child to the layout box part before a reference object.
         /// Once the object is inserted, it will become child of the layout.
-        /// Its lifetime will be bound to the layout, whenever the layout dies the child will be deleted automatically.
+        /// Its lifetime will be bound to the layout. Whenever the layout dies, the child will be deleted automatically.
         /// </summary>
-        /// <param name="part"></param>
-        /// <param name="child">The child object to insert into box.</param>
-        /// <param name="reference">Another reference object to insert before in box.</param>
-        /// <returns>Sucess is true</returns>
+        /// <param name="part">The part.</param>
+        /// <param name="child">The child object to insert into the box.</param>
+        /// <param name="reference">Another reference object to insert before the box.</param>
+        /// <returns>Success is true.</returns>
         /// <since_tizen> preview </since_tizen>
         public bool BoxInsertBefore(string part, EvasObject child, EvasObject reference)
         {
@@ -267,9 +267,9 @@ namespace ElmSharp
         /// <summary>
         /// Sets the layout content.
         /// </summary>
-        /// <param name="part">The swallow part name in the edje file</param>
+        /// <param name="part">The swallow part name in the edje file.</param>
         /// <param name="content">The child that will be added in this layout object.</param>
-        /// <returns>TRUE on success, FALSE otherwise</returns>
+        /// <returns>TRUE on success, FALSE otherwise.</returns>
         /// <since_tizen> preview </since_tizen>
         public override bool SetPartContent(string part, EvasObject content)
         {
@@ -279,10 +279,10 @@ namespace ElmSharp
         /// <summary>
         /// Sets the layout content.
         /// </summary>
-        /// <param name="part">The name of particular part</param>
-        /// <param name="content">The content</param>
+        /// <param name="part">The name of a particular part.</param>
+        /// <param name="content">The content.</param>
         /// <param name="preserveOldContent">true, preserve old content will be unset. false, preserve old content will not be unset.</param>
-        /// <returns>TRUE on success, FALSE otherwise</returns>
+        /// <returns>TRUE on success, FALSE otherwise.</returns>
         /// <since_tizen> preview </since_tizen>
         public override bool SetPartContent(string part, EvasObject content, bool preserveOldContent)
         {
@@ -297,9 +297,9 @@ namespace ElmSharp
         /// <summary>
         /// Sets the edje group from the elementary theme that is used as a layout.
         /// </summary>
-        /// <param name="klass">The class of the group</param>
-        /// <param name="group">The group</param>
-        /// <param name="style">The style to use</param>
+        /// <param name="klass">The class of the group.</param>
+        /// <param name="group">The group.</param>
+        /// <param name="style">The style to use.</param>
         /// <since_tizen> preview </since_tizen>
         public void SetTheme(string klass, string group, string style)
         {
@@ -309,8 +309,8 @@ namespace ElmSharp
         /// <summary>
         /// Sets the file that is used as a layout.
         /// </summary>
-        /// <param name="file">The path to the file (edj) that is used as a layout</param>
-        /// <param name="group">The group that the layout belongs to in the edje file</param>
+        /// <param name="file">The path to the file (edje) that is used as a layout.</param>
+        /// <param name="group">The group that the layout belongs to in the edje file.</param>
         /// <since_tizen> preview </since_tizen>
         public void SetFile(string file, string group)
         {
@@ -318,7 +318,7 @@ namespace ElmSharp
         }
 
         /// <summary>
-        /// Sets the back ground color of layout
+        /// Sets the background color of a layout.
         /// </summary>
         /// <since_tizen> preview </since_tizen>
         public override Color BackgroundColor
@@ -339,10 +339,10 @@ namespace ElmSharp
         }
 
         /// <summary>
-        /// Sets the vertical text alignment of layout's text part
+        /// Sets the vertical text alignment of the layout's text part.
         /// </summary>
         /// <remarks>
-        /// API, elm_layout_text_valign_set, is an internal API only in Tizen. Avalilable since Tizen_4.0.
+        /// API, elm_layout_text_valign_set, is an internal API only in Tizen. Available since Tizen_4.0.
         /// </remarks>
         /// <since_tizen> preview </since_tizen>
         public virtual void SetVerticalTextAlignment(string part, double valign)
@@ -351,10 +351,10 @@ namespace ElmSharp
         }
 
         /// <summary>
-        /// Gets the vertical text alignment of layout's text part
+        /// Gets the vertical text alignment of the layout's text part.
         /// </summary>
         /// <remarks>
-        /// API, elm_layout_text_valign_get, is internal API only in Tizen. Avalilable since Tizen_4.0.
+        /// API, elm_layout_text_valign_get, is an internal API only in Tizen. Available since Tizen_4.0.
         /// </remarks>
         /// <since_tizen> preview </since_tizen>
         public virtual double GetVerticalTextAlignment(string part)
@@ -363,7 +363,7 @@ namespace ElmSharp
         }
 
         /// <summary>
-        /// The callback of Realized Event
+        /// The callback of the Realized Event.
         /// </summary>
         /// <since_tizen> preview </since_tizen>
         protected override void OnRealized()
@@ -385,8 +385,8 @@ namespace ElmSharp
         /// <summary>
         /// Sets the content at a part of a given container widget.
         /// </summary>
-        /// <param name="parent">The parent is a given container which will be attached by Layout as a child. It's <see cref="EvasObject"/> type.</param>
-        /// <returns>The new object, otherwise null if it cannot be created</returns>
+        /// <param name="parent">The parent is a given container which will be attached by the layout as a child. It's <see cref="EvasObject"/> type.</param>
+        /// <returns>The new object, otherwise null if it cannot be created.</returns>
         /// <since_tizen> preview </since_tizen>
         protected override IntPtr CreateHandle(EvasObject parent)
         {