Revert "[NUI] Fix RaiseToTop error (#413)" (#419)
[platform/core/csapi/tizenfx.git] / src / Tizen.NUI / src / public / Container.cs
index 515874e..20f6e89 100755 (executable)
@@ -1,39 +1,57 @@
-/** 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.
+ *
+ */
 
 using System;
+using System.Collections.Generic;
 using Tizen.NUI.BaseComponents;
 
 namespace Tizen.NUI
 {
     /// <summary>
-    ///
-    /// Container is an abstract class to be inherited from by classes that desire to have Views
+    /// The Container is an abstract class to be inherited from by classes that desire to have views
     /// added to them.
-    ///
     /// </summary>
-
+    /// <since_tizen> 4 </since_tizen>
     public abstract class Container : Animatable
     {
 
+        private List<View> _childViews = new List<View>();
+
+        /// <summary>
+        /// List of children of Container.
+        /// </summary>
+        /// <since_tizen> 4 </since_tizen>
+        public List<View> Children
+        {
+            get
+            {
+                return _childViews;
+            }
+        }
+
         internal Container(global::System.IntPtr cPtr, bool cMemoryOwn) : base(cPtr, cMemoryOwn)
         {
             // No un-managed data hence no need to store a native ptr
         }
 
+        /// <summary>
+        /// Dispose.
+        /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         protected override void Dispose(DisposeTypes type)
         {
             if (disposed)
@@ -44,52 +62,57 @@ namespace Tizen.NUI
             base.Dispose(type);
         }
 
-
         /// <summary>
         /// Adds a child view to this Container.
         /// </summary>
-        /// <pre>This Container(the parent) has been initialized. The child view has been initialized. The child view is not the same as the parent view.</pre>
+        /// <pre>This Container (the parent) has been initialized. The child view has been initialized. The child view is not the same as the parent view.</pre>
         /// <post>The child will be referenced by its parent. This means that the child will be kept alive, even if the handle passed into this method is reset or destroyed.</post>
-        /// <remarks>If the child already has a parent, it will be removed from old parent and reparented to this view. This may change child's position, color, scale etc as it now inherits them from this view.</remarks>
-        /// <param name="view">The child view to add</param>
+        /// <remarks>If the child already has a parent, it will be removed from the old parent and reparented to this view. This may change child's position, color, scale, etc. as it now inherits them from this view.</remarks>
+        /// <param name="view">The child view to add.</param>
+        /// <since_tizen> 4 </since_tizen>
         public abstract void Add( View view );
 
         /// <summary>
-        /// Removes a child View from this View. If the view was not a child of this view, this is a no-op.
+        /// Removes a child view from this view. If the view was not a child of this view, this is a no-op.
         /// </summary>
         /// <pre>This View(the parent) has been initialized. The child view is not the same as the parent view.</pre>
-        /// <param name="child">The child</param>
+        /// <param name="view">The view to remove</param>
+        /// <since_tizen> 4 </since_tizen>
         public abstract void Remove( View view );
 
         /// <summary>
-        /// Retrieves child view by index.
+        /// Retrieves the child view by the index.
         /// </summary>
-        /// <pre>The View has been initialized.</pre>
-        /// <param name="index">The index of the child to retrieve</param>
-        /// <returns>The view for the given index or empty handle if children not initialized</returns>
+        /// <pre>The view has been initialized.</pre>
+        /// <param name="index">The index of the child to retrieve.</param>
+        /// <returns>The view for the given index or empty handle if children are not initialized.</returns>
+        /// <since_tizen> 4 </since_tizen>
         public abstract View GetChildAt( uint index );
 
         /// <summary>
-        /// Get the parent of this container
+        /// Gets the parent of this container.
         /// </summary>
         /// <pre>The child container has been initialized.</pre>
-        /// <returns>The parent container</returns>
-        protected abstract Container GetParent();
+        /// <returns>The parent container.</returns>
+        /// <since_tizen> 4 </since_tizen>
+        public abstract Container GetParent();
 
         /// <summary>
-        /// Get the number of children for this container
+        /// Gets the number of children for this container.
         /// </summary>
         /// <pre>The container has been initialized.</pre>
-        /// <returns>number of children</returns>
-        protected abstract UInt32 GetChildCount();
+        /// <returns>The number of children.</returns>
+        /// <since_tizen> 4 </since_tizen>
+        public abstract UInt32 GetChildCount();
 
         /// <summary>
-        /// Get the parent Container
+        /// Gets the parent container.
         /// Read only
         /// </summary>
         /// <pre>The child container has been initialized.</pre>
-        /// <returns>The parent container</returns>
-        public Container Parent
+        /// <returns>The parent container.</returns>
+        /// <since_tizen> 4 </since_tizen>
+        public new Container Parent
         {
             get
             {
@@ -98,11 +121,12 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Get the number of children for this container
+        /// Gets the number of children for this container.
         /// Read only
         /// </summary>
         /// <pre>The container has been initialized.</pre>
-        /// <returns>number of children</returns>
+        /// <returns>The number of children.</returns>
+        /// <since_tizen> 4 </since_tizen>
         public uint ChildCount
         {
             get
@@ -111,4 +135,4 @@ namespace Tizen.NUI
             }
         }
     }
-} // namespace Tizen.NUI
\ No newline at end of file
+} // namespace Tizen.NUI