Deprecating Attach Panel APIs

Change-Id: I656d1c68c8fe964dcb6afcc37d3d9bb990b0420f
Signed-off-by: Shivam Varshney/Core S/W Group /SRI-Delhi/Engineer/Samsung Electronics <shivam.v2@samsung.com>

diff --git a/doc/attach_panel_doc.h b/doc/attach_panel_doc.h
index 747da31b73f1b6629c34bae8c69369eb866cf5d3..399dc9cc666e0e9b1b11560c748801e401cda6f5 100755 (executable)
--- a/doc/attach_panel_doc.h
+++ b/doc/attach_panel_doc.h
@@ -21,7 +21,7 @@
 
 /**
  * @ingroup CAPI_APPLICATION_FRAMEWORK
- * @defgroup CAPI_PANEL_ATTACH_MODULE Attach panel
+ * @defgroup CAPI_PANEL_ATTACH_MODULE Attach panel (deprecated)
  * @brief Attach panel provides functions to attach images, voices, contacts, events and files. Users can attach images, take pictures, record voice and select files to attach into the caller app.
  * @section CAPI_PANEL_ATTACH_MODULE_HEADER Required Header
  * \#include <attach_panel.h>

diff --git a/include/attach_panel.h b/include/attach_panel.h
index 437cae9b28cccc4c08f37b95ee8bf7352e641ed5..bc9a191e09a69bbf60c6c849879836278993fb91 100755 (executable)
--- a/include/attach_panel.h
+++ b/include/attach_panel.h
@@ -17,6 +17,7 @@
 #ifndef __TIZEN_ATTACH_PANEL_H__
 #define __TIZEN_ATTACH_PANEL_H__
 
+#include <tizen.h>
 #include <Elementary.h>
 #include <tizen_error.h>
 #include <app_control.h>
@@ -28,6 +29,7 @@ extern "C" {
 #endif
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @file attach_panel.h
  * @brief Declares the API of the libattach-panel library.
  */
@@ -38,6 +40,7 @@ extern "C" {
  */
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Enumeration for content categories.
  * @since_tizen 2.4
  * @see attach_panel_add_content_category()
@@ -59,6 +62,7 @@ typedef enum attach_panel_content_category {
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Enumeration for events.
  * @since_tizen 2.4
  * @see attach_panel_set_event_cb()
@@ -72,6 +76,7 @@ typedef enum attach_panel_event {
 } attach_panel_event_e;
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Enumeration for window state
  * @since_tizen 3.0
  * @see attach_panel_get_state()
@@ -84,6 +89,7 @@ typedef enum {
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Attach panel handle.
  * @since_tizen 2.4
  */
@@ -91,6 +97,7 @@ typedef struct _attach_panel *attach_panel_h;
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Called when an user selects and confirms something to attach on the caller app.
  * @since_tizen 2.4
  * @param[in] attach_panel Attach panel handler
@@ -110,6 +117,7 @@ typedef void (*attach_panel_result_cb)(attach_panel_h attach_panel, attach_panel
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Called when reserved events are published from the panel-side.
  * @since_tizen 2.4
  * @param[in] attach_panel Attach panel handler
@@ -125,6 +133,7 @@ typedef void (*attach_panel_event_cb)(attach_panel_h attach_panel, attach_panel_
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Enumeration for values of attach-panel response types.
  * @since_tizen 2.4
  */
@@ -143,6 +152,7 @@ typedef enum attach_panel_error {
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Creates an attach panel.
  * @since_tizen 2.4
  * @remarks The caller app has to check the return value of this function.\n
@@ -256,10 +266,11 @@ typedef enum attach_panel_error {
  *
  * @endcode
  */
-int attach_panel_create(Evas_Object *conformant, attach_panel_h *attach_panel);
+int attach_panel_create(Evas_Object *conformant, attach_panel_h *attach_panel) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Destroys the attach panel.
  * @since_tizen 2.4
  * @remarks The caller app has to check the return value of this function.\n
@@ -333,10 +344,11 @@ int attach_panel_create(Evas_Object *conformant, attach_panel_h *attach_panel);
  *
  * @endcode
  */
-int attach_panel_destroy(attach_panel_h attach_panel);
+int attach_panel_destroy(attach_panel_h attach_panel) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Adds a content category in the attach panel.
  * @since_tizen 2.4
  * @privlevel public
@@ -478,10 +490,11 @@ int attach_panel_destroy(attach_panel_h attach_panel);
  *
  * @endcode
  */
-int attach_panel_add_content_category(attach_panel_h attach_panel, attach_panel_content_category_e content_category, bundle *extra_data);
+int attach_panel_add_content_category(attach_panel_h attach_panel, attach_panel_content_category_e content_category, bundle *extra_data) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Removes the content category from the attach panel.
  * @since_tizen 2.4
  * @remarks The caller app has to check the return value of this function.\n
@@ -566,10 +579,11 @@ int attach_panel_add_content_category(attach_panel_h attach_panel, attach_panel_
  *
  * @endcode
  */
-int attach_panel_remove_content_category(attach_panel_h attach_panel, attach_panel_content_category_e content_category);
+int attach_panel_remove_content_category(attach_panel_h attach_panel, attach_panel_content_category_e content_category) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Sets extra data to send to the content category using a bundle.
  * @since_tizen 2.4
  * @privlevel public
@@ -726,10 +740,11 @@ int attach_panel_remove_content_category(attach_panel_h attach_panel, attach_pan
  *
  * @endcode
  */
-int attach_panel_set_extra_data(attach_panel_h attach_panel, attach_panel_content_category_e content_category, bundle *extra_data);
+int attach_panel_set_extra_data(attach_panel_h attach_panel, attach_panel_content_category_e content_category, bundle *extra_data) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Sets the result callback that will be called when an user selects and confirms something to attach in the attach panel.
  * @since_tizen 2.4
  * @remarks The caller app has to check the return value of this function.\n
@@ -845,10 +860,11 @@ int attach_panel_set_extra_data(attach_panel_h attach_panel, attach_panel_conten
  *
  * @endcode
  */
-int attach_panel_set_result_cb(attach_panel_h attach_panel, attach_panel_result_cb result_cb, void *user_data);
+int attach_panel_set_result_cb(attach_panel_h attach_panel, attach_panel_result_cb result_cb, void *user_data) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Unsets the result callback that will be called when an user selects and confirms something to attach in the attach panel.
  * @since_tizen 2.4
  * @remarks The caller app has to check the return value of this function.\n
@@ -922,10 +938,11 @@ int attach_panel_set_result_cb(attach_panel_h attach_panel, attach_panel_result_
  *
  * @endcode
  */
-int attach_panel_unset_result_cb(attach_panel_h attach_panel);
+int attach_panel_unset_result_cb(attach_panel_h attach_panel) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Sets the event callback that will be called when reserved events are published from the panel-side.
  * @since_tizen 2.4
  * @remarks The caller app has to check the return value of this function.\n
@@ -1010,10 +1027,11 @@ int attach_panel_unset_result_cb(attach_panel_h attach_panel);
  *
  * @endcode
  */
-int attach_panel_set_event_cb(attach_panel_h attach_panel, attach_panel_event_cb panel_event_cb, void *user_data);
+int attach_panel_set_event_cb(attach_panel_h attach_panel, attach_panel_event_cb panel_event_cb, void *user_data) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Unsets the event callback
  * @since_tizen 2.4
  * @remarks The caller app has to check the return value of this function.
@@ -1067,10 +1085,11 @@ int attach_panel_set_event_cb(attach_panel_h attach_panel, attach_panel_event_cb
  *
  * @endcode
  */
-int attach_panel_unset_event_cb(attach_panel_h attach_panel);
+int attach_panel_unset_event_cb(attach_panel_h attach_panel) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Shows the attach panel, asynchronously.
  * @since_tizen 2.4
  * @remarks The caller app has to check the return value of this function.\n
@@ -1179,10 +1198,11 @@ int attach_panel_unset_event_cb(attach_panel_h attach_panel);
  *
  * @endcode
  */
-int attach_panel_show(attach_panel_h attach_panel);
+int attach_panel_show(attach_panel_h attach_panel) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Shows the attach panel, synchronously.
  * @since_tizen 4.0
  * @param[in] attach_panel The attach panel handle
@@ -1282,10 +1302,11 @@ int attach_panel_show(attach_panel_h attach_panel);
  *
  * @endcode
  */
-int attach_panel_show_without_animation(attach_panel_h attach_panel);
+int attach_panel_show_without_animation(attach_panel_h attach_panel) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Hides the attach panel, asynchronously.
  * @since_tizen 2.4
  * @remarks The caller app has to check the return value of this function.\n
@@ -1357,10 +1378,11 @@ int attach_panel_show_without_animation(attach_panel_h attach_panel);
  *
  * @endcode
  */
-int attach_panel_hide(attach_panel_h attach_panel);
+int attach_panel_hide(attach_panel_h attach_panel) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Hides the attach panel, synchronously.
  * @since_tizen 4.0
  * @param[in] attach_panel The attach panel handle
@@ -1423,10 +1445,11 @@ int attach_panel_hide(attach_panel_h attach_panel);
  *
  * @endcode
  */
-int attach_panel_hide_without_animation(attach_panel_h attach_panel);
+int attach_panel_hide_without_animation(attach_panel_h attach_panel) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Gets a value that indicates whether the attach_panel is visible.
  * @since_tizen 2.4
  * @remarks The caller app has to check the return value of this function.\n
@@ -1507,9 +1530,10 @@ int attach_panel_hide_without_animation(attach_panel_h attach_panel);
  *
  * @endcode
  */
-int attach_panel_get_visibility(attach_panel_h attach_panel, bool *visible);
+int attach_panel_get_visibility(attach_panel_h attach_panel, bool *visible) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since tizen 9.0.
  * @brief Gets the state of the attach_panel.
  * @since_tizen 3.0
  * @remarks Users can toggle the attach panel between full screen state or partial window state.\n
@@ -1552,7 +1576,7 @@ int attach_panel_get_visibility(attach_panel_h attach_panel, bool *visible);
  *
  * @endcode
  */
-int attach_panel_get_state(attach_panel_h attach_panel, attach_panel_state_e *state);
+int attach_panel_get_state(attach_panel_h attach_panel, attach_panel_state_e *state) TIZEN_DEPRECATED_API;
 
 /**
  * @}