#define __TIZEN_ATTACH_PANEL_DOC_H__
/**
+ * @defgroup CAPI_PANEL_MODULE Panel
+ * @brief The Panel module provides APIs to choose data or apps easily.
* @ingroup CAPI_APPLICATION_FRAMEWORK
+ *
+ * @section CAPI_PANEL_MODULE_OVERVIEW Overview
+ * <table>
+ * <tr><th>API</th><th>Description</th></tr>
+ * <tr><td>@ref CAPI_PANEL_ATTACH_MODULE</td><td>Provide functions to attach images, voices, contacts, events and files.</td></tr>
+ * <tr><td>@ref CAPI_PANEL_STICKER_MODULE</td><td>Provide functions to attach stickers easily.</td></tr>
+ * <tr><td>@ref CAPI_PANEL_SHARE_MODULE</td><td>Provide functions to share data with apps.</td></tr>
+ * </table>
+ *
* @defgroup CAPI_PANEL_ATTACH_MODULE Attach panel
- * @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
+ * @brief The Attach Panel provides functions to attach data easily. Users can attach images, take pictures, record voice and select files to attach into the caller app
+ * @ingroup CAPI_PANEL_MODULE
*
* @section CAPI_PANEL_ATTACH_MODULE_HEADER Required Header
* \#include <attach_panel.h>
- *
* @section CAPI_PANEL_ATTACH_MODULE_OVERVIEW Overview
- * - It provides functions for adding an attach panel (attach_panel_create()) and deleting it (attach_panel_destroy()) in an app.\n
- * - Content categories can be added (attach_panel_add_content_category()) or removed (attach_panel_remove_content_category()).\n
- * - Dynamic configurations can be handled with (attach_panel_set_extra_data()). This is used with a content category.
- * - Results can be returned into the result callback that is set (attach_panel_set_result_cb()) or unset (attach_panel_unset_result_cb()).\n
- * - Events are delivered into the event callback that is set with (attach_panel_set_event_cb()) or unset with (attach_panel_unset_event_cb()).\n
- * - The panel can be shown with (attach_panel_show()) and hidden with (attach_panel_hide()).\n
- * - You can get the state of the panel with (attach_panel_get_visibility()).\n
+ * It provides functions for adding an Attach Panel (attach_panel_create()) and deleting it (attach_panel_destroy()) in an app.\n
+ * It is shown with (attach_panel_show()) and hiden with (attach_panel_hide()).\n
+ * The results can be returned into the result callback that is set (attach_panel_set_result_cb()) or unset (attach_panel_unset_result_cb()).\n
+ * Content categories can be added (attach_panel_add_content_category()) or removed (attach_panel_remove_content_category()).\n
*
* @section CAPI_PANEL_ATTACH_MODULE_FEATURE Related Features
* This API is related with the following features:\n
- * - %http://tizen.org/feature/camera\n
- * - %http://tizen.org/feature/microphone\n
- *
+ * - http://tizen.org/feature/camera\n
+ * - http://tizen.org/feature/microphone\n
* It is recommended to design feature related codes in your application for reliability.\n
* You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, thereby controlling the procedure of your application.\n
* To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n
- * More details on featuring your application can be found from <a href="https://developer.tizen.org/development/tools/native-tools/manifest-text-editor#feature"><b>Feature Element</b>.</a>
+ * More details on featuring your application can be found from <a href="../org.tizen.mobile.native.appprogramming/html/ide_sdk_tools/feature_element.htm"><b>Feature Element</b>.</a>
*/
-
#endif
*
* @endcode
*/
-int attach_panel_create(Evas_Object *conformant, attach_panel_h *attach_panel);
+extern int attach_panel_create(Evas_Object *conformant, attach_panel_h *attach_panel);
/**
* @brief Destroys the attach panel.
*
* @endcode
*/
-int attach_panel_destroy(attach_panel_h attach_panel);
+extern int attach_panel_destroy(attach_panel_h attach_panel);
/**
* @brief Adds a content category in the attach panel.
* @since_tizen 2.4
* @privlevel public
- * @privilege %http://tizen.org/privilege/mediastorage
- * @privilege %http://tizen.org/privilege/camera
- * @privilege %http://tizen.org/privilege/recorder
- * @privilege %http://tizen.org/privilege/appmanager.launch
* @remarks The caller app has to check the return value of this function.\n
* Content categories will be shown as the sequence of using @a attach_panel_add_content_category.\n
* Some contents need time to load it all.\n
* So, it is needed to use this before the mainloop of attach_panel_show().\n
* Privileges,\n
- * %http://tizen.org/privilege/mediastorage, for using ATTACH_PANEL_CONTENT_CATEGORY_IMAGE or ATTACH_PANEL_CONTENT_CATEGORY_CAMERA\n
* %http://tizen.org/privilege/camera, for using ATTACH_PANEL_CONTENT_CATEGORY_CAMERA\n
* %http://tizen.org/privilege/recorder, for using ATTACH_PANEL_CONTENT_CATEGORY_VOICE\n
* %http://tizen.org/privilege/appmanager.launch, for adding content categories on the More tab\n
*
* @param[in] attach_panel Attach panel handler
* @param[in] content_category The content_category to be added in the @a attach_panel.
- * @param[in] extra_data The attach panel send some information using @a bundle.
+ * @param[in] The attach panel send some information using @a bundle.
* @return #ATTACH_PANEL_ERROR_NONE on success,
* otherwise a negative error value
* @retval #ATTACH_PANEL_ERROR_NONE Successful
*
* @endcode
*/
-int attach_panel_add_content_category(attach_panel_h attach_panel, attach_panel_content_category_e content_category, bundle *extra_data);
+extern int attach_panel_add_content_category(attach_panel_h attach_panel, attach_panel_content_category_e content_category, bundle *extra_data);
/**
* @brief Removes the content category from the attach panel.
*
* @endcode
*/
-int attach_panel_remove_content_category(attach_panel_h attach_panel, attach_panel_content_category_e content_category);
+extern int attach_panel_remove_content_category(attach_panel_h attach_panel, attach_panel_content_category_e content_category);
/**
* @brief Sets extra data to send to the content category using a bundle.
*
* @param[in] attach_panel Attach panel handler
* @param[in] content_category The content_category to be set the some information in the @a attach_panel.
- * @param[in] extra_data The attach panel set some information using @a bundle.
+ * @param[in] The attach panel set some information using @a bundle.
* @return #ATTACH_PANEL_ERROR_NONE on success,
* otherwise a negative error value
* @retval #ATTACH_PANEL_ERROR_NONE Successful
*
* @endcode
*/
-int attach_panel_set_extra_data(attach_panel_h attach_panel, attach_panel_content_category_e content_category, bundle *extra_data);
+extern int attach_panel_set_extra_data(attach_panel_h attach_panel, attach_panel_content_category_e content_category, bundle *extra_data);
/**
* @brief Sets the result callback that will be called when an user selects and confirms something to attach in the attach panel.
*
* @endcode
*/
-int attach_panel_set_result_cb(attach_panel_h attach_panel, attach_panel_result_cb result_cb, void *user_data);
+extern int attach_panel_set_result_cb(attach_panel_h attach_panel, attach_panel_result_cb result_cb, void *user_data);
/**
* @brief Unsets the result callback that will be called when an user selects and confirms something to attach in the attach panel.
*
* @endcode
*/
-int attach_panel_unset_result_cb(attach_panel_h attach_panel);
+extern int attach_panel_unset_result_cb(attach_panel_h attach_panel);
/**
* @brief Sets the event callback that will be called when reserved events are published from the panel-side.
* the last one is registered only.
*
* @param[in] attach_panel Attach panel handler
- * @param[in] panel_event_cb Attach panel event callback
+ * @param[in] event_cb Attach panel event callback
* @param[in] user_data User data
* @return #ATTACH_PANEL_ERROR_NONE on success,
* otherwise a negative error value
*
* @endcode
*/
-int attach_panel_set_event_cb(attach_panel_h attach_panel, attach_panel_event_cb panel_event_cb, void *user_data);
+extern int attach_panel_set_event_cb(attach_panel_h attach_panel, attach_panel_event_cb event_cb, void *user_data);
/**
* @brief Unsets the event callback
*
* @endcode
*/
-int attach_panel_unset_event_cb(attach_panel_h attach_panel);
+extern int attach_panel_unset_event_cb(attach_panel_h attach_panel);
/**
* @brief Shows the attach panel, asynchronously.
*
* @endcode
*/
-int attach_panel_show(attach_panel_h attach_panel);
+extern int attach_panel_show(attach_panel_h attach_panel);
/**
* @brief Hides the attach panel, asynchronously.
*
* @endcode
*/
-int attach_panel_hide(attach_panel_h attach_panel);
+extern int attach_panel_hide(attach_panel_h attach_panel);
/**
* @brief Gets a value that indicates whether the attach_panel is visible.
*
* @endcode
*/
-int attach_panel_get_visibility(attach_panel_h attach_panel, bool *visible);
+extern int attach_panel_get_visibility(attach_panel_h attach_panel, bool *visible);
/**
* @}