From: Adeel Kazmi <adeel.kazmi@samsung.com>
Date: Wed, 16 Dec 2020 18:58:37 +0000 (+0000)
Subject: Added notes to explain the difference between GetProperty & GetCurrentProperty
X-Git-Tag: dali_2.0.6~1
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=f7dfb6b27bb703942cd60f95b5ccbc9c57c2447a;p=platform%2Fcore%2Fuifw%2Fdali-core.git

Added notes to explain the difference between GetProperty & GetCurrentProperty

Change-Id: Iecb8e9d950f6c3bf77090fae82636221ae03e125
---

diff --git a/dali/public-api/object/handle.h b/dali/public-api/object/handle.h
index eb65c5a..879786f 100644
--- a/dali/public-api/object/handle.h
+++ b/dali/public-api/object/handle.h
@@ -364,6 +364,8 @@ public:
    * @SINCE_1_0.0
    * @param[in] index The index of the property
    * @return The property value
+   * @note This returns the value set by SetProperty() or the animation target value if it is being animated.
+   * @note To get the current value on the scene-graph, use GetCurrentProperty().
    */
   Property::Value GetProperty(Property::Index index) const;
 
@@ -374,6 +376,7 @@ public:
    * @param[in] index The index of the property
    * @return The property value
    * @pre The property types match i.e. PropertyTypes::Get<T>() is equal to GetPropertyType(index).
+   * @see GetProperty()
    */
   template<typename T>
   T GetProperty(Property::Index index) const
@@ -389,6 +392,9 @@ public:
    * @SINCE_1_2.41
    * @param[in] index The index of the property
    * @return The property value
+   * @note This returns the value of the property in the last rendered frame so can be different to that
+   *       set by SetProperty() if the set-message has not been processed by the scene-graph yet.
+   * @note To retrieve the value set by SetProperty(), use GetProperty().
    */
   Property::Value GetCurrentProperty(Property::Index index) const;
 
@@ -399,6 +405,7 @@ public:
    * @param[in] index The index of the property
    * @return The property value
    * @pre The property types match i.e. PropertyTypes::Get<T>() is equal to GetPropertyType(index).
+   * @see GetCurrentProperty()
    */
   template<typename T>
   T GetCurrentProperty(Property::Index index) const