Release 4.0.0-preview1-00301
[platform/core/csapi/tizenfx.git] / src / Tizen.NUI / src / public / UIComponents / Popup.cs
index 4b7a296..4eba768 100755 (executable)
@@ -1,18 +1,19 @@
-/** Copyright (c) 2017 Samsung Electronics Co., Ltd.
-*
-* Licensed under the Apache License, Version 2.0 (the "License");
-* you may not use this file except in compliance with the License.
-* You may obtain a copy of the License at
-*
-* http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing, software
-* distributed under the License is distributed on an "AS IS" BASIS,
-* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-* See the License for the specific language governing permissions and
-* limitations under the License.
-*
-*/
+/*
+ * Copyright(c) 2017 Samsung Electronics Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
 
 namespace Tizen.NUI.UIComponents
 {
@@ -22,7 +23,7 @@ namespace Tizen.NUI.UIComponents
     using Tizen.NUI.BaseComponents;
 
     /// <summary>
-    /// The Popup widget provides a configurable pop-up dialog with built-in layout of three main fields.
+    /// The Popup widget provides a configurable popup dialog with a built-in layout of three main fields.
     /// </summary>
     public class Popup : View
     {
@@ -38,7 +39,11 @@ namespace Tizen.NUI.UIComponents
             return (obj == null) ? new global::System.Runtime.InteropServices.HandleRef(null, global::System.IntPtr.Zero) : obj.swigCPtr;
         }
 
-
+        /// <summary>
+        /// Dispose.
+        /// </summary>
+        /// <param name="type">The dispose type</param>
+        /// <since_tizen> 3 </since_tizen>
         protected override void Dispose(DisposeTypes type)
         {
             if (disposed)
@@ -100,35 +105,35 @@ namespace Tizen.NUI.UIComponents
 
 
         /// <summary>
-        /// Event arguments that passed via OutsideTouchedEvent
+        /// Event arguments that passed via the OutsideTouchedEvent.
         /// </summary>
         public class TouchedOutsideEventArgs : EventArgs
         {
         }
 
         /// <summary>
-        /// Event arguments that passed via ShowingEventArgs
+        /// Event arguments that passed via the ShowingEventArgs.
         /// </summary>
         public class ShowingEventArgs : EventArgs
         {
         }
 
         /// <summary>
-        /// Event arguments that passed via ShownEventArgs
+        /// Event arguments that passed via the ShownEventArgs.
         /// </summary>
         public class ShownEventArgs : EventArgs
         {
         }
 
         /// <summary>
-        /// Event arguments that passed via HidingEventArgs
+        /// Event arguments that passed via the HidingEventArgs.
         /// </summary>
         public class HidingEventArgs : EventArgs
         {
         }
 
         /// <summary>
-        /// Event arguments that passed via HiddenEventArgs
+        /// Event arguments that passed via the HiddenEventArgs.
         /// </summary>
         public class HiddenEventArgs : EventArgs
         {
@@ -160,8 +165,9 @@ namespace Tizen.NUI.UIComponents
         private HiddenEventCallbackDelegate _popUpHiddenEventCallbackDelegate;
 
         /// <summary>
-        /// Event is sent when user has touched outside of the Dialog.
+        /// An event is sent when the user has touched outside the dialog.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         public event EventHandler<TouchedOutsideEventArgs> TouchedOutside
         {
             add
@@ -196,8 +202,9 @@ namespace Tizen.NUI.UIComponents
         }
 
         /// <summary>
-        /// Event is sent when the Popup is starting to be shown.
+        /// An event is sent when the popup starts showing.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandler<ShowingEventArgs> Showing
         {
             add
@@ -233,8 +240,9 @@ namespace Tizen.NUI.UIComponents
 
 
         /// <summary>
-        /// Event is sent when the Popup has been fully displayed.
+        /// An event is sent when the popup has been fully displayed.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandler<ShownEventArgs> Shown
         {
             add
@@ -269,8 +277,9 @@ namespace Tizen.NUI.UIComponents
         }
 
         /// <summary>
-        /// Event is sent when the Popup is starting to be hidden.
+        /// An event is sent when the popup starts to hide.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandler<HidingEventArgs> Hiding
         {
             add
@@ -305,8 +314,9 @@ namespace Tizen.NUI.UIComponents
         }
 
         /// <summary>
-        /// Event is sent when the Popup has been completely hidden.
+        /// An event is sent when the popup has been completely hidden.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandler<HiddenEventArgs> Hidden
         {
             add
@@ -366,14 +376,19 @@ namespace Tizen.NUI.UIComponents
         }
 
         /// <summary>
-        /// Create the Popup.
+        /// Creates the popup.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public Popup() : this(NDalicPINVOKE.Popup_New(), true)
         {
             if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
 
         }
 
+        /// <summary>
+        /// Please do not use! this will be deprecated
+        /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         [Obsolete("Please do not use! this will be deprecated")]
         public new static Popup DownCast(BaseHandle handle)
         {
@@ -383,9 +398,10 @@ namespace Tizen.NUI.UIComponents
         }
 
         /// <summary>
-        /// Sets a title for this Popup.
+        /// Sets the title for this popup.
         /// </summary>
-        /// <param name="titleView">The actor to set a title</param>
+        /// <param name="titleView">The actor to set the title.</param>
+        /// <since_tizen> 3 </since_tizen>
         public void SetTitle(View titleView)
         {
             NDalicPINVOKE.Popup_SetTitle(swigCPtr, View.getCPtr(titleView));
@@ -404,7 +420,8 @@ namespace Tizen.NUI.UIComponents
         /// <summary>
         /// Sets the content actor.
         /// </summary>
-        /// <param name="content">The actor to use</param>
+        /// <param name="content">The actor to use.</param>
+        /// <since_tizen> 3 </since_tizen>
         public void SetContent(View content)
         {
             NDalicPINVOKE.Popup_SetContent(swigCPtr, View.getCPtr(content));
@@ -421,9 +438,10 @@ namespace Tizen.NUI.UIComponents
         }
 
         /// <summary>
-        /// Sets the actor to use for a footer in this Popup.
+        /// Sets the actor to use for the footer in this popup.
         /// </summary>
-        /// <param name="footer">The footer actor to be added to this Popup</param>
+        /// <param name="footer">The footer actor to be added to this popup.</param>
+        /// <since_tizen> 3 </since_tizen>
         public void SetFooter(View footer)
         {
             NDalicPINVOKE.Popup_SetFooter(swigCPtr, View.getCPtr(footer));
@@ -440,22 +458,23 @@ namespace Tizen.NUI.UIComponents
         }
 
         /// <summary>
-        /// Sets the display state of Popup.<br>
-        /// There are 4 total display states.<br>
-        /// Only 2 can be set, but all four can be read for better inspection of the current popup state.<br>
-        /// <br>
-        /// The other two states are getable, but not setable and are there for consistency.<br>
-        /// <br>
-        /// | Value    | Setting the state              | Getting the state              |<br>
-        /// |----------|--------------------------------|--------------------------------|<br>
-        /// | SHOWN    | Show the popup                 | The popup is fully shown       |<br>
-        /// | HIDDEN   | Hide the popup                 | The popup is fully hidden      |<br>
-        /// | SHOWING  |                                | The popup is transitioning in  |<br>
-        /// | HIDING   |                                | The popup is transitioning out |<br>
-        /// <br>
-        /// All 4 state changes cause notifications via 4 respective signals that can be connected to.<br>
+        /// Sets the display state of popup.<br />
+        /// There are 4 total display states.<br />
+        /// Only 2 can be set, but all four can be read for better inspection of the current popup state.<br />
+        /// <br />
+        /// The other two states are getable, but not setable, and are there for consistency.<br />
+        /// <br />
+        /// | Value    | Setting the state              | Getting the state              |<br />
+        /// |----------|--------------------------------|--------------------------------|<br />
+        /// | SHOWN    | Show the popup                 | The popup is fully shown       |<br />
+        /// | HIDDEN   | Hide the popup                 | The popup is fully hidden      |<br />
+        /// | SHOWING  |                                | The popup is transitioning in  |<br />
+        /// | HIDING   |                                | The popup is transitioning out |<br />
+        /// <br />
+        /// All 4 states changes cause notifications via 4 respective signals that can be connected to.<br />
         /// </summary>
-        /// <param name="displayState">The desired display state to change to</param>
+        /// <param name="displayState">The desired display state to change to.</param>
+        /// <since_tizen> 3 </since_tizen>
         public void SetDisplayState(Popup.DisplayStateType displayState)
         {
             NDalicPINVOKE.Popup_SetDisplayState(swigCPtr, (int)displayState);
@@ -505,45 +524,101 @@ namespace Tizen.NUI.UIComponents
         }
 
         /// <summary>
-        /// The display states of the Popup.
+        /// The display states of the popup.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public enum DisplayStateType
         {
+            /// <summary>
+            /// The popup is transitioning in
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             Showing,
+            /// <summary>
+            /// The popup is fully shown
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             Shown,
+            /// <summary>
+            /// The popup is transitioning out
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             Hiding,
+            /// <summary>
+            /// The popup is fully hidden
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             Hidden
         }
 
         /// <summary>
-        /// The animation mode within popup.<br>
-        /// Choose from a predefined mode or "CUSTOM" to use the ANIMATION_IN and ANIMATION_OUT properties.<br>
+        /// The animation modes within the popup.<br />
+        /// Choose from a predefined mode or "CUSTOM" to use the ANIMATION_IN and ANIMATION_OUT properties.<br />
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public enum AnimationModeType
         {
+            /// <summary>
+            /// No animation.
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             None,
+            /// <summary>
+            /// Popup zooms in and out animating the scale property.
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             Zoom,
+            /// <summary>
+            /// Popup fades in and out
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             Fade,
+            /// <summary>
+            /// Use the EntryAnimation and ExitAnimation animation properties.
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             Custom
         }
 
         /// <summary>
-        /// Types of contextual layout.<br>
-        /// The Popup is positioned adjacent to it's parent in the direction specified by this mode.<br>
-        /// NON_CONTEXTUAL disables any contextual positioning.<br>
+        /// The types of the contextual layout.<br />
+        /// The popup is positioned adjacent to it's parent in the direction specified by this mode.<br />
+        /// NON_CONTEXTUAL disables any contextual positioning.<br />
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public enum ContextualModeType
         {
+            /// <summary>
+            /// any contextual positioning
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             NonContextual,
+            /// <summary>
+            /// Above
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             Above,
+            /// <summary>
+            /// Rright
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             Rright,
+            /// <summary>
+            /// Below
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             Below,
+            /// <summary>
+            /// Left
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             Left
         }
 
         /// <summary>
-        /// Popup title.
+        /// The popup title.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public PropertyMap Title
         {
             get
@@ -558,8 +633,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Popup content.
+        /// The popup content.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public PropertyMap Content
         {
             get
@@ -574,8 +650,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Popup footer.
+        /// The popup footer.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public PropertyMap Footer
         {
             get
@@ -590,8 +667,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Popup display state.
+        /// The popup display state.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public DisplayStateType DisplayState
         {
             get
@@ -650,8 +728,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Touch transparent.
+        /// The touch transparent.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public bool TouchTransparent
         {
             get
@@ -666,8 +745,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Popup tail visibility.
+        /// The popup tail visibility.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public bool TailVisibility
         {
             get
@@ -682,8 +762,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Popup tail position.
+        /// The popup tail position.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public Vector3 TailPosition
         {
             get
@@ -698,8 +779,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Contextual mode.
+        /// The contextual mode.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public ContextualModeType ContextualMode
         {
             get
@@ -765,8 +847,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Animation duration.
+        /// The animation duration.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public float AnimationDuration
         {
             get
@@ -781,8 +864,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Animation mode.
+        /// The animation mode.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public AnimationModeType AnimationMode
         {
             get
@@ -841,8 +925,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Entry animation.
+        /// The entry animation.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public PropertyMap EntryAnimation
         {
             get
@@ -857,8 +942,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Exit animation.
+        /// The exit animation.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public PropertyMap ExitAnimation
         {
             get
@@ -873,8 +959,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Auto hide delay.
+        /// The auto hide delay.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public int AutoHideDelay
         {
             get
@@ -889,8 +976,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Backing enabled.
+        /// The backing enabled.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public bool BackingEnabled
         {
             get
@@ -905,8 +993,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Backing color.
+        /// The backing color.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public Vector4 BackingColor
         {
             get
@@ -921,8 +1010,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Background image.
+        /// The background image.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public string PopupBackgroundImage
         {
             get
@@ -937,8 +1027,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Background border.
+        /// The background border.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public Rectangle PopupBackgroundBorder
         {
             get
@@ -953,8 +1044,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Tail up image.
+        /// The tail up image.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public string TailUpImage
         {
             get
@@ -969,8 +1061,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Tail down image.
+        /// The tail down image.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public string TailDownImage
         {
             get
@@ -985,8 +1078,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Tail left image.
+        /// The tail left image.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public string TailLeftImage
         {
             get
@@ -1001,8 +1095,9 @@ namespace Tizen.NUI.UIComponents
             }
         }
         /// <summary>
-        /// Tail right image.
+        /// The tail right image.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public string TailRightImage
         {
             get
@@ -1019,4 +1114,4 @@ namespace Tizen.NUI.UIComponents
 
     }
 
-}
+}
\ No newline at end of file