X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=dali%2Fpublic-api%2Fevents%2Fgesture-detector.h;h=51655fbbbbdf561b8dee53b1b1b19b2f6011b0b4;hb=refs%2Fchanges%2F57%2F114957%2F2;hp=1b7ce752c3438e1f35258765e829b92d16427e62;hpb=079e6fb6efe6e14445395a56af5df9238642b589;p=platform%2Fcore%2Fuifw%2Fdali-core.git

diff --git a/dali/public-api/events/gesture-detector.h b/dali/public-api/events/gesture-detector.h
index 1b7ce75..51655fb 100644
--- a/dali/public-api/events/gesture-detector.h
+++ b/dali/public-api/events/gesture-detector.h
@@ -24,6 +24,10 @@
 
 namespace Dali
 {
+/**
+ * @addtogroup dali_core_events
+ * @{
+ */
 
 namespace Internal DALI_INTERNAL
 {
@@ -41,6 +45,7 @@ class Actor;
  * This is the base class for different gesture detectors available and provides functionality that is common
  * to all the gesture detectors.
  *
+ * @SINCE_1_0.0
  * @see Gesture
  */
 class DALI_IMPORT_API GestureDetector : public Handle
@@ -48,40 +53,47 @@ class DALI_IMPORT_API GestureDetector : public Handle
 public: // Creation & Destruction
 
   /**
-   * @brief Create an uninitialized GestureDetector; this can be initialized with one of the derived gestures' New() methods.
+   * @brief Creates an uninitialized GestureDetector.
    *
-   * Calling member functions with an uninitialized Dali::Object is not allowed.
+   * This can be initialized with one of the derived gesture detectors' New() methods. For example, PanGestureDetector::New().
+   *
+   * Calling member functions with an uninitialized Dali::GestureDetector handle is not allowed.
+   * @SINCE_1_0.0
    */
   GestureDetector();
 
   /**
-   * @brief Downcast an Object handle to GestureDetector handle.
+   * @brief Downcasts a handle to GestureDetector handle.
    *
-   * If handle points to a GestureDetector object the
-   * downcast produces valid handle. If not the returned handle is left uninitialized.
-   * @param[in] handle to An object
-   * @return handle to a GestureDetector object or an uninitialized handle
+   * If handle points to a GestureDetector object, the downcast produces valid handle.
+   * If not, the returned handle is left uninitialized.
+   * @SINCE_1_0.0
+   * @param[in] handle Handle to an object
+   * @return Handle to a GestureDetector object or an uninitialized handle
    */
   static GestureDetector DownCast( BaseHandle handle );
 
   /**
-   * @brief Dali::GestureDetector is intended as a base class
+   * @brief Dali::GestureDetector is intended as a base class.
    *
    * This is non-virtual since derived Handle types must not contain data or virtual methods.
+   * @SINCE_1_0.0
    */
   ~GestureDetector();
 
   /**
    * @brief This copy constructor is required for (smart) pointer semantics.
    *
-   * @param [in] handle A reference to the copied handle
+   * @SINCE_1_0.0
+   * @param[in] handle A reference to the copied handle
    */
   GestureDetector(const GestureDetector& handle);
 
   /**
    * @brief This assignment operator is required for (smart) pointer semantics.
    *
-   * @param [in] rhs  A reference to the copied handle
+   * @SINCE_1_0.0
+   * @param[in] rhs A reference to the copied handle
    * @return A reference to this
    */
   GestureDetector& operator=(const GestureDetector& rhs);
@@ -93,16 +105,18 @@ public: // Actor related
    *
    * The detected signal will be dispatched when the gesture occurs on
    * the attached actor.
-   * @note You can attach several actors to a gesture detector.
-   * @param[in]  actor  The actor to attach to the gesture detector
+   * @SINCE_1_0.0
+   * @param[in] actor The actor to attach to the gesture detector
    * @pre The gesture detector has been initialized.
+   * @note You can attach several actors to a gesture detector.
    */
   void Attach(Actor actor);
 
   /**
    * @brief Detaches the attached actor from the gesture detector.
    *
-   * @param[in]  actor  The actor to detach from the gesture detector.
+   * @SINCE_1_0.0
+   * @param[in] actor The actor to detach from the gesture detector
    * @pre The gesture detector has been initialized.
    * @pre The specified actor has been attached to the gesture detector.
    */
@@ -111,6 +125,7 @@ public: // Actor related
   /**
    * @brief Detaches all the actors that have been attached to the gesture detector.
    *
+   * @SINCE_1_0.0
    * @pre The gesture detector has been initialized.
    * @pre At least one actor has been attached to the gesture detector.
    */
@@ -119,6 +134,7 @@ public: // Actor related
   /**
    * @brief Returns the number of actors attached to the gesture detector.
    *
+   * @SINCE_1_0.0
    * @return The count
    * @pre The gesture detector has been initialized.
    */
@@ -127,7 +143,9 @@ public: // Actor related
   /**
    * @brief Returns an actor by index. An empty handle if the index is not valid.
    *
-   * @return The attached actor or an empty handle.
+   * @SINCE_1_0.0
+   * @param[in] index The attached actor's index
+   * @return The attached actor or an empty handle
    * @pre The gesture detector has been initialized.
    */
   Actor GetAttachedActor(size_t index) const;
@@ -135,13 +153,18 @@ public: // Actor related
 protected:
 
   /**
-   * @brief This constructor is used by Dali New() methods of derived classes.
+   * @internal
+   * @brief This constructor is used by New() methods of derived classes (For example, PanGestureDetector::New()).
    *
-   * @param [in]  internal  A pointer to a newly allocated Dali resource.
+   * @SINCE_1_0.0
+   * @param[in] internal A pointer to a newly allocated Dali resource
    */
   explicit DALI_INTERNAL GestureDetector(Internal::GestureDetector* internal);
 };
 
+/**
+ * @}
+ */
 } // namespace Dali
 
 #endif // __DALI_GESTURE_DETECTOR_H__