[NUI] Add some remarks at BaseHandle class about Dispose
authorEunki Hong <eunkiki.hong@samsung.com>
Fri, 19 Jan 2024 04:04:36 +0000 (13:04 +0900)
committerEunki Hong <h.pichulia@gmail.com>
Wed, 24 Jan 2024 07:58:23 +0000 (16:58 +0900)
Signed-off-by: Eunki Hong <eunkiki.hong@samsung.com>
src/Tizen.NUI/src/public/Common/BaseHandle.cs

index 1bff524fcc88bfdfc3c0314db5db963736a25a93..f1d61bdaa4ebb262d4ce293d7442c7cb08e51877 100755 (executable)
@@ -25,6 +25,11 @@ namespace Tizen.NUI
     /// <summary>
     /// BaseHandle is a handle to an internal Dali resource.
     /// </summary>
+    /// <remarks>
+    /// Internal Dali resources with BaseHandle has reference count internally.<br/>
+    /// And Dali resources will release the object only if reference count become zero.<br/>
+    /// It mean, even we call <see cref="Dispose"/>, the reousrce will not be released if some native has reference count.
+    /// </remarks>
     /// <since_tizen> 3 </since_tizen>
     public class BaseHandle : Element, global::System.IDisposable
     {
@@ -335,6 +340,10 @@ namespace Tizen.NUI
         /// <summary>
         /// Dispose.
         /// </summary>
+        /// <remarks>
+        /// This method release only C# side objects. If someone hold BaseHandle at Native side<br/>
+        /// the object will not be removed until native side reset the handle.
+        /// </remarks>
         /// <since_tizen> 3 </since_tizen>
         public void Dispose()
         {