-/*
- * Copyright(c) 2020 Samsung Electronics Co., Ltd.
+/*
+ * Copyright(c) 2022 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.
AlphaFunction.BuiltinFunctions? alphaFunction = null,
object initialValue = null)
{
- Tizen.NUI.PropertyMap background = Background;
-
- if (background.Empty())
+ if (IsBackgroundEmpty())
{
// If there is no background yet, ensure there is a transparent
// color visual
BackgroundColor = new Color(0.0f, 0.0f, 0.0f, 0.0f);
- background = Background;
}
return AnimateColor("background", destinationValue, startTime, endTime, alphaFunction, initialValue);
}
public Animation AnimateColor(string targetVisual, object destinationColor, int startTime, int endTime, AlphaFunction.BuiltinFunctions? alphaFunction = null, object initialColor = null)
{
Animation animation = null;
+ using (PropertyMap animator = new PropertyMap())
+ using (PropertyMap timePeriod = new PropertyMap())
+ using (PropertyValue pvDuration = new PropertyValue((endTime - startTime) / 1000.0f))
+ using (PropertyValue pvDelay = new PropertyValue(startTime / 1000.0f))
+ using (PropertyMap transition = new PropertyMap())
+ using (PropertyValue pvTarget = new PropertyValue(targetVisual))
+ using (PropertyValue pvProperty = new PropertyValue("mixColor"))
+ using (PropertyValue destValue = PropertyValue.CreateFromObject(destinationColor))
{
- PropertyMap _animator = new PropertyMap();
if (alphaFunction != null)
{
- _animator.Add("alphaFunction", new PropertyValue(AlphaFunction.BuiltinToPropertyKey(alphaFunction)));
+ using (PropertyValue pvAlpha = new PropertyValue(AlphaFunction.BuiltinToPropertyKey(alphaFunction)))
+ {
+ animator.Add("alphaFunction", pvAlpha);
+ }
}
- PropertyMap _timePeriod = new PropertyMap();
- _timePeriod.Add("duration", new PropertyValue((endTime - startTime) / 1000.0f));
- _timePeriod.Add("delay", new PropertyValue(startTime / 1000.0f));
- _animator.Add("timePeriod", new PropertyValue(_timePeriod));
-
- PropertyMap _transition = new PropertyMap();
- _transition.Add("animator", new PropertyValue(_animator));
- _transition.Add("target", new PropertyValue(targetVisual));
- _transition.Add("property", new PropertyValue("mixColor"));
+ timePeriod.Add("duration", pvDuration);
+ timePeriod.Add("delay", pvDelay);
+ using (PropertyValue pvTimePeriod = new PropertyValue(timePeriod))
+ {
+ animator.Add("timePeriod", pvTimePeriod);
+ }
+ using (PropertyValue pvAnimator = new PropertyValue(animator))
+ {
+ transition.Add("animator", pvAnimator);
+ }
+ transition.Add("target", pvTarget);
+ transition.Add("property", pvProperty);
if (initialColor != null)
{
- PropertyValue initValue = PropertyValue.CreateFromObject(initialColor);
- _transition.Add("initialValue", initValue);
+ using (PropertyValue initValue = PropertyValue.CreateFromObject(initialColor))
+ {
+ transition.Add("initialValue", initValue);
+ }
}
- PropertyValue destValue = PropertyValue.CreateFromObject(destinationColor);
- _transition.Add("targetValue", destValue);
- TransitionData _transitionData = new TransitionData(_transition);
-
- animation = new Animation(Interop.View.CreateTransition(SwigCPtr, TransitionData.getCPtr(_transitionData)), true);
+ transition.Add("targetValue", destValue);
+ using (TransitionData transitionData = new TransitionData(transition))
+ {
+ animation = new Animation(Interop.View.CreateTransition(SwigCPtr, TransitionData.getCPtr(transitionData)), true);
+ }
if (NDalicPINVOKE.SWIGPendingException.Pending)
throw NDalicPINVOKE.SWIGPendingException.Retrieve();
}
oldParent.Remove(child);
}
child.InternalParent = this;
+ LayoutCount += child.LayoutCount;
Interop.Actor.Add(SwigCPtr, View.getCPtr(child));
if (NDalicPINVOKE.SWIGPendingException.Pending)
throw NDalicPINVOKE.SWIGPendingException.Retrieve();
Children.Add(child);
+ OnChildAdded(child);
if (ChildAdded != null)
{
};
ChildAdded(this, e);
}
- BindableObject.SetInheritedBindingContext(child, this?.BindingContext);
}
}
if (child == null || child.GetParent() == null) // Early out if child null.
return;
- if (child.Parent != this)
+ if (child.GetParent() != this)
{
- throw new System.InvalidOperationException("You have deleted a view that is not a child of this view.");
+ //throw new System.InvalidOperationException("You have deleted a view that is not a child of this view.");
+ Tizen.Log.Error("NUI", "You have deleted a view that is not a child of this view.");
+ return;
}
bool hasLayout = (layout != null);
}
/// <summary>
+ /// Retrieves a child view as Animatable by index.
+ /// </summary>
+ /// <param name="index">The index of the Animatable to find.</param>
+ /// <returns>A handle to the view as Animatable if found, or an empty handle if not.</returns>
+ /// This will not be public opened.
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public Animatable GetChildAnimatableAt(uint index)
+ {
+ if (index < Children.Count)
+ {
+ return Children[Convert.ToInt32(index)] as Animatable;
+ }
+ else
+ {
+ return null;
+ }
+ }
+
+ /// <summary>
/// Retrieves the number of children held by the view.
/// </summary>
/// <seealso cref="Container.GetChildCount" />
/// <since_tizen> 4 </since_tizen>
+ [Obsolete("This has been deprecated in API9 and will be removed in API11. Use ChildCount property instead.")]
public override uint GetChildCount()
{
return Convert.ToUInt32(Children.Count);
/// <since_tizen> 4 </since_tizen>
public override Container GetParent()
{
- return this.InternalParent as Container;
+ return InternalParent as Container;
}
/// <summary>
}
else
{
- Tizen.Log.Error("NUI", "swigCPtr of view is aleady disposed.");
+ Tizen.Log.Error("NUI", "swigCPtr of view is already disposed.");
}
return ret;
}
/// </summary>
/// <param name="styleName">A string matching a style described in a stylesheet.</param>
/// <since_tizen> 3 </since_tizen>
+ [Obsolete("This has been deprecated in API9 and will be removed in API11. Use StyleName property instead.")]
public void SetStyleName(string styleName)
{
Interop.View.SetStyleName(SwigCPtr, styleName);
/// </summary>
/// <returns>A string matching a style, or an empty string.</returns>
/// <since_tizen> 3 </since_tizen>
+ [Obsolete("This has been deprecated in API9 and will be removed in API11. Use StyleName property instead.")]
public string GetStyleName()
{
string ret = Interop.View.GetStyleName(SwigCPtr);
public void Show()
{
SetVisible(true);
+
+ if (GetAccessibilityStates()[AccessibilityState.Modal])
+ {
+ RegisterDefaultLabel();
+
+ if (Accessibility.Accessibility.IsEnabled)
+ {
+ EmitAccessibilityStateChangedEvent(AccessibilityState.Showing, true);
+ }
+ }
}
/// <summary>
public void Hide()
{
SetVisible(false);
+
+ if (GetAccessibilityStates()[AccessibilityState.Modal])
+ {
+ UnregisterDefaultLabel();
+
+ if (Accessibility.Accessibility.IsEnabled)
+ {
+ EmitAccessibilityStateChangedEvent(AccessibilityState.Showing, false);
+ }
+ }
}
/// <summary>
}
/// <summary>
+ /// Search through this view's hierarchy for a view as Animatable with the given name.
+ /// The view itself is also considered in the search.
+ /// </summary>
+ /// <pre>The view has been initialized.</pre>
+ /// <param name="childName">The name of the Animatable to find.</param>
+ /// <returns>A handle to the view as Animatable if found, or an empty handle if not.</returns>
+ /// This will not be public opened.
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public Animatable FindChildAnimatableByName(string childName)
+ {
+ //to fix memory leak issue, match the handle count with native side.
+ IntPtr cPtr = Interop.Actor.FindChildByName(SwigCPtr, childName);
+ Animatable ret = Registry.GetManagedBaseHandleFromNativePtr(cPtr) as Animatable;
+ if(ret == null)
+ {
+ // Register new camera into Registry.
+ ret = new Animatable(cPtr, true);
+ }
+ else
+ {
+ // We found matched NUI camera. Reduce cPtr reference count.
+ HandleRef handle = new HandleRef(this, cPtr);
+ Interop.Actor.DeleteActor(handle);
+ handle = new HandleRef(null, IntPtr.Zero);
+ }
+ if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
+ return ret;
+ }
+
+ /// <summary>
/// Converts screen coordinates into the view's coordinate system using the default camera.
/// </summary>
/// <pre>The view has been initialized.</pre>
/// </summary>
/// <param name="padding">Padding for the view.</param>
/// <since_tizen> 3 </since_tizen>
+ // [Obsolete("This has been deprecated in API9 and will be removed in API11. Use Padding property instead.")]
public void SetPadding(PaddingType padding)
{
Interop.Actor.SetPadding(SwigCPtr, PaddingType.getCPtr(padding));
/// </summary>
/// <param name="paddingOut">the value of padding for the view</param>
/// <since_tizen> 3 </since_tizen>
+ [Obsolete("This has been deprecated in API9 and will be removed in API11. Use Padding property instead.")]
public void GetPadding(PaddingType paddingOut)
{
Interop.Actor.GetPadding(SwigCPtr, PaddingType.getCPtr(paddingOut));
throw NDalicPINVOKE.SWIGPendingException.Retrieve();
}
- /// This will be public opened in next tizen after ACR done. Before ACR, need to be hidden as inhouse API.
+ /// <summary>
+ /// Rotate the view look at specific position.
+ /// It will change the view's orientation property.
+ /// </summary>
+ /// <remark>Target position should be setup by world coordinates.</remark>
+ /// <param name="target">The target world position to look at.</param>
+ /// <param name="up">The up vector after target look at. If it is null, up vector become +Y axis</param>
+ /// <param name="localForward">The forward vector of view when it's orientation is not applied. If it is null, localForward vector become +Z axis</param>
+ /// <param name="localUp">The up vector of view when it's orientation is not applied. If it is null, localUp vector become +Y axis</param>
+ /// This will be public opened in tizen_next after ACR done. Before ACR, need to be hidden as inhouse API.
[EditorBrowsable(EditorBrowsableState.Never)]
- public void SetColorMode(ColorMode colorMode)
+ public void LookAt(Vector3 target, Vector3 up = null, Vector3 localForward = null, Vector3 localUp = null)
{
- Interop.ActorInternal.SetColorMode(SwigCPtr, (int)colorMode);
+ Interop.ActorInternal.LookAt(SwigCPtr, Vector3.getCPtr(target), Vector3.getCPtr(up), Vector3.getCPtr(localForward), Vector3.getCPtr(localUp));
if (NDalicPINVOKE.SWIGPendingException.Pending)
throw NDalicPINVOKE.SWIGPendingException.Retrieve();
}
-
-
- /// This will be public opened in tizen_next after ACR done. Before ACR, need to be hidden as inhouse API.
+ /// This will be public opened in next tizen after ACR done. Before ACR, need to be hidden as inhouse API.
[EditorBrowsable(EditorBrowsableState.Never)]
- public Transition GetTransition(string transitionName)
+ public void SetColorMode(ColorMode colorMode)
{
- Transition trans = null;
- transDictionary.TryGetValue(transitionName, out trans);
- return trans;
+ Interop.ActorInternal.SetColorMode(SwigCPtr, (int)colorMode);
+ if (NDalicPINVOKE.SWIGPendingException.Pending)
+ throw NDalicPINVOKE.SWIGPendingException.Retrieve();
}
/// This will be public opened in tizen_next after ACR done. Before ACR, need to be hidden as inhouse API.
/// <param name="id">The ID of the View to find</param>
/// <returns>A View if found or a null if not</returns>
[EditorBrowsable(EditorBrowsableState.Never)]
+ [Obsolete("This will be removed at API11. Use FindDescendantByID(uint id) instead.")]
public View FindChildByID(uint id)
{
IntPtr cPtr = Interop.Actor.FindChildById(SwigCPtr, id);
return ret;
}
+ /// <summary>
+ /// Search through this View's hierarchy for a View with the given unique ID.
+ /// </summary>
+ /// <param name="id">The ID of the View to find.</param>
+ /// <returns>A handle to the View if found, or an empty handle if not.</returns>
+ /// <since_tizen> 9 </since_tizen>
+ public View FindDescendantByID(uint id)
+ {
+ return FindChildById(id);
+ }
+
+ /// <summary>
+ /// Raise view above the next sibling view.
+ /// </summary>
+ /// <since_tizen> 9 </since_tizen>
+ public void Raise()
+ {
+ var parentChildren = GetParent()?.Children;
+
+ if (parentChildren != null)
+ {
+ int currentIndex = parentChildren.IndexOf(this);
+
+ // If the view is not already the last item in the list.
+ if (currentIndex >= 0 && currentIndex < parentChildren.Count - 1)
+ {
+ View temp = parentChildren[currentIndex + 1];
+ parentChildren[currentIndex + 1] = this;
+ parentChildren[currentIndex] = temp;
+
+ Interop.NDalic.Raise(SwigCPtr);
+ if (NDalicPINVOKE.SWIGPendingException.Pending)
+ throw NDalicPINVOKE.SWIGPendingException.Retrieve();
+ }
+ }
+ }
+
+ /// <summary>
+ /// Lower the view below the previous sibling view.
+ /// </summary>
+ /// <since_tizen> 9 </since_tizen>
+ public void Lower()
+ {
+ var parentChildren = GetParent()?.Children;
+
+ if (parentChildren != null)
+ {
+ int currentIndex = parentChildren.IndexOf(this);
+
+ // If the view is not already the first item in the list.
+ if (currentIndex > 0 && currentIndex < parentChildren.Count)
+ {
+ View temp = parentChildren[currentIndex - 1];
+ parentChildren[currentIndex - 1] = this;
+ parentChildren[currentIndex] = temp;
+
+ Interop.NDalic.Lower(SwigCPtr);
+ if (NDalicPINVOKE.SWIGPendingException.Pending)
+ throw NDalicPINVOKE.SWIGPendingException.Retrieve();
+ }
+ }
+ }
+
+ /// <summary>
+ /// Raises the view to above the target view.
+ /// </summary>
+ /// <remarks>The sibling order of views within the parent will be updated automatically.
+ /// Views on the level above the target view will still be shown above this view.
+ /// Once a raise or lower API is used then that view will have an exclusive sibling order independent of insertion.
+ /// </remarks>
+ /// <param name="target">Will be raised above this view.</param>
+ /// <since_tizen> 9 </since_tizen>
+ public void RaiseAbove(View target)
+ {
+ var parentChildren = GetParent()?.Children;
+
+ if (parentChildren != null)
+ {
+ int currentIndex = parentChildren.IndexOf(this);
+ int targetIndex = parentChildren.IndexOf(target);
+
+ if (currentIndex < 0 || targetIndex < 0 ||
+ currentIndex >= parentChildren.Count || targetIndex >= parentChildren.Count)
+ {
+ NUILog.Error("index should be bigger than 0 and less than children of layer count");
+ return;
+ }
+ // If the currentIndex is less than the target index and the target has the same parent.
+ if (currentIndex < targetIndex)
+ {
+ parentChildren.Remove(this);
+ parentChildren.Insert(targetIndex, this);
+
+ Interop.NDalic.RaiseAbove(SwigCPtr, View.getCPtr(target));
+ if (NDalicPINVOKE.SWIGPendingException.Pending)
+ throw NDalicPINVOKE.SWIGPendingException.Retrieve();
+ }
+ }
+
+ }
+
+ /// <summary>
+ /// Lowers the view to below the target view.
+ /// </summary>
+ /// <remarks>The sibling order of views within the parent will be updated automatically.
+ /// Once a raise or lower API is used then that view will have an exclusive sibling order independent of insertion.
+ /// </remarks>
+ /// <param name="target">Will be lowered below this view.</param>
+ /// <since_tizen> 9 </since_tizen>
+ public void LowerBelow(View target)
+ {
+ var parentChildren = GetParent()?.Children;
+
+ if (parentChildren != null)
+ {
+ int currentIndex = parentChildren.IndexOf(this);
+ int targetIndex = parentChildren.IndexOf(target);
+ if (currentIndex < 0 || targetIndex < 0 ||
+ currentIndex >= parentChildren.Count || targetIndex >= parentChildren.Count)
+ {
+ NUILog.Error("index should be bigger than 0 and less than children of layer count");
+ return;
+ }
+
+ // If the currentIndex is not already the 0th index and the target has the same parent.
+ if ((currentIndex != 0) && (targetIndex != -1) &&
+ (currentIndex > targetIndex))
+ {
+ parentChildren.Remove(this);
+ parentChildren.Insert(targetIndex, this);
+
+ Interop.NDalic.LowerBelow(SwigCPtr, View.getCPtr(target));
+ if (NDalicPINVOKE.SWIGPendingException.Pending)
+ throw NDalicPINVOKE.SWIGPendingException.Retrieve();
+ }
+ }
+
+ }
+
+ /// <summary>
+ /// Sets the position of the View.
+ /// The coordinates are relative to the View's parent.
+ /// The View's z position will be set to 0.0f.
+ /// </summary>
+ /// <param name="x">The new x position</param>
+ /// <param name="y">The new y position</param>
+ /// <remarks>
+ /// This is a hidden API(inhouse API) only for internal purpose.
+ /// </remarks>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public void SetPosition(float x, float y)
+ {
+ Interop.ActorInternal.SetPosition(SwigCPtr, x, y);
+ if (NDalicPINVOKE.SWIGPendingException.Pending)
+ throw NDalicPINVOKE.SWIGPendingException.Retrieve();
+ }
+
+ /// <summary>
+ /// Sets the position of the View.
+ /// The coordinates are relative to the View's parent.
+ /// </summary>
+ /// <param name="x">The new x position</param>
+ /// <param name="y">The new y position</param>
+ /// <param name="z">The new z position</param>
+ /// <remarks>
+ /// This is a hidden API(inhouse API) only for internal purpose.
+ /// </remarks>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public void SetPosition(float x, float y, float z)
+ {
+ Interop.ActorInternal.SetPosition(SwigCPtr, x, y, z);
+ if (NDalicPINVOKE.SWIGPendingException.Pending)
+ throw NDalicPINVOKE.SWIGPendingException.Retrieve();
+ }
+
+ /// <summary>
+ /// Sets the position of the View.
+ /// The coordinates are relative to the View's parent.
+ /// </summary>
+ /// <param name="position">The new position</param>
+ /// <remarks>
+ /// This is a hidden API(inhouse API) only for internal purpose.
+ /// </remarks>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public void SetPosition(Vector3 position)
+ {
+ Interop.ActorInternal.SetPosition(SwigCPtr, Vector3.getCPtr(position));
+ if (NDalicPINVOKE.SWIGPendingException.Pending)
+ throw NDalicPINVOKE.SWIGPendingException.Retrieve();
+ }
+
+ /// <summary>
+ /// Register custom HitTest function for this view.
+ /// </summary>
+ /// <seealso cref="View.HitTest" />
+ /// <remarks>
+ /// This is a hidden API(inhouse API) only for internal purpose.
+ /// </remarks>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ protected void RegisterHitTestCallback()
+ {
+ if (hitTestResultDataCallback == null)
+ {
+ hitTestResultDataCallback = OnHitTestResult;
+ Interop.ActorSignal.HitTestResultConnect(SwigCPtr, hitTestResultDataCallback.ToHandleRef(this));
+ NDalicPINVOKE.ThrowExceptionIfExistsDebug();
+ }
+ }
+
+ /// <summary>
+ /// Unregister custom HitTest function.
+ /// </summary>
+ /// <remarks>
+ /// This is a hidden API(inhouse API) only for internal purpose.
+ /// </remarks>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ protected void UnregisterHitTestCallback()
+ {
+ if (hitTestResultDataCallback != null)
+ {
+ Interop.ActorSignal.HitTestResultDisconnect(SwigCPtr, hitTestResultDataCallback.ToHandleRef(this));
+ NDalicPINVOKE.ThrowExceptionIfExistsDebug();
+ hitTestResultDataCallback = null;
+ }
+ }
+
+ /// <summary>
+ /// Calculate the screen position of the view.<br />
+ /// </summary>
+ /// <remarks>
+ /// This is a hidden API(inhouse API) only for internal purpose.
+ /// </remarks>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public Vector2 CalculateScreenPosition()
+ {
+ Vector2 ret = new Vector2(Interop.Actor.CalculateScreenPosition(SwigCPtr), true);
+ if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
+ return ret;
+ }
+
+ /// <summary>
+ /// Calculate the screen position and size of the view.<br />
+ /// </summary>
+ /// <remarks>
+ /// The float type Rectangle class is not ready yet.
+ /// Therefore, it transmits data in Vector4 class.
+ /// This type should later be changed to the appropriate data type.
+ /// </remarks>
+ /// <remarks>
+ /// This is a hidden API(inhouse API) only for internal purpose.
+ /// </remarks>
+ [EditorBrowsable(EditorBrowsableState.Never)]
+ public Vector4 CalculateScreenPositionSize()
+ {
+ Vector4 ret = new Vector4(Interop.Actor.CalculateScreenExtents(SwigCPtr), true);
+ if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
+ return ret;
+ }
}
}