Merge "Update Doxygen for Optimal Size" into tizen_2.1

diff --git a/inc/FUiCtrlAnimation.h b/inc/FUiCtrlAnimation.h
old mode 100644 (file)
new mode 100755 (executable)
index 41cd93a..530ebce
--- a/inc/FUiCtrlAnimation.h
+++ b/inc/FUiCtrlAnimation.h
@@ -210,7 +210,9 @@ public:
         * @return              An error code
         * @param[in]   rect                    An instance of the Tizen::Graphics::Rectangle class @n
         *                                                              This instance represents the x and y coordinates of the top-left corner of the created window along with
-        *                                                              its width and height.
+        *                                                              its width and height.@n\r
+        *                                                              The optimal size of the control is defined in\r
+        *                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   aniFrames               An IList of %AnimationFrames used in the animation
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_SYSTEM                A system error has occurred.
@@ -230,7 +232,9 @@ public:
         * @return              An error code
         * @param[in]   rect                    An instance of the Tizen::Graphics::FloatRectangle class @n
         *                                                              This instance represents the x and y coordinates of the top-left corner of the created window along with
-        *                                                              its width and height.
+        *                                                              its width and height.@n\r
+        *                                                              The optimal size of the control is defined in\r
+        *                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   aniFrames               An IList of %AnimationFrames used in the animation
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_SYSTEM                A system error has occurred.

diff --git a/inc/FUiCtrlButton.h b/inc/FUiCtrlButton.h
old mode 100644 (file)
new mode 100755 (executable)
index d0f2048..0317ccb
--- a/inc/FUiCtrlButton.h
+++ b/inc/FUiCtrlButton.h
@@ -197,16 +197,17 @@ public:
         * @return              An error code
         * @param[in]   rect                    An instance of the Tizen::Graphics::Rectangle class @n
         *                                                              This instance represents the x and y coordinates of the top-left corner
-        *                              of the created window along with its width and height.
+        *                              of the created window along with its width and height.@n\r
+        *                                                              The optimal size of the control is defined in\r
+        *                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   text                    The text to display on the button
+        *                                                              To display the text in multi-lines or to denote the end of line, use '\\n'.
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_INVALID_ARG   A specified input parameter is invalid.
         * @exception   E_SYSTEM                        A system error has occurred.
         * @remarks
         *                              - A control is fully functional only after it has been added to a container. Therefore, some methods may fail if they are used before
         *                              adding the control to the container.
-        *                              - To display the text in multi-lines or to denote the end of line, use '\\n'.
-        *                              - The size of the control must be within the range defined by the minimum and maximum sizes.
         */
        result Construct(const Tizen::Graphics::Rectangle& rect, const Tizen::Base::String& text = L"");
 
@@ -218,7 +219,9 @@ public:
         * @return              An error code
         * @param[in]   rect                    An instance of the Tizen::Graphics::FloatRectangle class @n
         *                                                              This instance represents the x and y coordinates of the top-left corner
-        *                              of the created window along with its width and height.
+        *                              of the created window along with its width and height.@n\r
+        *                                                              The optimal size of the control is defined in\r
+        *                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   text                    The text to display on the button
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_INVALID_ARG   A specified input parameter is invalid.
@@ -227,7 +230,6 @@ public:
         *                              - A control is fully functional only after it has been added to a container. Therefore, some methods may fail if they are used before
         *                              adding the control to the container.
         *                              - To display the text in multi-lines or to denote the end of line, use '\\n'.
-        *                              - The size of the control must be within the range defined by the minimum and maximum sizes.
         */
        result Construct(const Tizen::Graphics::FloatRectangle& rect, const Tizen::Base::String& text = L"");
 

diff --git a/inc/FUiCtrlCheckButton.h b/inc/FUiCtrlCheckButton.h
old mode 100644 (file)
new mode 100755 (executable)
index 870d47e..c2c2903
--- a/inc/FUiCtrlCheckButton.h
+++ b/inc/FUiCtrlCheckButton.h
@@ -198,7 +198,9 @@ public:
         * @return              An error code
         * @param[in]   rect                    An instance of the Tizen::Graphics::Rectangle class @n
         *                                                                      This instance represents the x and y coordinates of the top-left corner of the created window
-        *                                                                      along with the width and height of the window.
+        *                                                                      along with the width and height of the window.@n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   style                           The style of the %CheckButton control
         * @param[in]   backgroundStyle         The background style set of the %CheckButton control
         * @param[in]   showTitle               Set to @c true to enable the title, @n
@@ -224,7 +226,9 @@ public:
         * @return              An error code
         * @param[in]   rect                    An instance of the Tizen::Graphics::FloatRectangle class @n
         *                                                                      This instance represents the x and y coordinates of the top-left corner of the created window
-        *                                                                      along with the width and height of the window.
+        *                                                                      along with the width and height of the window.@n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   style                           The style of the %CheckButton control
         * @param[in]   backgroundStyle         The background style set of the %CheckButton control
         * @param[in]   showTitle               Set to @c true to enable the title, @n

diff --git a/inc/FUiCtrlColorPicker.h b/inc/FUiCtrlColorPicker.h
old mode 100644 (file)
new mode 100755 (executable)
index 147a3ed..82d9dcf
--- a/inc/FUiCtrlColorPicker.h
+++ b/inc/FUiCtrlColorPicker.h
@@ -134,7 +134,9 @@ public:
         * @since                       2.0
         *
         * @return                      An error code
-        * @param[in]   point           The position of this %ColorPicker in the container
+        * @param[in]   point           The position of this %ColorPicker in the container @n\r
+        *                                                              The optimal size of the control is defined in\r
+        *                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @exception   E_SUCCESS       The method is successful.
         * @exception   E_SYSTEM                A system error has occurred.
         * @remarks             A control is fully usable only after it has been added to a container. Therefore, some methods may fail if the control is used earlier.
@@ -147,7 +149,9 @@ public:
         * @since                       2.1
         *
         * @return                      An error code
-        * @param[in]   point           The position of this %ColorPicker in the container
+        * @param[in]   point           The position of this %ColorPicker in the container @n\r
+        *                                                              The optimal size of the control is defined in\r
+        *                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @exception   E_SUCCESS       The method is successful.
         * @exception   E_SYSTEM                A system error has occurred.
         * @remarks             A control is fully usable only after it has been added to a container. Therefore, some methods may fail if the control is used earlier.

diff --git a/inc/FUiCtrlContextMenu.h b/inc/FUiCtrlContextMenu.h
old mode 100644 (file)
new mode 100755 (executable)
index ceda168..2b8ebfc
--- a/inc/FUiCtrlContextMenu.h
+++ b/inc/FUiCtrlContextMenu.h
@@ -257,7 +257,9 @@ public:
         * @since               2.0
         *
         * @return              An error code
-        * @param[in]   point           The x and y coordinates of the anchor of %ContextMenu
+        * @param[in]   point           The x and y coordinates of the anchor of %ContextMenu @n\r
+        *                                                              The optimal size of the control is defined in\r
+        *                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   style                   The context menu style
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_INVALID_STATE This instance has already been constructed.
@@ -289,7 +291,9 @@ public:
         * @since               2.0
         *
         * @return              An error code
-        * @param[in]   point                   The x and y coordinates of the anchor of the %ContextMenu control
+        * @param[in]   point                   The x and y coordinates of the anchor of the %ContextMenu control @n\r
+        *                                                              The optimal size of the control is defined in\r
+        *                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   style                   The context menu style
         * @param[in]   direction               The anchor arrow direction
         * @exception   E_SUCCESS               The method is successful.
@@ -306,7 +310,9 @@ public:
         * @since               2.1
         *
         * @return              An error code
-        * @param[in]   point                   The x and y coordinates of the anchor of the %ContextMenu control
+        * @param[in]   point                   The x and y coordinates of the anchor of the %ContextMenu control @n\r
+        *                                                              The optimal size of the control is defined in\r
+        *                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   style                   The context menu style
         * @param[in]   direction               The anchor arrow direction
         * @exception   E_SUCCESS               The method is successful.

diff --git a/inc/FUiCtrlDatePicker.h b/inc/FUiCtrlDatePicker.h
old mode 100644 (file)
new mode 100755 (executable)
index 216514e..3f6b3f7
--- a/inc/FUiCtrlDatePicker.h
+++ b/inc/FUiCtrlDatePicker.h
@@ -233,6 +233,8 @@ public:
        * @param[in]    title               The title
        * @exception    E_SUCCESS           The method is successful.
        * @exception    E_SYSTEM                    A system error has occurred.
+       * @remarks              The optimal size of the control is defined in\r
+       * <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
        */
        result Construct(const Tizen::Base::String& title = L"");
 

diff --git a/inc/FUiCtrlDateTimePicker.h b/inc/FUiCtrlDateTimePicker.h
old mode 100644 (file)
new mode 100755 (executable)
index 869a764..ba34d69
--- a/inc/FUiCtrlDateTimePicker.h
+++ b/inc/FUiCtrlDateTimePicker.h
@@ -234,6 +234,8 @@ public:
         * @param[in]   title                           The title
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_SYSTEM                        A system error has occurred.
+        * @remarks             The optimal size of the control is defined in\r
+        * <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         */
        result Construct(const Tizen::Base::String& title = L"");
 

diff --git a/inc/FUiCtrlEditArea.h b/inc/FUiCtrlEditArea.h
old mode 100644 (file)
new mode 100755 (executable)
index cb09460..1d2a44f
--- a/inc/FUiCtrlEditArea.h
+++ b/inc/FUiCtrlEditArea.h
@@ -166,7 +166,9 @@ public:
         * @return              An error code
         * @param[in]   rect            An instance of the Graphics::Rectangle class @n
         *                                  This instance represents the x and y coordinates of the top-left corner of the created window along with
-        *                                  the width and height of the control.
+        *                                  the width and height of the control.@n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   inputStyle                      Determines whether the fullscreen keypad or overlay keypad is displayed
         * @param[in]   limitLength                     The maximum limit of the length of the text that can be displayed by %EditArea
         * @exception   E_SUCCESS                       The method is successful.
@@ -189,7 +191,9 @@ public:
        * @return               An error code
        * @param[in]    rect            An instance of the Tizen::Graphics::FloatRectangle class @n
        *                                                                       This instance represents the x and y coordinates of the top-left corner of the created window along with
-       *                                                                       the width and height of the control.
+       *                                                                       the width and height of the control.@n\r
+       *                                                                       The optimal size of the control is defined in\r
+       *                                                                       <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
        * @param[in]    inputStyle                      Determines whether the fullscreen keypad or overlay keypad is displayed
        * @param[in]    limitLength             The maximum limit of the length of the text that can be displayed by %EditArea
        * @exception    E_SUCCESS                       The method is successful.

diff --git a/inc/FUiCtrlEditDate.h b/inc/FUiCtrlEditDate.h
old mode 100644 (file)
new mode 100755 (executable)
index 7406975..e280195
--- a/inc/FUiCtrlEditDate.h
+++ b/inc/FUiCtrlEditDate.h
@@ -167,7 +167,9 @@ public:
        * @since                        2.0
        *
        * @return                       An error code
-       * @param[in]    point           The position of the %EditDate in the container
+       * @param[in]    point           The position of the %EditDate in the container @n\r
+       *                                                               The optimal size of the control is defined in\r
+       *                                                               <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
        * @param[in]    title           The title
        * @exception    E_SUCCESS       The method is successful.
        * @exception    E_SYSTEM                A system error has occurred.
@@ -181,7 +183,9 @@ public:
        * @since                        2.1
        *
        * @return                       An error code
-       * @param[in]    point           The position of the %EditDate in the container
+       * @param[in]    point           The position of the %EditDate in the container @n\r
+       *                                                               The optimal size of the control is defined in\r
+       *                                                               <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
        * @param[in]    title           The title
        * @exception    E_SUCCESS       The method is successful.
        * @exception    E_SYSTEM                A system error has occurred.

diff --git a/inc/FUiCtrlEditField.h b/inc/FUiCtrlEditField.h
old mode 100644 (file)
new mode 100755 (executable)
index 6caaecc..e757d96
--- a/inc/FUiCtrlEditField.h
+++ b/inc/FUiCtrlEditField.h
@@ -166,7 +166,9 @@ public:
         * @return                      An error code
         * @param[in]           rect            An instance of the Graphics::Rectangle class @n
         *                                                                              This instance represents the x and y coordinates of the top-left corner of the created window along with
-        *                                                                              the width and height of the control.
+        *                                                                              the width and height of the control. @n\r
+        *                                                                              The optimal size of the control is defined in\r
+        *                                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   style                   The style of the %EditField control
         * @param[in]   inputStyle              The input style of the %EditField control
         * @param[in]   showTitle                               Set to @c true to display the title, @n
@@ -197,7 +199,9 @@ public:
         * @return                      An error code
         * @param[in]           rect            An instance of the Tizen::Graphics::FloatRectangle class @n
         *                                                                              This instance represents the x and y coordinates of the top-left corner of the created window along with
-        *                                                                              the width and height of the control.
+        *                                                                              the width and height of the control. @n\r
+        *                                                                              The optimal size of the control is defined in\r
+        *                                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   style                   The style of the %EditField control
         * @param[in]   inputStyle              The input style of the %EditField control
         * @param[in]   showTitle                               Set to @c true to display the title, @n
@@ -226,7 +230,11 @@ public:
         * @since        2.0
         *
         * @return       An error code
-        * @param[in]   rect                    The bounds of %EditField
+        * @param[in]   rect                    An instance of the Tizen::Graphics::FloatRectangle class @n
+        *                                                              This instance represents the x and y coordinates of the top-left corner of the created window along with
+        *                                                              the width and height of the control. @n\r
+        *                                                              The optimal size of the control is defined in\r
+        *                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]    style           The style of the %EditField control
         * @param[in]    inputStyle      The input style of the %EditField control
         * @param[in]    titleStyle      The title style
@@ -257,7 +265,11 @@ public:
         * @since                2.1
         *
         * @return               An error code
-        * @param[in]   rect                                    The bounds of %EditField
+        * @param[in]   rect                    An instance of the Tizen::Graphics::FloatRectangle class @n
+        *                                                              This instance represents the x and y coordinates of the top-left corner of the created window along with
+        *                                                              the width and height of the control. @n\r
+        *                                                              The optimal size of the control is defined in\r
+        *                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]    style                   The style of the %EditField control
         * @param[in]    inputStyle      The input style of the %EditField control
         * @param[in]    titleStyle      The title style

diff --git a/inc/FUiCtrlEditTime.h b/inc/FUiCtrlEditTime.h
old mode 100644 (file)
new mode 100755 (executable)
index 1ef7f76..f1e2d42
--- a/inc/FUiCtrlEditTime.h
+++ b/inc/FUiCtrlEditTime.h
@@ -164,7 +164,9 @@ public:
         * @since                       2.0
         *
         * @return              An error code
-        * @param[in]   point                           The position of %EditTime in container
+        * @param[in]   point                           The position of %EditTime in container @n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   title                           The title
         * @exception   E_SUCCESS           The method is successful.
         * @exception   E_SYSTEM                        A system error has occurred.
@@ -177,7 +179,9 @@ public:
         * @since                       2.1
         *
         * @return              An error code
-        * @param[in]   point                           The position of %EditTime in container
+        * @param[in]   point                           The position of %EditTime in container @n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   title                           The title
         * @exception   E_SUCCESS           The method is successful.
         * @exception   E_SYSTEM                        A system error has occurred.

diff --git a/inc/FUiCtrlExpandableEditArea.h b/inc/FUiCtrlExpandableEditArea.h
old mode 100644 (file)
new mode 100755 (executable)
index 13937f5..fdcd425
--- a/inc/FUiCtrlExpandableEditArea.h
+++ b/inc/FUiCtrlExpandableEditArea.h
@@ -240,7 +240,9 @@ public:
         * @return       An error code
         * @param[in]    rect             An instance of the Graphics::Rectangle class @n
         *                                                                              This instance represents the x and y coordinates of the top-left corner of the expandable edit area along with
-        *                                                                              the width and height.
+        *                                                                              the width and height. @n\r
+        *                                                                              The optimal size of the control is defined in\r
+        *                                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]    style            The style of the expandable edit area
         * @param[in]    titleStyle       The title style
         * @param[in]    maxExpandableLines         The maximum number of lines to which the control can be expanded.
@@ -263,7 +265,9 @@ public:
         * @return       An error code
         * @param[in]    rect             An instance of the Tizen::Graphics::FloatRectangle class @n
         *                                                                              This instance represents the x and y coordinates of the top-left corner of the expandable edit area along with
-        *                                                                              the width and height.
+        *                                                                              the width and height. @n\r
+        *                                                                              The optimal size of the control is defined in\r
+        *                                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]    style            The style of the expandable edit area
         * @param[in]    titleStyle       The title style
         * @param[in]    maxExpandableLines         The maximum number of lines to which the control can be expanded.

diff --git a/inc/FUiCtrlFooterItem.h b/inc/FUiCtrlFooterItem.h
old mode 100644 (file)
new mode 100755 (executable)
index 9f4853e..6219328
--- a/inc/FUiCtrlFooterItem.h
+++ b/inc/FUiCtrlFooterItem.h
@@ -83,7 +83,7 @@ public:
         * @since               2.0
         *
         * @return      An error code
-        * @param[in]   actionId            The action ID of this item
+        * @param[in]   actionId            The action ID of this item 
         * @exception   E_SUCCESS       The method is successful.
         * @exception   E_INVALID_ARG   The specified input parameter is invalid. @n
         *                                                              The specified @c actionId of the specified item must be a positive integer.

diff --git a/inc/FUiCtrlForm.h b/inc/FUiCtrlForm.h
old mode 100644 (file)
new mode 100755 (executable)
index e874d8e..403fa84
--- a/inc/FUiCtrlForm.h
+++ b/inc/FUiCtrlForm.h
@@ -750,7 +750,9 @@ public:
         *
         * @return              A pointer to the Footer control, @n
         *                              else @c null if there is no %Footer
-        * @remarks             The retrieved pointer may be temporary. Therefore, it should not be stored after immediate use.
+        * @remarks             The retrieved pointer may be temporary. Therefore, it should not be stored after immediate use. @n
+        *                              The optimal size of the control is defined in\r
+        *                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         */
        Footer* GetFooter(void) const;
 
@@ -763,7 +765,9 @@ public:
         * @return              A pointer to the Header control, @n
         *                              else @c null if there is no %Header
         * @remarks             The retrieved pointer may be temporary. Therefore, it should not be
-        *              stored after immediate use.
+        *              stored after immediate use. @n
+        *                              The optimal size of the control is defined in\r
+        *                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         */
        Header* GetHeader(void) const;
 

diff --git a/inc/FUiCtrlGallery.h b/inc/FUiCtrlGallery.h
old mode 100644 (file)
new mode 100755 (executable)
index a7ea132..5c9c45d
--- a/inc/FUiCtrlGallery.h
+++ b/inc/FUiCtrlGallery.h
@@ -207,7 +207,9 @@ public:
         * @return              An error code
         * @param[in]   rect            An instance of the Graphics::Rectangle class @n
         *                                      This instance represents the x and y coordinates of the top-left corner of the created %Gallery control along with the
-        *                                      width and height.
+        *                                      width and height. @n\r
+        *                                      The optimal size of the control is defined in\r
+        *                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_INVALID_ARG   The specified input parameter is invalid.
         * @exception   E_SYSTEM                        A system error has occurred.
@@ -222,7 +224,9 @@ public:
         * @return              An error code
         * @param[in]   rect            An instance of the Tizen::Graphics::FloatRectangle class @n
         *                                      This instance represents the x and y coordinates of the top-left corner of the created %Gallery control along with the
-        *                                      width and height.
+        *                                      width and height.@n\r
+        *                                      The optimal size of the control is defined in\r
+        *                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_INVALID_ARG   The specified input parameter is invalid.
         * @exception   E_SYSTEM                        A system error has occurred.

diff --git a/inc/FUiCtrlGroupedListView.h b/inc/FUiCtrlGroupedListView.h
old mode 100644 (file)
new mode 100755 (executable)
index 0980245..05ee89d
--- a/inc/FUiCtrlGroupedListView.h
+++ b/inc/FUiCtrlGroupedListView.h
@@ -403,7 +403,9 @@ public:
         * @return  An error code
         * @param[in]   rect                            An instance of the Graphics::Rectangle class
         *                                  This instance represents the x and y coordinates of the top-left corner of the created
-        *                                                                      %GroupedListView control along with the width and height.
+        *                                                                      %GroupedListView control along with the width and height.@n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   style                           The style of the %GroupedListView control
         * @param[in]   itemDivider                     Set to @c true to display an item divider, @n
         *                                                                      else @c false
@@ -425,7 +427,9 @@ public:
         * @return  An error code
         * @param[in]   rect                            An instance of the Graphics::Rectangle class
         *                                  This instance represents the x and y coordinates of the top-left corner of the created
-        *                                                                      %GroupedListView control along with the width and height.
+        *                                                                      %GroupedListView control along with the width and height.@n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   style                           The style of the %GroupedListView control
         * @param[in]   itemDivider                     Set to @c true to display an item divider, @n
         *                                                                      else @c false
@@ -445,7 +449,9 @@ public:
         * @return  An error code
         * @param[in]   rect                            An instance of the Graphics::Rectangle class
         *                                  This instance represents the x and y coordinates of the top-left corner of the created
-        *                                                                      %GroupedListView control along with the width and height.
+        *                                                                      %GroupedListView control along with the width and height.@n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   style                           The style of the %GroupedListView control
         * @param[in]   itemDivider                     Set to @c true to display an item divider, @n
         *                                                                      else @c false

diff --git a/inc/FUiCtrlGroupedTableView.h b/inc/FUiCtrlGroupedTableView.h
old mode 100644 (file)
new mode 100755 (executable)
index 105f153..6fea148
--- a/inc/FUiCtrlGroupedTableView.h
+++ b/inc/FUiCtrlGroupedTableView.h
@@ -338,7 +338,9 @@ public:
        * @return  An error code
        * @param[in] rect    An instance of the Graphics::Rectangle class @n
        *                              This instance represents the x and y coordinates of the left top corner of the created %GroupedTableView along with
-       *                                       the width and height.
+       *                                       the width and height.@n\r
+       *                                                               The optimal size of the control is defined in\r
+       *                                                               <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
        * @param[in] itemDivider       Set to @c true to display an item divider, @n
        *                              else @c false
        * @param[in] scrollStyle       The style of %GroupedTableView scroll bar style
@@ -356,7 +358,9 @@ public:
        * @return  An error code
        * @param[in] rect    An instance of the Tizen::Graphics::FloatRectangle class @n
        *                              This instance represents the x and y coordinates of the left top corner of the created %GroupedTableView along with
-       *                                       the width and height.
+       *                                       the width and height.@n\r
+       *                                                               The optimal size of the control is defined in\r
+       *                                                               <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
        * @param[in] itemDivider       Set to @c true to display an item divider, @n
        *                              else @c false
        * @param[in] scrollStyle       The style of %GroupedTableView scroll bar style

diff --git a/inc/FUiCtrlIconListView.h b/inc/FUiCtrlIconListView.h
old mode 100644 (file)
new mode 100755 (executable)
index 808ce64..c0f2137
--- a/inc/FUiCtrlIconListView.h
+++ b/inc/FUiCtrlIconListView.h
@@ -243,7 +243,9 @@ public:
         * @return      An error code
         * @param[in]   rect                            An instance of the Tizen::Graphics::Rectangle class @n
         *                                                                      This instance represents the x and y coordinates of the top-left corner of the created %IconListView along with
-        *                                                                      the width and height.
+        *                                                                      the width and height.@n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   itemBitmapSize          The size of an icon in %IconListView
         * @param[in]   style                           The style set of %IconListView
         * @param[in]   direction                       The direction of scroll
@@ -267,7 +269,9 @@ public:
         * @return      An error code
         * @param[in]   rect                            An instance of the Tizen::Graphics::FloatRectangle class @n
         *                                                                      This instance represents the x and y coordinates of the top-left corner of the created %IconListView along with
-        *                                                                      the width and height.
+        *                                                                      the width and height.@n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   itemBitmapSize          The size of an icon in %IconListView
         * @param[in]   style                           The style set of %IconListView
         * @param[in]   direction                       The direction of scroll

diff --git a/inc/FUiCtrlLabel.h b/inc/FUiCtrlLabel.h
old mode 100644 (file)
new mode 100755 (executable)
index 168169b..fbca3ac
--- a/inc/FUiCtrlLabel.h
+++ b/inc/FUiCtrlLabel.h
@@ -133,7 +133,9 @@ public:
         * @return              An error code
         * @param[in]   rect                            An instance of the Tizen::Graphics::Rectangle class @n
         *                                                                      This instance represents the x and y coordinates of the top-left corner of the created window along with
-        *                                                                      the width and height of the window.
+        *                                                                      the width and height of the window.@n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   text                            The text for this label instance
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_INVALID_ARG       A specified input parameter is invalid.
@@ -153,7 +155,9 @@ public:
         * @return              An error code
         * @param[in]   rect                            An instance of the Tizen::Graphics::FloatRectangle class @n
         *                                                                      This instance represents the x and y coordinates of the top-left corner of the created window along with
-        *                                                                      the width and height of the window.
+        *                                                                      the width and height of the window.@n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   text                            The text for this label instance
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_INVALID_ARG       A specified input parameter is invalid.

diff --git a/inc/FUiCtrlListView.h b/inc/FUiCtrlListView.h
old mode 100644 (file)
new mode 100755 (executable)
index 60dc142..e7c3fc8
--- a/inc/FUiCtrlListView.h
+++ b/inc/FUiCtrlListView.h
@@ -317,7 +317,9 @@ public:
         * @return  An error code
         * @param[in] rect                              An instance of the Graphics::Rectangle class @n
         *                                                              This instance represents the x and y coordinates of the left top corner of the created %ListView along with the width
-        *                                                              and height.
+        *                                                              and height.@n\r
+        *                                                              The optimal size of the control is defined in\r
+        *                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in] itemDivider       Set to @c true to display an item divider, @n
         *                                                              else @c false
         * @param[in] fastScroll        Set to @c true to use fast scroll, @n
@@ -338,7 +340,9 @@ public:
         * @return  An error code
         * @param[in] rect              An instance of the Graphics::Rectangle class @n
         *                                                              This instance represents the x and y coordinates of the left top corner of the created %ListView along with the width
-        *                                                              and height.
+        *                                                              and height.@n\r
+        *                                                              The optimal size of the control is defined in\r
+        *                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in] itemDivider       Set to @c true to display an item divider, @n
         *                                                              else @c false
         * @param[in] scrollStyle       Set to scroll style
@@ -357,7 +361,9 @@ public:
         * @return  An error code
         * @param[in] rect              An instance of the Graphics::Rectangle class @n
         *                                                              This instance represents the x and y coordinates of the left top corner of the created %ListView along with the width
-        *                                                              and height.
+        *                                                              and height.@n\r
+        *                                                              The optimal size of the control is defined in\r
+        *                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in] itemDivider       Set to @c true to display an item divider, @n
         *                                                              else @c false
         * @param[in] scrollStyle       Set to scroll style

diff --git a/inc/FUiCtrlPopup.h b/inc/FUiCtrlPopup.h
old mode 100644 (file)
new mode 100755 (executable)
index 85725a7..4185224
--- a/inc/FUiCtrlPopup.h
+++ b/inc/FUiCtrlPopup.h
@@ -200,7 +200,9 @@ public:
         * @return              An error code
         * @param[in]   hasTitle                        Set to @c true if the %Popup control has a title, @n
         *                                                                      else @c false
-        * @param[in]   dim                             The size of the %Popup control
+        * @param[in]   dim                             The size of the %Popup control @n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_INVALID_ARG           A specified input parameter is invalid.
         * @exception   E_SYSTEM                A system error has occurred.
@@ -217,7 +219,9 @@ public:
         * @return              An error code
         * @param[in]   hasTitle                        Set to @c true if the %Popup control has a title, @n
         *                                                                      else @c false
-        * @param[in]   dim                             The size of the %Popup control
+        * @param[in]   dim                             The size of the %Popup control @n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_INVALID_ARG           A specified input parameter is invalid.
         * @exception   E_SYSTEM                A system error has occurred.
@@ -254,7 +258,9 @@ public:
         * @param[in]   layout                          The layout for both the portrait and landscape mode
         * @param[in]   hasTitle                Set to @c true if the %Popup control should have a title, @n
         *                                                              else @c false
-        * @param[in]   dim                             The size of the %Popup control
+        * @param[in]   dim                             The size of the %Popup control @n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_INVALID_ARG           A specified input parameter is invalid, or
         *                                                                      the specified layout is already bound to another container.
@@ -273,7 +279,9 @@ public:
         * @param[in]   layout                          The layout for both the portrait and landscape mode
         * @param[in]   hasTitle                Set to @c true if the %Popup control should have a title, @n
         *                                                              else @c false
-        * @param[in]   dim                             The size of the %Popup control
+        * @param[in]   dim                             The size of the %Popup control @n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_INVALID_ARG           A specified input parameter is invalid, or
         *                                                                      the specified layout is already bound to another container.
@@ -293,7 +301,9 @@ public:
         * @param[in]   landscapeLayout         The layout for the landscape mode
         * @param[in]   hasTitle                        Set to @c true if this %Popup control should have a title, @n
         *                                                                      else @c false
-        * @param[in]   dim                             The size of the %Popup control
+        * @param[in]   dim                             The size of the %Popup control @n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_INVALID_ARG           A specified input parameter is invalid, or
         *                                                                      the specified layout is already bound to another container.
@@ -313,7 +323,9 @@ public:
         * @param[in]   landscapeLayout         The layout for the landscape mode
         * @param[in]   hasTitle                        Set to @c true if this %Popup control should have a title, @n
         *                                                                      else @c false
-        * @param[in]   dim                             The size of the %Popup control
+        * @param[in]   dim                             The size of the %Popup control @n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_INVALID_ARG           A specified input parameter is invalid, or
         *                                                                      the specified layout is already bound to another container.

diff --git a/inc/FUiCtrlProgress.h b/inc/FUiCtrlProgress.h
old mode 100644 (file)
new mode 100755 (executable)
index 1232461..f674236
--- a/inc/FUiCtrlProgress.h
+++ b/inc/FUiCtrlProgress.h
@@ -166,7 +166,9 @@ public:
         * @return              An error code
         * @param[in]   rect                            An instance of the Tizen::Graphics::Rectangle class @n
         *                                                          This instance represents the x and y coordinates of the top-left corner of the created window along with
-        *                                  its width and height.
+        *                                  its width and height. @n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   minValue                        The minimum value of the current instance of %Progress
         * @param[in]   maxValue                        The maximum value of the current instance of %Progress
         * @exception   E_SUCCESS                       The method is successful.
@@ -188,7 +190,9 @@ public:
         * @return              An error code
         * @param[in]   rect                            An instance of the Tizen::Graphics::FloatRectangle class @n
         *                                                          This instance represents the x and y coordinates of the top-left corner of the created window along with
-        *                                  its width and height.
+        *                                  its width and height. @n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   minValue                        The minimum value of the current instance of %Progress
         * @param[in]   maxValue                        The maximum value of the current instance of %Progress
         * @exception   E_SUCCESS                       The method is successful.

diff --git a/inc/FUiCtrlSearchBar.h b/inc/FUiCtrlSearchBar.h
old mode 100644 (file)
new mode 100755 (executable)
index 364e904..0931117
--- a/inc/FUiCtrlSearchBar.h
+++ b/inc/FUiCtrlSearchBar.h
@@ -365,7 +365,9 @@ public:
         * @return              An error code
         * @param[in]   rect                    An instance of the Graphics::Rectangle class @n
         *                                                              This instance represents the x and y coordinates of the top-left corner of the created window along with
-        *                                                              the width and height of the control.
+        *                                                              the width and height of the control. @n\r
+        *                                                              The optimal size of the control is defined in\r
+        *                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   searchBarButton Set to @c true to display the search bar button, @n
         *                              else @c false
         * @param[in]   keypadAction    The keypad action
@@ -388,7 +390,9 @@ public:
         * @return              An error code
         * @param[in]   rect                    An instance of the Tizen::Graphics::FloatRectangle class @n
         *                                                              This instance represents the x and y coordinates of the top-left corner of the created window along with
-        *                                                              the width and height of the control.
+        *                                                              the width and height of the control. @n\r
+        *                                                              The optimal size of the control is defined in\r
+        *                                                              <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   searchBarButton Set to @c true to display the search bar button, @n
         *                              else @c false
         * @param[in]   keypadAction    The keypad action

diff --git a/inc/FUiCtrlSlider.h b/inc/FUiCtrlSlider.h
old mode 100644 (file)
new mode 100755 (executable)
index b0ed051..13063d7
--- a/inc/FUiCtrlSlider.h
+++ b/inc/FUiCtrlSlider.h
@@ -147,7 +147,9 @@ public:
         * @return              An error code
         * @param[in]   rect                            An instance of the Graphics::Rectangle class @n
         *                                                                      This instance represents the x and y coordinates of the top-left corner of the created window along with
-        *                                                                      the width and height of the control.
+        *                                                                      the width and height of the control.@n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   backgroundStyle         The background style set of the slider
         * @param[in]   showTitle                       Set to @c true to enable the show title, @n
         *                                                                      else @c false
@@ -175,7 +177,9 @@ public:
         * @return              An error code
         * @param[in]   rect                            An instance of the Tizen::Graphics::FloatRectangle class @n
         *                                                                      This instance represents the x and y coordinates of the top-left corner of the created window along with
-        *                                                                      the width and height of the control.
+        *                                                                      the width and height of the control.@n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   backgroundStyle         The background style set of the slider
         * @param[in]   showTitle                       Set to @c true to enable the show title, @n
         *                                                                      else @c false
@@ -322,7 +326,9 @@ public:
         * @return              An error code
         * @param[in]   rect                            An instance of the Graphics::Rectangle class @n
         *                                                                  This instance represents the x and y coordinates of the top-left corner of the created window along with
-        *                                  its width and height.
+        *                                  its width and height.@n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   sliderStyle         The style of the slider @n
         *                                  Multiple link types can be combined using bitwise OR operator.
         * @param[in]   minValue            The minimum slider value
@@ -349,7 +355,9 @@ public:
         * @return              An error code
         * @param[in]   rect                            An instance of the Tizen::Graphics::FloatRectangle class @n
         *                                                                  This instance represents the x and y coordinates of the top-left corner of the created window along with
-        *                                  its width and height.
+        *                                  its width and height.@n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   sliderStyle         The style of the slider @n
         *                                  Multiple link types can be combined using bitwise OR operator.
         * @param[in]   minValue            The minimum slider value

diff --git a/inc/FUiCtrlTabBar.h b/inc/FUiCtrlTabBar.h
old mode 100644 (file)
new mode 100755 (executable)
index bd0aedb..2f20c5b
--- a/inc/FUiCtrlTabBar.h
+++ b/inc/FUiCtrlTabBar.h
@@ -186,7 +186,9 @@ public:
         * @return      An error code
         * @param[in]   x                       The X position of the top left corner
         * @param[in]   y                       The Y position of the top left corner
-        * @param[in]   width                   The width
+        * @param[in]   width                   The width @n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_INVALID_ARG           A specified input parameter is invalid.
         * @exception   E_INVALID_STATE         This instance is in an invalid state.
@@ -202,7 +204,9 @@ public:
         * @return      An error code
         * @param[in]   x                       The X position of the top left corner
         * @param[in]   y                       The Y position of the top left corner
-        * @param[in]   width                   The width
+        * @param[in]   width                   The width @n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @exception   E_SUCCESS               The method is successful.
         * @exception   E_INVALID_ARG           A specified input parameter is invalid.
         * @exception   E_INVALID_STATE         This instance is in an invalid state.

diff --git a/inc/FUiCtrlTextBox.h b/inc/FUiCtrlTextBox.h
old mode 100644 (file)
new mode 100755 (executable)
index 6de7280..7ce4181
--- a/inc/FUiCtrlTextBox.h
+++ b/inc/FUiCtrlTextBox.h
@@ -201,7 +201,9 @@ public:
         * @return              An error code
         * @param[in]   rect                An instance of the Graphics::Rectangle class @n
         *                                                                      This instance represents the x and y coordinates of the top-left corner of the created window along with
-        *                                                                      the width and height of the control.
+        *                                                                      the width and height of the control.@n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   border              The border style
         * @exception   E_SUCCESS           The method is successful.
         * @exception   E_SYSTEM            A system error has occurred.
@@ -216,7 +218,9 @@ public:
         * @return              An error code
         * @param[in]   rect                            An instance of the Tizen::Graphics::FloatRectangle class @n
         *                                                                      This instance represents the x and y coordinates of the top-left corner of the created window along with
-        *                                                                      the width and height of the control.
+        *                                                                      the width and height of the control.@n\r
+        *                                                                      The optimal size of the control is defined in\r
+        *                                                                      <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         * @param[in]   border                          The border style
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_SYSTEM                        A system error has occurred.

diff --git a/inc/FUiCtrlTimePicker.h b/inc/FUiCtrlTimePicker.h
old mode 100644 (file)
new mode 100755 (executable)
index 2c33e31..d34955d
--- a/inc/FUiCtrlTimePicker.h
+++ b/inc/FUiCtrlTimePicker.h
@@ -229,7 +229,9 @@ public:
         * @exception   E_SUCCESS           The method is successful.
         * @exception   E_SYSTEM                    A system error has occurred.
         * @remarks             The default owner will be the current Form (or Frame). It is possible that this control may not be visible
-        * due to this ownership relationship. @n In this case, use the SetOwner() method to change the ownership to the top-most window.
+        * due to this ownership relationship. @n In this case, use the SetOwner() method to change the ownership to the top-most window. @n
+        * The optimal size of the control is defined in\r
+        * <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
         */
        result Construct(const Tizen::Base::String& title = L"");