Add missing parameter to event callback 84/230584/4
authorInHong Han <inhong1.han@samsung.com>
Mon, 13 Apr 2020 01:25:56 +0000 (10:25 +0900)
committerInHong Han <inhong1.han@samsung.com>
Mon, 13 Apr 2020 10:37:40 +0000 (19:37 +0900)
Change-Id: I2fcad31c0c17dacc8703f83c82c5a574a2608ca1

include/sticker_consumer.h

index fb6985d..7231f26 100644 (file)
@@ -98,13 +98,18 @@ typedef void (*sticker_consumer_keyword_list_foreach_cb)(const char *keyword, vo
 /**
  * @brief Called when the stickers are inserted, deleted, or updated.
  * @since_tizen 5.5
+ * @remarks @a data_handle should not be freed and can be used only in the callback.
+ *          If you want to use it outside of the callback, you need to use a clone which can be obtained sticker_data_clone().
+ *          When the @a event_type is STICKER_CONSUMER_EVENT_TYPE_DELETE, sticker data can be obtained using @a data_handle,
+ *          but unable to access file because it has been deleted.
  * @param[in] event_type The event type of sticker
+ * @param[in] data_handle The sticker data handle
  * @param[in] user_data The user data passed from sticker_consumer_set_event_callback()
  * @pre The callback can be registered using sticker_consumer_set_event_callback()
  * @see sticker_consumer_set_event_callback()
  * @see sticker_consumer_unset_event_callback()
  */
-typedef void (*sticker_consumer_event_cb)(sticker_consumer_event_type_e event_type, void *user_data);
+typedef void (*sticker_consumer_event_cb)(sticker_consumer_event_type_e event_type, sticker_data_h data_handle, void *user_data);
 
 /**
  * @brief Creates a sticker consumer handle.