2 * Copyright(c) 2021 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 System.ComponentModel;
19 using System.Runtime.CompilerServices;
20 using Tizen.NUI.Binding;
25 /// BaseHandle is a handle to an internal Dali resource.
27 /// <since_tizen> 3 </since_tizen>
28 public class BaseHandle : Element, global::System.IDisposable
33 /// <since_tizen> 3 </since_tizen>
34 [Obsolete("Deprecated in API9, Will be removed in API11, Please use SwigCMemOwn")]
35 [System.Diagnostics.CodeAnalysis.SuppressMessage("Design", "CA1051:Do not declare visible instance fields", Justification = "<Pending>")]
36 protected bool swigCMemOwn;
39 /// A flag to check if it is already disposed.
41 /// <since_tizen> 3 </since_tizen>
42 [Obsolete("Deprecated in API9, Will be removed in API11, Please use Disposed")]
43 [System.Diagnostics.CodeAnalysis.SuppressMessage("Design", "CA1051:Do not declare visible instance fields", Justification = "<Pending>")]
44 protected bool disposed = false;
46 private global::System.Runtime.InteropServices.HandleRef swigCPtr;
47 private global::System.Runtime.InteropServices.HandleRef swigCPtrCopy;
48 private bool registerMe;
50 //A Flag to check who called Dispose(). (By User or DisposeQueue)
51 private bool isDisposeQueued = false;
54 /// Create an instance of BaseHandle.
56 /// <since_tizen> 3 </since_tizen>
57 public BaseHandle() : this(Interop.BaseHandle.NewBaseHandle())
59 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
63 /// Create an instance of BaseHandle.
65 /// <param name="handle">The BaseHandle instance.</param>
66 /// <since_tizen> 3 </since_tizen>
67 public BaseHandle(BaseHandle handle) : this(Interop.BaseHandle.NewBaseHandle(BaseHandle.getCPtr(handle)))
69 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
72 internal BaseHandle(global::System.IntPtr cPtr, bool cMemoryOwn)
74 //to catch derived classes dali native exceptions
75 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
77 registerMe = swigCMemOwn = cMemoryOwn;
78 swigCPtr = new global::System.Runtime.InteropServices.HandleRef(this, cPtr);
79 // using copy constructor to create another native handle so Registry.Unregister works fine.
80 swigCPtrCopy = new global::System.Runtime.InteropServices.HandleRef(this, Interop.BaseHandle.NewBaseHandle(swigCPtr));
81 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
86 // Register this instance of BaseHandle in the registry.
87 Registry.Register(this);
91 internal BaseHandle(global::System.IntPtr cPtr)
93 registerMe = swigCMemOwn = true;
95 swigCPtr = new global::System.Runtime.InteropServices.HandleRef(this, cPtr);
97 // using copy constructor to create another native handle so Registry.Unregister works fine.
98 swigCPtrCopy = new global::System.Runtime.InteropServices.HandleRef(this, Interop.BaseHandle.NewBaseHandle(SwigCPtr));
99 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
103 // Register this instance of BaseHandle in the registry.
104 Registry.Register(this);
111 /// <since_tizen> 3 </since_tizen>
112 // following this guide: https://docs.microsoft.com/ko-kr/dotnet/fundamentals/code-analysis/quality-rules/ca1063?view=vs-2019 (CA1063)
113 ~BaseHandle() => Dispose(false);
116 /// Event when a property is set.
118 /// <since_tizen> 5 </since_tizen>
119 /// <seealso cref="BindableObject.PropertyChanged"/>
120 [Obsolete("Deprecated in API9, Will be removed in API11, Please use BindableObject.PropertyChanged instead!")]
121 public event PropertyChangedEventHandler PropertySet;
123 internal global::System.Runtime.InteropServices.HandleRef GetBaseHandleCPtrHandleRef
132 /// Returns the bool value true to indicate that an operand is true and returns false otherwise.
134 /// <since_tizen> 3 </since_tizen>
135 public static bool operator true(BaseHandle handle)
137 // if the C# object is null, return false
138 if (BaseHandle.ReferenceEquals(handle, null))
142 // returns true if the handle has a body, false otherwise
143 return handle.HasBody();
147 /// Returns the bool false to indicate that an operand is false and returns true otherwise.
149 /// <since_tizen> 3 </since_tizen>
150 public static bool operator false(BaseHandle handle)
152 // if the C# object is null, return true
153 if (BaseHandle.ReferenceEquals(handle, null))
157 return !handle.HasBody();
161 /// Explicit conversion from Handle to bool.
163 /// <since_tizen> 3 </since_tizen>
164 public static explicit operator bool(BaseHandle handle)
166 // if the C# object is null, return false
167 if (BaseHandle.ReferenceEquals(handle, null))
171 // returns true if the handle has a body, false otherwise
172 return handle.HasBody();
176 /// Equality operator
178 /// <since_tizen> 3 </since_tizen>
179 public static bool operator ==(BaseHandle x, BaseHandle y)
181 // if the C# objects are the same return true
182 if (BaseHandle.ReferenceEquals(x, y))
186 if (!BaseHandle.ReferenceEquals(x, null) && !BaseHandle.ReferenceEquals(y, null))
188 // drop into native code to see if both handles point to the same body
192 if (BaseHandle.ReferenceEquals(x, null) && !BaseHandle.ReferenceEquals(y, null))
194 if (y.HasBody()) return false;
197 if (!BaseHandle.ReferenceEquals(x, null) && BaseHandle.ReferenceEquals(y, null))
199 if (x.HasBody()) return false;
207 /// Inequality operator. Returns Null if either operand is Null
209 /// <since_tizen> 3 </since_tizen>
210 public static bool operator !=(BaseHandle x, BaseHandle y)
216 /// Logical AND operator.<br />
217 /// It's possible when doing a operator this function (opBitwiseAnd) is never called due to short circuiting.<br />
219 /// <since_tizen> 3 </since_tizen>
220 public static BaseHandle operator &(BaseHandle x, BaseHandle y)
230 /// Logical OR operator for ||.<br />
231 /// It's possible when doing a || this function (opBitwiseOr) is never called due to short circuiting.<br />
233 /// <since_tizen> 3 </since_tizen>
234 public static BaseHandle operator |(BaseHandle x, BaseHandle y)
236 if (!BaseHandle.ReferenceEquals(x, null) || !BaseHandle.ReferenceEquals(y, null))
238 if (x != null && x.HasBody())
242 if (y != null && y.HasBody())
252 /// Logical ! operator
254 /// <since_tizen> 3 </since_tizen>
255 public static bool operator !(BaseHandle x)
257 // if the C# object is null, return true
258 if (BaseHandle.ReferenceEquals(x, null))
272 /// <param name="o">The object should be compared.</param>
273 /// <returns>True if equal.</returns>
274 /// <since_tizen> 5 </since_tizen>
275 public override bool Equals(object o)
277 return base.Equals(o);
281 /// Gets the hash code of this baseHandle.
283 /// <returns>The hash code.</returns>
284 /// <since_tizen> 5 </since_tizen>
285 public override int GetHashCode()
287 return base.GetHashCode();
293 /// <since_tizen> 3 </since_tizen>
294 public void Dispose()
298 Dispose(DisposeTypes.Implicit);
304 GC.SuppressFinalize(this);
308 /// Hidden API (Inhouse API).
312 /// Following the guide of https://docs.microsoft.com/en-us/dotnet/standard/garbage-collection/implementing-dispose.
313 /// This will replace "protected virtual void Dispose(DisposeTypes type)" which is exactly same in functionality.
315 /// <param name="disposing">true in order to free managed objects</param>
316 // Protected implementation of Dispose pattern.
317 [EditorBrowsable(EditorBrowsableState.Never)]
318 protected virtual void Dispose(bool disposing)
327 // TODO: dispose managed state (managed objects).
328 // Explicit call. user calls Dispose()
330 //Throw exception if Dispose() is called in separate thread.
331 if (!Window.IsInstalled())
333 var process = global::System.Diagnostics.Process.GetCurrentProcess().Id;
334 var thread = global::System.Threading.Thread.CurrentThread.ManagedThreadId;
335 var me = this.GetType().FullName;
337 throw new global::System.InvalidOperationException("[NUI][BaseHandle] This API called from separate thread. This API must be called from MainThread. \n" +
338 $" process:{process} thread:{thread}, disposing:{disposing}, isDisposed:{this.disposed}, isDisposeQueued:{this.isDisposeQueued}, me:{me}\n");
343 Tizen.Log.Fatal("NUI", $"should not be here! (dead code) this will be removed!");
344 throw new global::System.Exception($"[NUI] should not be here! (dead code) this will be removed!");
345 Dispose(DisposeTypes.Implicit);
349 Dispose(DisposeTypes.Explicit);
354 // Implicit call. user doesn't call Dispose(), so this object is added into DisposeQueue to be disposed automatically.
355 if (!isDisposeQueued)
357 isDisposeQueued = true;
358 DisposeQueue.Instance.Add(this);
362 // TODO: free unmanaged resources (unmanaged objects) and override a finalizer below.
363 // TODO: set large fields to null.
368 /// Performs an action on this object with the given action name and attributes.
370 /// <param name="actionName">The command for the action.</param>
371 /// <param name="attributes">The list of attributes for the action.</param>
372 /// <returns>The action is performed by the object or not.</returns>
373 /// <since_tizen> 3 </since_tizen>
374 public bool DoAction(string actionName, PropertyMap attributes)
376 bool ret = Interop.BaseHandle.DoAction(swigCPtrCopy, actionName, PropertyMap.getCPtr(attributes));
377 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
382 /// Returns the type name for the Handle.<br />
383 /// Will return an empty string if the typename does not exist. This will happen for types that
384 /// have not registered with type-registry.
386 /// <returns>The type name. Empty string if the typename does not exist.</returns>
387 /// <since_tizen> 3 </since_tizen>
388 public string GetTypeName()
390 string ret = Interop.BaseHandle.GetTypeName(swigCPtrCopy);
391 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
396 /// Returns the type info for the Handle.<br />
398 /// <param name="info">The type information.</param>
399 /// <returns>True If get the type info.</returns>
400 /// <since_tizen> 3 </since_tizen>
401 public bool GetTypeInfo(Tizen.NUI.TypeInfo info)
403 bool ret = Interop.BaseHandle.GetTypeInfo(swigCPtrCopy, Tizen.NUI.TypeInfo.getCPtr(info));
404 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
409 /// Resets the handle.
411 /// <since_tizen> 3 </since_tizen>
414 Interop.BaseHandle.Reset(swigCPtrCopy);
415 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
419 /// To check the BaseHandle instance is equal or not.
421 /// <param name="rhs">The baseHandle instance.</param>
422 /// <returns>True If equal.</returns>
423 /// <since_tizen> 3 </since_tizen>
424 public bool EqualTo(BaseHandle rhs)
426 bool ret = Interop.BaseHandle.EqualTo(swigCPtrCopy, BaseHandle.getCPtr(rhs));
427 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
432 /// To check the BaseHandle instance is equal or not.
434 /// <param name="rhs">The baseHandle instance.</param>
435 /// <returns>True If not equal.</returns>
436 /// <since_tizen> 3 </since_tizen>
437 public bool NotEqualTo(BaseHandle rhs)
439 bool ret = Interop.BaseHandle.NotEqualTo(swigCPtrCopy, BaseHandle.getCPtr(rhs));
440 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
445 /// To check the BaseHandle instance has body or not.
447 /// <returns>True If the baseHandle instance has body.</returns>
448 /// <since_tizen> 3 </since_tizen>
449 public bool HasBody()
451 if (swigCPtrCopy.Handle == IntPtr.Zero)
456 if (disposed == true)
460 bool ret = Interop.BaseHandle.HasBody(swigCPtrCopy);
461 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
466 /// To check the BaseHandle instance is equal or not.
468 /// <param name="rhs">The baseHandle instance.</param>
469 /// <returns>True If equal.</returns>
470 /// <since_tizen> 3 </since_tizen>
471 public bool IsEqual(BaseHandle rhs)
473 if (disposed == true)
478 bool ret = Interop.BaseHandle.IsEqual(swigCPtrCopy, BaseHandle.getCPtr(rhs));
479 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
483 internal static global::System.Runtime.InteropServices.HandleRef getCPtr(BaseHandle obj)
485 return (obj == null) ? new global::System.Runtime.InteropServices.HandleRef(null, global::System.IntPtr.Zero) : obj.swigCPtrCopy;
488 internal void NotifyPropertyChanged([CallerMemberName] String propertyName = "")
490 PropertySet?.Invoke(this, new PropertyChangedEventArgs(propertyName));
496 /// <since_tizen> 3 </since_tizen>
497 protected virtual void Dispose(DisposeTypes type)
504 if (type == DisposeTypes.Explicit)
507 //Release your own managed resources here.
508 //You should release all of your own disposable objects here.
512 //Release your own unmanaged resources here.
513 //You should not access any managed member here except static instance.
514 //because the execution order of Finalizes is non-deterministic.
516 //Unreference this instance from Registry.
519 Registry.Unregister(this);
522 // this is temporary test code. will be removed laster
524 if (swigCPtr.Handle != IntPtr.Zero && swigCPtrCopy.Handle != IntPtr.Zero)
526 var process = global::System.Diagnostics.Process.GetCurrentProcess().Id;
527 var thread = global::System.Threading.Thread.CurrentThread.ManagedThreadId;
528 var me = this.GetType().FullName;
529 var daliId = "unknown";
530 var hash = this.GetType().GetHashCode();
531 var name = "unknown";
533 if (this is BaseComponents.View)
535 daliId = Interop.Actor.GetId(swigCPtrCopy).ToString();
536 name = Interop.Actor.GetName(swigCPtrCopy);
537 BaseObject tmp = new BaseObject(Interop.BaseHandle.GetBaseObject(swigCPtrCopy), false);
538 var refCnt = tmp.ReferenceCount();
542 Log.Error("NUI", $"[ERR] reference count is over than 2. Could be a memory leak. Need to check! \n" +
543 $" process:{process} thread:{thread}, isDisposed:{this.disposed}, isDisposeQueued:{this.isDisposeQueued}, me:{me} \n" +
544 $" disposeType:{type}, name:{name}, daliID:{daliId}, hash:{hash}, refCnt:{refCnt}");
550 if (SwigCPtr.Handle != IntPtr.Zero)
555 ReleaseSwigCPtr(SwigCPtr);
557 swigCPtr = new global::System.Runtime.InteropServices.HandleRef(null, global::System.IntPtr.Zero);
561 var me = this.GetType().FullName;
562 Log.Error("NUI", $"[ERR] SwigCPtr is NULL, need to check! me:{me}");
565 if (swigCPtrCopy.Handle != global::System.IntPtr.Zero)
568 Interop.BaseHandle.DeleteBaseHandle(swigCPtrCopy);
569 swigCPtrCopy = new global::System.Runtime.InteropServices.HandleRef(null, global::System.IntPtr.Zero);
573 var me = this.GetType().FullName;
574 Log.Error("NUI", $"[ERR] swigCPtrCopy is NULL, need to check! me:{me}");
579 if (null != Application.Current)
581 Application.Current.XamlResourceChanged -= OnResourcesChanged;
586 /// Release swigCPtr.
588 /// <since_tizen> 6 </since_tizen>
589 /// This will not be public opened.
590 [EditorBrowsable(EditorBrowsableState.Never)]
591 protected virtual void ReleaseSwigCPtr(System.Runtime.InteropServices.HandleRef swigCPtr)
596 /// Contains event arguments for the FocusChangeRequested event.
598 [Obsolete("Deprecated in API9; Will be removed in API11.")]
599 public class FocusRequestArgs : EventArgs
603 /// Gets or sets a value that indicates the starting focus state of the element for which a focus change is requested.
605 public bool Focus { get; set; }
608 /// Gets or sets a value that indicates the ending focus state of the element for which a focus change is requested.
610 public bool Result { get; set; }
613 internal global::System.Runtime.InteropServices.HandleRef SwigCPtr
617 if (swigCPtr.Handle == IntPtr.Zero)
619 var process = global::System.Diagnostics.Process.GetCurrentProcess().Id;
620 var thread = global::System.Threading.Thread.CurrentThread.ManagedThreadId;
621 var me = this.GetType().FullName;
623 throw new ObjectDisposedException(nameof(SwigCPtr), $"Error! NUI's native dali object is already disposed. " +
624 $"OR the native dali object handle of NUI becomes null! \n" +
625 $" process:{process} thread:{thread}, isDisposed:{this.disposed}, isDisposeQueued:{this.isDisposeQueued}, me:{me}\n");
631 internal bool IsNativeHandleInvalid()
633 return swigCPtr.Handle == IntPtr.Zero;
639 [EditorBrowsable(EditorBrowsableState.Never)]
640 protected internal bool SwigCMemOwn => swigCMemOwn;
643 /// A flag to check if it is already disposed.
645 [EditorBrowsable(EditorBrowsableState.Never)]
646 protected internal bool Disposed => disposed;
649 /// A flag to check if it is disposed by DisposeQueue.
651 [EditorBrowsable(EditorBrowsableState.Never)]
652 protected internal bool IsDisposeQueued => isDisposeQueued;