[3.0] Update doxygen comments

[platform/core/uifw/dali-core.git] / dali / public-api / events / touch-event.h

diff --git a/dali/public-api/events/touch-event.h b/dali/public-api/events/touch-event.h
index 0d76880..f24ceba 100644 (file)
--- a/dali/public-api/events/touch-event.h
+++ b/dali/public-api/events/touch-event.h
@@ -30,6 +30,8 @@ namespace Dali
  */
 
 /**
+ * @DEPRECATED_1_1.37 Use TouchData instead
+ *
  * @brief Touch events are a collection of touch points at a specific moment in time.
  *
  * When a multi-touch event occurs, each touch point represents the points that are currently being
@@ -41,27 +43,31 @@ struct DALI_IMPORT_API TouchEvent
   // Construction & Destruction
 
   /**
-   * @brief Default constructor
+   * @DEPRECATED_1_1.37
+   * @brief Default constructor.
    * @SINCE_1_0.0
    */
-  TouchEvent();
+  TouchEvent() DALI_DEPRECATED_API;
 
   /**
-   * @brief Constructor
+   * @DEPRECATED_1_1.37
+   * @brief Constructor.
    * @SINCE_1_0.0
-   * @param[in]  time  The time the event occurred
+   * @param[in] time The time the event occurred
    */
-  TouchEvent(unsigned long time);
+  TouchEvent(unsigned long time) DALI_DEPRECATED_API;
 
   /**
-   * @brief Destructor
+   * @DEPRECATED_1_1.37
+   * @brief Destructor.
    * @SINCE_1_0.0
    */
-  ~TouchEvent();
+  ~TouchEvent() DALI_DEPRECATED_API;
 
   // Data
 
   /**
+   * @DEPRECATED_1_1.37
    * @brief This is a container of points for this touch event.
    *
    * The first point in the set is always the
@@ -70,6 +76,7 @@ struct DALI_IMPORT_API TouchEvent
   TouchPointContainer points;
 
   /**
+   * @DEPRECATED_1_1.37
    * @brief The time (in ms) that the touch event occurred.
    */
   unsigned long time;
@@ -77,25 +84,27 @@ struct DALI_IMPORT_API TouchEvent
   // Convenience Methods
 
   /**
+   * @DEPRECATED_1_1.37
    * @brief Returns the total number of points in this TouchEvent.
    *
    * @SINCE_1_0.0
-   * @return Total number of Points.
+   * @return Total number of Points
    */
-  unsigned int GetPointCount() const;
+  unsigned int GetPointCount() const DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_1.37
    * @brief Returns a touch point at the index requested.
    *
    * The first point in the set is always the primary
    * touch point (i.e. the first point touched in a multi-touch event).
    * @SINCE_1_0.0
-   * @param[in] point The index of the required Point.
+   * @param[in] point The index of the required Point
    * @return Point requested
    * @note "point" should be less than the value returned by GetPointCount().
    *       If out of range, then program asserts.
    */
-  const TouchPoint& GetPoint(unsigned int point) const;
+  const TouchPoint& GetPoint(unsigned int point) const DALI_DEPRECATED_API;
 };
 
 /**