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.
18 using Tizen.NUI.BaseComponents;
19 using System.ComponentModel;
25 /// Layers provide a mechanism for overlaying groups of actors on top of each other.
27 /// <since_tizen> 3 </since_tizen>
28 public class Layer : Container
30 private global::System.Runtime.InteropServices.HandleRef swigCPtr;
32 internal Layer(global::System.IntPtr cPtr, bool cMemoryOwn) : base(NDalicPINVOKE.Layer_SWIGUpcast(cPtr), cMemoryOwn)
34 swigCPtr = new global::System.Runtime.InteropServices.HandleRef(this, cPtr);
37 internal static global::System.Runtime.InteropServices.HandleRef getCPtr(Layer obj)
39 return (obj == null) ? new global::System.Runtime.InteropServices.HandleRef(null, global::System.IntPtr.Zero) : obj.swigCPtr;
42 /// From the Container base class.
45 /// Adds a child view to this layer.
47 /// <seealso cref="Container.Add">
49 /// <since_tizen> 4 </since_tizen>
50 public override void Add(View child)
52 NDalicPINVOKE.Actor_Add(swigCPtr, View.getCPtr(child));
53 if (NDalicPINVOKE.SWIGPendingException.Pending)
54 throw NDalicPINVOKE.SWIGPendingException.Retrieve();
60 /// Removes a child view from this layer. If the view was not a child of this layer, this is a no-op.
62 /// <seealso cref="Container.Remove">
64 /// <since_tizen> 4 </since_tizen>
65 public override void Remove(View child)
67 NDalicPINVOKE.Actor_Remove(swigCPtr, View.getCPtr(child));
68 if (NDalicPINVOKE.SWIGPendingException.Pending)
69 throw NDalicPINVOKE.SWIGPendingException.Retrieve();
71 Children.Remove(child);
75 /// Retrieves a child view by the index.
77 /// <pre>The view has been initialized.</pre>
78 /// <param name="index">The index of the child to retrieve.</param>
79 /// <returns>The view for the given index or empty handle if children not initialized.</returns>
80 /// <since_tizen> 4 </since_tizen>
81 public override View GetChildAt(uint index)
83 if (index < Children.Count)
85 return Children[Convert.ToInt32(index)];
95 /// Get parent of the layer.
97 /// <returns>The view's container</returns>
98 /// <since_tizen> 4 </since_tizen>
99 public override Container GetParent()
105 /// Get the child count of the layer.
107 /// <returns>The child count of the layer.</returns>
108 /// <since_tizen> 4 </since_tizen>
109 public override uint GetChildCount()
111 return Convert.ToUInt32(Children.Count);
117 /// <since_tizen> 3 </since_tizen>
118 protected override void Dispose(DisposeTypes type)
125 if(type == DisposeTypes.Explicit)
128 //Release your own managed resources here.
129 //You should release all of your own disposable objects here.
132 //Release your own unmanaged resources here.
133 //You should not access any managed member here except static instance.
134 //because the execution order of Finalizes is non-deterministic.
136 if (swigCPtr.Handle != global::System.IntPtr.Zero)
141 NDalicPINVOKE.delete_Layer(swigCPtr);
143 swigCPtr = new global::System.Runtime.InteropServices.HandleRef(null, global::System.IntPtr.Zero);
151 internal class Property
153 internal static readonly int BEHAVIOR = NDalicPINVOKE.Layer_Property_BEHAVIOR_get();
157 /// Creates a Layer object.
159 /// <since_tizen> 3 </since_tizen>
160 public Layer() : this(NDalicPINVOKE.Layer_New(), true)
162 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
163 if(Window.Instance != null)
165 this.SetParentOrigin(Tizen.NUI.ParentOrigin.TopLeft);
166 this.SetAnchorPoint(Tizen.NUI.PivotPoint.TopLeft);
167 this.SetResizePolicy(ResizePolicyType.FillToParent, DimensionType.AllDimensions);
170 internal void SetAnchorPoint(Vector3 anchorPoint)
172 NDalicPINVOKE.Actor_SetAnchorPoint(swigCPtr, Vector3.getCPtr(anchorPoint));
173 if (NDalicPINVOKE.SWIGPendingException.Pending)
174 throw NDalicPINVOKE.SWIGPendingException.Retrieve();
176 internal void SetResizePolicy(ResizePolicyType policy, DimensionType dimension)
178 NDalicPINVOKE.Actor_SetResizePolicy(swigCPtr, (int)policy, (int)dimension);
179 if (NDalicPINVOKE.SWIGPendingException.Pending)
180 throw NDalicPINVOKE.SWIGPendingException.Retrieve();
182 internal void SetParentOrigin(Vector3 origin)
184 NDalicPINVOKE.Actor_SetParentOrigin(swigCPtr, Vector3.getCPtr(origin));
185 if (NDalicPINVOKE.SWIGPendingException.Pending)
186 throw NDalicPINVOKE.SWIGPendingException.Retrieve();
190 /// Downcasts a handle to layer handle.
192 /// <since_tizen> 3 </since_tizen>
193 /// Please do not use! this will be deprecated!
194 /// Instead please use as keyword.
195 [Obsolete("Please do not use! This will be deprecated! Please use as keyword instead!")]
196 [EditorBrowsable(EditorBrowsableState.Never)]
197 public static Layer DownCast(BaseHandle handle)
199 Layer ret = Registry.GetManagedBaseHandleFromNativePtr(handle) as Layer;
200 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
205 /// Search through this layer's hierarchy for a view with the given unique ID.
207 /// <pre>This layer (the parent) has been initialized.</pre>
208 /// <remarks>The actor itself is also considered in the search.</remarks>
209 /// <param name="id">The id of the child to find</param>
210 /// <returns> A handle to the view if found, or an empty handle if not. </returns>
211 /// <since_tizen> 3 </since_tizen>
212 public View FindChildById(uint id)
214 IntPtr cPtr = NDalicPINVOKE.Actor_FindChildById(swigCPtr, id);
215 View ret = Registry.GetManagedBaseHandleFromNativePtr(cPtr) as View;
217 if (NDalicPINVOKE.SWIGPendingException.Pending)
218 throw NDalicPINVOKE.SWIGPendingException.Retrieve();
223 /// Queries the depth of the layer.<br />
224 /// 0 is the bottommost layer, higher number is on the top.<br />
226 /// <since_tizen> 3 </since_tizen>
235 internal uint GetDepth()
237 var parentChildren = Window.Instance.LayersChildren;
238 if(parentChildren != null)
240 int idx = parentChildren.IndexOf(this);
243 return Convert.ToUInt32(idx); ;
250 /// Increments the depth of the layer.
252 /// <since_tizen> 3 </since_tizen>
255 var parentChildren = Window.Instance.LayersChildren;
256 if (parentChildren != null)
258 int currentIdx = parentChildren.IndexOf(this);
260 if (currentIdx != parentChildren.Count - 1)
262 RaiseAbove(parentChildren[currentIdx + 1]);
264 Layer temp = parentChildren[currentIdx + 1];
265 parentChildren[currentIdx + 1] = this;
266 parentChildren[currentIdx] = temp;
272 /// Decrements the depth of the layer.
274 /// <since_tizen> 3 </since_tizen>
277 var parentChildren = Window.Instance.LayersChildren;
278 if (parentChildren != null)
280 int currentIdx = parentChildren.IndexOf(this);
284 LowerBelow(parentChildren[currentIdx - 1]);
286 Layer temp = parentChildren[currentIdx - 1];
287 parentChildren[currentIdx - 1] = this;
288 parentChildren[currentIdx] = temp;
294 internal void RaiseAbove(Layer target)
296 NDalicPINVOKE.Layer_RaiseAbove(swigCPtr, Layer.getCPtr(target));
297 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
300 internal void LowerBelow(Layer target)
302 NDalicPINVOKE.Layer_LowerBelow(swigCPtr, Layer.getCPtr(target));
303 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
307 /// Raises the layer to the top.
309 /// <since_tizen> 3 </since_tizen>
310 public void RaiseToTop()
312 var parentChildren = Window.Instance.LayersChildren;
314 if (parentChildren != null)
316 parentChildren.Remove(this);
317 parentChildren.Add(this);
319 NDalicPINVOKE.Layer_RaiseToTop(swigCPtr);
320 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
324 /// Lowers the layer to the bottom.
326 /// <since_tizen> 3 </since_tizen>
327 public void LowerToBottom()
329 var parentChildren = Window.Instance.LayersChildren;
331 if (parentChildren != null)
333 parentChildren.Remove(this);
334 parentChildren.Insert(0, this);
337 NDalicPINVOKE.Layer_LowerToBottom(swigCPtr);
338 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
342 /// Moves the layer directly above the given layer.<br />
343 /// After the call, this layer's depth will be immediately above target.<br />
345 /// <param name="target">The layer to get on top of.</param>
346 /// <since_tizen> 3 </since_tizen>
347 public void MoveAbove(Layer target)
349 NDalicPINVOKE.Layer_MoveAbove(swigCPtr, Layer.getCPtr(target));
350 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
354 /// Moves the layer directly below the given layer.<br />
355 /// After the call, this layer's depth will be immediately below target.<br />
357 /// <param name="target">The layer to get below of.</param>
358 /// <since_tizen> 3 </since_tizen>
359 public void MoveBelow(Layer target)
361 NDalicPINVOKE.Layer_MoveBelow(swigCPtr, Layer.getCPtr(target));
362 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
365 private void SetBehavior(LayerBehavior behavior)
367 NDalicPINVOKE.Layer_SetBehavior(swigCPtr, (int)behavior);
368 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
371 private LayerBehavior GetBehavior()
373 Layer.LayerBehavior ret = (Layer.LayerBehavior)NDalicPINVOKE.Layer_GetBehavior(swigCPtr);
374 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
378 internal void SetSortFunction(SWIGTYPE_p_f_r_q_const__Dali__Vector3__float function)
380 NDalicPINVOKE.Layer_SetSortFunction(swigCPtr, SWIGTYPE_p_f_r_q_const__Dali__Vector3__float.getCPtr(function));
381 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
384 internal void SetTouchConsumed(bool consume)
386 NDalicPINVOKE.Layer_SetTouchConsumed(swigCPtr, consume);
387 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
390 internal bool IsTouchConsumed()
392 bool ret = NDalicPINVOKE.Layer_IsTouchConsumed(swigCPtr);
393 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
397 internal void SetHoverConsumed(bool consume)
399 NDalicPINVOKE.Layer_SetHoverConsumed(swigCPtr, consume);
400 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
403 internal bool IsHoverConsumed()
405 bool ret = NDalicPINVOKE.Layer_IsHoverConsumed(swigCPtr);
406 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
411 /// Enumeration for the behavior of the layer.
413 /// <since_tizen> 3 </since_tizen>
414 public enum LayerBehavior
417 /// UI control rendering mode.
419 /// <since_tizen> 3 </since_tizen>
422 /// UI control rendering mode (default mode).
423 /// This mode is designed for UI controls that can overlap. In this
424 /// mode renderer order will be respective to the tree hierarchy of
426 /// The rendering order is depth first, so for the following actor tree,
427 /// A will be drawn first, then B, D, E, then C, F. This ensures that
428 /// overlapping actors are drawn as expected (whereas, with breadth first
429 /// traversal, the actors would interleave).<br />
431 /// <since_tizen> 3 </since_tizen>
434 /// Layer will use depth test.
435 /// This mode is designed for a 3 dimensional scene where actors in front
436 /// of other actors will obscure them, i.e. the actors are sorted by the
437 /// distance from the camera.<br />
438 /// When using this mode, a depth test will be used. A depth clear will
439 /// happen for each layer, which means actors in a layer "above" other
440 /// layers will be rendered in front of actors in those layers regardless
441 /// of their Z positions (see Layer::Raise() and Layer::Lower()).<br />
442 /// Opaque renderers are drawn first and write to the depth buffer. Then
443 /// transparent renderers are drawn with depth test enabled but depth
444 /// write switched off. Transparent renderers are drawn based on their
445 /// distance from the camera. A renderer's DEPTH_INDEX property is used to
446 /// offset the distance to the camera when ordering transparent renderers.
447 /// This is useful if you want to define the draw order of two or more
448 /// transparent renderers that are equal distance from the camera. Unlike
449 /// LAYER_UI, parent-child relationship does not affect rendering order at
452 /// <since_tizen> 3 </since_tizen>
456 internal enum TreeDepthMultiplier
458 TREE_DEPTH_MULTIPLIER = 10000
462 /// Layer behavior, type String (Layer.LayerBehavior).
464 /// <since_tizen> 3 </since_tizen>
465 public Layer.LayerBehavior Behavior
469 return GetBehavior();
478 /// Internal only property to enable or disable clipping, type boolean.
479 /// By default, this is false, i.e., the viewport of the layer is the entire window.
481 internal bool ClippingEnabled
485 bool ret = NDalicPINVOKE.Layer_IsClipping(swigCPtr);
486 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
491 NDalicPINVOKE.Layer_SetClipping(swigCPtr, value);
492 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
497 /// Sets the viewport (in window coordinates), type rectangle.
498 /// The contents of the layer will not be visible outside this box, when ViewportEnabled is true.
500 /// <since_tizen> 4 </since_tizen>
501 public Rectangle Viewport
505 if( ClippingEnabled )
507 Rectangle ret = new Rectangle(NDalicPINVOKE.Layer_GetClippingBox(swigCPtr), true);
508 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
513 // Clipping not enabled so return the window size
514 Size2D windowSize = Window.Instance.Size;
515 Rectangle ret = new Rectangle(0, 0, windowSize.Width, windowSize.Height);
521 NDalicPINVOKE.Layer_SetClippingBox__SWIG_1(swigCPtr, Rectangle.getCPtr(value));
522 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
523 ClippingEnabled = true;
528 /// Retrieves and sets the layer's opacity.<br />
530 /// <since_tizen> 3 </since_tizen>
536 GetProperty(View.Property.OPACITY).Get(out temp);
541 SetProperty(View.Property.OPACITY, new Tizen.NUI.PropertyValue(value));
546 /// Retrieves and sets the layer's visibility.
548 /// <since_tizen> 3 </since_tizen>
549 public bool Visibility
554 GetProperty(View.Property.VISIBLE).Get(out temp);
559 SetProperty(View.Property.VISIBLE, new Tizen.NUI.PropertyValue(value));
564 /// Get the number of children held by the layer.
566 /// <since_tizen> 3 </since_tizen>
567 public new uint ChildCount
571 return Convert.ToUInt32(Children.Count);
576 /// Gets or sets the layer's name.
578 /// <since_tizen> 3 </since_tizen>
591 internal string GetName()
593 string ret = NDalicPINVOKE.Actor_GetName(swigCPtr);
594 if (NDalicPINVOKE.SWIGPendingException.Pending)
595 throw NDalicPINVOKE.SWIGPendingException.Retrieve();
599 internal void SetName(string name)
601 NDalicPINVOKE.Actor_SetName(swigCPtr, name);
602 if (NDalicPINVOKE.SWIGPendingException.Pending)
603 throw NDalicPINVOKE.SWIGPendingException.Retrieve();