2 * Copyright(c) 2017 Samsung Electronics Co., Ltd.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
19 using System.Collections.Generic;
20 using System.ComponentModel;
21 using Tizen.NUI.BaseComponents;
22 using Tizen.NUI.Binding;
27 /// The Container is an abstract class to be inherited from by classes that desire to have views
30 /// <since_tizen> 4 </since_tizen>
31 public abstract class Container : Animatable
33 internal BaseHandle InternalParent;
34 private List<View> _childViews = new List<View>();
36 internal Container(global::System.IntPtr cPtr, bool cMemoryOwn) : base(cPtr, cMemoryOwn)
38 // No un-managed data hence no need to store a native ptr
42 /// List of children of Container.
44 /// <since_tizen> 4 </since_tizen>
45 public List<View> Children
54 /// Gets the parent container.
57 /// <pre>The child container has been initialized.</pre>
58 /// <returns>The parent container.</returns>
59 /// <since_tizen> 4 </since_tizen>
60 [System.Diagnostics.CodeAnalysis.SuppressMessage("Design", "CA1721: Property names should not match get methods")]
61 public new Container Parent
70 /// Gets the number of children for this container.
73 /// <pre>The container has been initialized.</pre>
74 /// <returns>The number of children.</returns>
75 /// <since_tizen> 4 </since_tizen>
76 public uint ChildCount
80 return Convert.ToUInt32(Children.Count);
85 /// Adds a child view to this Container.
87 /// <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>
88 /// <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>
89 /// <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>
90 /// <param name="view">The child view to add.</param>
91 /// <since_tizen> 4 </since_tizen>
92 public abstract void Add(View view);
95 /// Removes a child view from this view. If the view was not a child of this view, this is a no-op.
97 /// <pre>This View(the parent) has been initialized. The child view is not the same as the parent view.</pre>
98 /// <param name="view">The view to remove</param>
99 /// <since_tizen> 4 </since_tizen>
100 public abstract void Remove(View view);
103 /// Retrieves the child view by the index.
105 /// <pre>The view has been initialized.</pre>
106 /// <param name="index">The index of the child to retrieve.</param>
107 /// <returns>The view for the given index or empty handle if children are not initialized.</returns>
108 /// <since_tizen> 4 </since_tizen>
109 public abstract View GetChildAt(uint index);
112 /// Gets the parent of this container.
114 /// <pre>The child container has been initialized.</pre>
115 /// <returns>The parent container.</returns>
116 /// <since_tizen> 4 </since_tizen>
117 [System.Diagnostics.CodeAnalysis.SuppressMessage("Design", "CA1721: Property names should not match get methods")]
118 public abstract Container GetParent();
121 /// Gets the number of children for this container.
123 /// <pre>The container has been initialized.</pre>
124 /// <returns>The number of children.</returns>
125 /// <since_tizen> 4 </since_tizen>
126 // [Obsolete("Deprecated in API9, will be removed in API11. Please use ChildCount property instead!")]
127 public abstract UInt32 GetChildCount();
129 internal abstract View FindCurrentChildById(uint id);
131 } // namespace Tizen.NUI