summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKyuho Jo <kyuho.jo@samsung.com>2015-02-02 16:28:14 +0900
committerKyuho Jo <kyuho.jo@samsung.com>2015-02-02 16:28:14 +0900
commit692a8ba00c3587ffa04229d992f0779f179c62d1 (patch)
treeb028b6514a49efe2e6359935f8c088b25fdf2d8a
parentd56988cdddc9b996559114366c91c6b45c75be68 (diff)
downloadwidget-service-692a8ba00c3587ffa04229d992f0779f179c62d1.tar.gz
widget-service-692a8ba00c3587ffa04229d992f0779f179c62d1.tar.bz2
widget-service-692a8ba00c3587ffa04229d992f0779f179c62d1.zip
privileges and features are updated
Change-Id: Ibcf132e78ab89db189ae82871bf1fe588cc6ffbe Signed-off-by: Kyuho Jo <kyuho.jo@samsung.com>
-rwxr-xr-x[-rw-r--r--]dynamicbox_service/include/dynamicbox_service.h317
1 files changed, 138 insertions, 179 deletions
diff --git a/dynamicbox_service/include/dynamicbox_service.h b/dynamicbox_service/include/dynamicbox_service.h
index 6bb65f3..b55b85b 100644..100755
--- a/dynamicbox_service/include/dynamicbox_service.h
+++ b/dynamicbox_service/include/dynamicbox_service.h
@@ -24,7 +24,7 @@ extern "C" {
/**
* @file dynamic-service.h
* @brief This file declares API of libdynamic-service library
- * @since_tizen 2.3
+ * @since_tizen 2.4
*/
/**
@@ -34,14 +34,14 @@ extern "C" {
/**
* @brief Index of buffer
- * @since_tizen 2.3
+ * @since_tizen 2.4
*/
#define DBOX_PRIMARY_BUFFER -1
#define DBOX_UNKNOWN_BUFFER -2
/**
* @brief Definition for maximum number of supported dynamicbox size type.
- * @since_tizen 2.3
+ * @since_tizen 2.4
*/
#define DBOX_NR_OF_SIZE_LIST 13
@@ -50,7 +50,7 @@ extern "C" {
/**
* @brief Enumeration for list of supporting dynamicbox size types.
- * @since_tizen 2.3
+ * @since_tizen 2.4
*/
typedef enum dynamicbox_size_type {
DBOX_SIZE_TYPE_1x1 = 0x0001, /**< 175x175 based on 720x1280 resolution */
@@ -73,7 +73,7 @@ typedef enum dynamicbox_size_type {
* @internal
* @brief Enumeration for result of accessibility event processing.
* @details Reference the libprovider & libdynamicbox-viewer.
- * @since_tizen 2.3
+ * @since_tizen 2.4
*/
typedef enum dynamicbox_access_status {
DBOX_ACCESS_STATUS_ERROR = 0x80000000, /**< Mask value */
@@ -86,7 +86,7 @@ typedef enum dynamicbox_access_status {
/**
* @internal
* @brief Key event handling result status.
- * @since_tizen 2.3
+ * @since_tizen 2.4
*/
typedef enum dynamicbox_key_status {
DBOX_KEY_STATUS_ERROR = 0x80000000, /**< Key operation is failed */
@@ -97,7 +97,7 @@ typedef enum dynamicbox_key_status {
/**
* @brief Delete type for dynamicbox delete operation.
- * @since_tizen 2.3
+ * @since_tizen 2.4
*/
typedef enum dynamicbox_delete_type {
DBOX_DELETE_PERMANENTLY = 0x01, /**< The dynamicbox is removed from the homescreen temporary */
@@ -107,7 +107,7 @@ typedef enum dynamicbox_delete_type {
/**
* @brief Request type for closing Glance Bar
- * @since_tizen 2.3
+ * @since_tizen 2.4
*/
typedef enum dynamicbox_gbar_close_type {
DBOX_CLOSE_GBAR_NORMAL = 0x00, /**< Glance Bar is closed normally */
@@ -119,7 +119,7 @@ typedef enum dynamicbox_gbar_close_type {
/**
* @internal
* @brief Type of dynamicbox content sharing method
- * @since_tizen 2.3
+ * @since_tizen 2.4
*/
typedef enum dynamicbox_dbox_type {
DBOX_TYPE_NONE = 0x0, /**< Undefined */
@@ -133,7 +133,7 @@ typedef enum dynamicbox_dbox_type {
/**
* @internal
* @brief Type of glance bar content sharing method
- * @since_tizen 2.3
+ * @since_tizen 2.4
*/
typedef enum dynamicbox_gbar_type {
GBAR_TYPE_NONE = 0x0, /**< Undefined */
@@ -145,7 +145,7 @@ typedef enum dynamicbox_gbar_type {
/**
* @brief Destroy type of dynamicbox instance
- * @since_tizen 2.3
+ * @since_tizen 2.4
*/
typedef enum dynamicbox_destroy_type {
DBOX_DESTROY_TYPE_DEFAULT = 0x00, /**< Deleted */
@@ -160,7 +160,7 @@ typedef enum dynamicbox_destroy_type {
/**
* @brief
* Text signal & Content event uses this data structure.
- * @since_tizen 2.3
+ * @since_tizen 2.4
*/
typedef struct dynamicbox_event_info {
struct _pointer {
@@ -179,26 +179,26 @@ typedef struct dynamicbox_event_info {
/**
* @brief Dynamicbox Buffer Handler
- * @since_tizen 2.3
+ * @since_tizen 2.4
*/
typedef struct dynamicbox_buffer *dynamicbox_buffer_h;
/**
* @brief Dynamicbox Buffer Event information
- * @since_tizen 2.3
+ * @since_tizen 2.4
*/
typedef struct dynamicbox_buffer_event_data *dynamicbox_buffer_event_data_t;
/**
* @brief Dynamicbox Buffer Handler
- * @since_tizen 2.3
+ * @since_tizen 2.4
*/
typedef struct dynamicbox_buffer *dynamicbox_buffer_h;
/**
* @internal
* @brief This enumeration values should be sync'd with libdynamicbox interface. (only for inhouse dynamicbox)
- * @since_tizen 2.3
+ * @since_tizen 2.4
*/
typedef enum dynamicbox_buffer_event {
DBOX_BUFFER_EVENT_ENTER, /**< get the focus */
@@ -240,7 +240,7 @@ typedef enum dynamicbox_buffer_event {
/**
* @internal
* @brief Dynamic Box Buffer Event Data
- * @since_tizen 2.3
+ * @since_tizen 2.4
*/
typedef struct dynamicbox_buffer_event_data {
dynamicbox_buffer_event_e type; /**< Event type */
@@ -268,7 +268,7 @@ typedef struct dynamicbox_buffer_event_data {
/**
* @internal
* @brief Package list handle.
- * @since_tizen 2.3
+ * @since_tizen 2.4
*/
typedef struct dynamicbox_pkglist_handle *dynamicbox_pkglist_h;
@@ -289,12 +289,11 @@ typedef struct dynamicbox_pkglist_handle *dynamicbox_pkglist_h;
* #DBOX_SIZE_TYPE_EASY_1x1\n
* #DBOX_SIZE_TYPE_EASY_3x1\n
* #DBOX_SIZE_TYPE_EASY_3x3.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] type Size type
* @param[out] width Pixel size width
* @param[out] height Pixel size height
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval #DBOX_STATUS_ERROR_PERMISSION_DENIED Permission denied
* @retval #DBOX_STATUS_ERROR_NONE Successfully done
@@ -322,11 +321,10 @@ extern int dynamicbox_service_get_size(dynamicbox_size_type_e type, int *width,
* #DBOX_SIZE_TYPE_EASY_3x3\n
* or\n
* #DBOX_SIZE_TYPE_UNKNOWN for error.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] width Pixel size width
* @param[in] height Pixel size height
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval #DBOX_SIZE_TYPE_[EASY_]WxH Size type of given pixel size
* @retval #DBOX_SIZE_TYPE_UNKNOWN If the given pixel size is not valid, dynamicbox_last_status() will returns reason of failure.
@@ -341,12 +339,11 @@ extern dynamicbox_size_type_e dynamicbox_service_size_type(int width, int height
* @details This function will returns true/false, but even if this fails to access database to retrieve information,
* This will returns 0. in that case, you can check it using dynamicbox_last_status() function.
* If there is an error, it will returns proper error code.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval 1 If the box requires mouse event, A viewer must has to feed the mouse event to the box instance
* @retval 0 If the box doesn't requires mouse event, In this case, you can check whether it is error or not using dynamicbox_last_status() function.
@@ -363,13 +360,12 @@ extern int dynamicbox_service_mouse_event(const char *dboxid, int size_type);
* This function returns 1 even if it fails to retrieve information from Database.
* So if you need validate the information whether it is correct or not, you can use dynamicbox_last_status() function.
* Even if this function returns 1, It is recommended to check last status of this function call.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @param[in] size_type Size type
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval 1 If the box requires touch effect, A viewer should make the touch effect, but it is just recomendation.
* @retval 0 If the box doesn't requires touch effect, the box will make touch effect itself
@@ -386,13 +382,12 @@ extern int dynamicbox_service_touch_effect(const char *dboxid, int size_type);
* If this function returns 0, you can validate it using dynamicbox_last_status() function.
* If something goes wrong, so this fails to retrieve information, you can check reason why it fails to get it
* using dynamicbox_last_status() function.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @param[in] size_type Size type
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval 1 If the box requires frame for decorating its contents
* @retval 0 If the box doesn't requires frame
@@ -404,7 +399,7 @@ extern int dynamicbox_service_need_frame(const char *dboxid, int size_type);
/**
* @brief Triggers the update event for given dynamicbox instance.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @param[in] instance_id Set @c NULL if you don't know what the Id is. Then every instance of given pkgname will be triggered its update event
* @param[in] cluster Cluster name. Default @c NULL
@@ -412,9 +407,8 @@ extern int dynamicbox_service_need_frame(const char *dboxid, int size_type);
* @param[in] content New content information, Default @c NULL
* @param[in] force 1 if you want to update your dynamicbox even if the provider is paused or 0. 0 is default
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.provider
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.provider
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval #DBOX_STATUS_ERROR_INVALID_PARAMETER Invalid argument
* @retval #DBOX_STATUS_ERROR_CANCEL Provider is paused, so this update request is canceld.(ignored), if you want to make update forcely, use force=1
@@ -428,14 +422,13 @@ extern int dynamicbox_service_trigger_update(const char *dboxid, const char *ins
/**
* @brief Changes the update period of given dynamicbox instance.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @param[in] instance_id Dynamicbox instance id
* @param[in] period New update period in sec
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.provider
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.provider
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval #DBOX_STATUS_ERROR_NONE Successfully changed(requested)
* @retval #DBOX_STATUS_ERROR_INVALID_PARAMETER Invalid argument
@@ -454,13 +447,12 @@ extern int dynamicbox_service_change_period(const char *dboxid, const char *inst
* dboxid = Dynamicbox AppId\n
* is_prime = 1 if the dynamicbox is default one for associated application package\n
* If the callback returns negative value, the list crawling will be stopped.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] cb Callback function
* @param[in] data Callback data
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval #DBOX_STATUS_ERROR_IO_ERROR Failed to access DB
* @retval #DBOX_STATUS_ERROR_INVALID_PARAMETER Invalid argument
@@ -477,14 +469,13 @@ extern int dynamicbox_service_get_pkglist(int (*cb)(const char *pkgid, const cha
* Callback (appid, data)\n
* This function will retrieve all UI Apps in a package which has given dynamicbox appid(dboxid).\n
* If you need to get all ui-app list, using a dynamicbox appid, this function is able to help you.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox App Id
* @param[in] cb Callback function
* @param[in] data Callback Data
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval #DBOX_STATUS_ERROR_NONE Status success
* @retval #DBOX_STATUS_ERROR_INVALID_PARAMETER Invalid argument
@@ -498,12 +489,11 @@ extern int dynamicbox_service_get_applist(const char *dboxid, void (*cb)(const c
/**
* @internal
* @brief Gets the MAIN application Id of given dynamicbox package Id.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox Package Id
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return char * type
* @retval @c NULL If it fails to get main application Id (UI-APPID), dynamicbox_last_status() will returns reason of failure.
* @retval appid Main application Id
@@ -519,14 +509,13 @@ extern char *dynamicbox_service_mainappid(const char *dboxid);
* dboxid == Dynamicbox AppId\n
* is_prime = 1 if the dynamicbox is default one for selected package\n
* If the callback returns negative value, the list crawling will be stopped.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] pkgid Package Id (Not the UI App Id)
* @param[in] cb Callback function
* @param[in] data Callback data
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval int Count of dynamicbox packages
* @retval #DBOX_STATUS_ERROR_INVALID_PARAMETER Invalid argument
@@ -543,14 +532,13 @@ extern int dynamicbox_service_get_pkglist_by_pkgid(const char *pkgid, int (*cb)(
* callback (dboxid)\n
* dboxid == Dynamicbox AppId\n
* If the callback returns negative value, the list crawling will be stopped
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] category Name of category
* @param[in] cb Callback function
* @param[in] data Callback data
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int count
* @retval Count of dynamicbox packages
* @retval #DBOX_STATUS_ERROR_INVALID_PARAMETER Invalid argument
@@ -563,12 +551,11 @@ extern int dynamicbox_service_get_pkglist_by_category(const char *category, int
/**
* @internal
* @brief Gets the id of a primary dynamicbox using given (dbox or package or UI app) Id. If a given id is a dynamicbox id, check its existence. and if it is package or ui-app id, then find the primary dynamicbox in its package.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] id Dynamic Box Id or Package Id or UI App Id
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return char * type
* @retval @c NULL Failed to get primary dboxid, dynamicbox_last_status() will returns reason of failure.
* @retval dboxid Primary dynamicbox Id. which is allocated in the heap
@@ -580,12 +567,11 @@ extern char *dynamicbox_service_dbox_id(const char *id);
/**
* @internal
* @brief Checks the primary flag of given dynamicbox Id.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox Id
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval 0 If is not a primary, dynamicbox_last_status() will returns reason of failure if it fails.
* @retval 1 If it is a primary dynamicbox
@@ -595,12 +581,11 @@ extern int dynamicbox_service_is_primary(const char *dboxid);
/**
* @internal
* @brief Get the category using given dboxid.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return char *
* @retval @c NULL Failed to get primary dboxid, dynamicbox_last_status() will returns reason of failure if it fails.
* @retval category Category string which is allocated in the heap.
@@ -617,10 +602,9 @@ extern char *dynamicbox_service_category(const char *dboxid);
* Dynamicbox has provider process for each dynamicbox instances.\n
* To get the provider's package name, you can use this API.\n
* If the given dboxid is inhouse dynamicbox, the return string will be the same with given argument but it is allocated in the heap.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox Id
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @feature http://tizen.org/feature/shell.appwidget
* @return char * type
* @retval @c NULL Failed to get provider name, dynamicbox_last_status() will returns reason of failure if it fails.
* @retval dboxid Dynamicbox AppId which is allocated on the heap
@@ -635,12 +619,11 @@ extern char *dynamicbox_service_provider_name(const char *dboxid);
* This setup app should be launched before adding the dynamicbox to get the content_info.\n
* This function should be called before add a dynamicbox.\n
* To determine the content information string.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox Id
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return char * type
* @retval @c NULL There is no setup application or error occurred, you can check it using dynamicbox_last_status()
* @retval appid AppId if exists or @c NULL
@@ -652,12 +635,11 @@ extern char *dynamicbox_service_setup_appid(const char *dboxid);
/**
* @internal
* @brief Gets the Package Id (Not the UI App Id) of given dynamicbox, &lt;manifest package="AAA"&gt; tag.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return char * type
* @retval appid String which is allocated in the heap
* @retval @c NULL Invalid appid, dynamicbox_last_status() will returns reason of failure if it fails.
@@ -669,13 +651,12 @@ extern char *dynamicbox_service_package_id(const char *dboxid);
/**
* @internal
* @brief Gives Internationalized name of dynamicbox package.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @param[in] lang Locale(en-us, ko-kr, ...), if it is @c NULL, function will use the system locale automatically
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return char * type
* @retval name If it fails to get name
* @retval @c NULL Allocated heap address, dynamicbox_last_status() will returns reason of failure if it fails.
@@ -689,13 +670,12 @@ extern char *dynamicbox_service_i18n_name(const char *dboxid, const char *lang);
* @internal
* @brief Gets the preview image path of given size type.
* @details This function will returns i18nized preview image path.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @param[in] size_type Dynamicbox size type
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return char * type
* @retval path Preview image path
* @retval @c NULL There is no preview image file, dynamicbox_last_status() will returns reason of failure if it fails.
@@ -711,12 +691,11 @@ extern char *dynamicbox_service_preview(const char *dboxid, int size_type);
* @details
* If the user defines the default content string in the manifest file (.xml),\n
* this API will return it.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return char * type
* @retval content Content string
* @retval @c NULL There is no specified content string, or dynamicbox_last_status() will returns reason of failure if it fails.
@@ -729,13 +708,12 @@ extern char *dynamicbox_service_content(const char *dboxid);
* @internal
* @brief Gives Internationalized icon path of given dynamicbox package.
* @details The user should free the returned string with free().
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId (It must has to be a dynamicbox package ID. not the UI-APP and the PACKAGE)
* @param[in] lang Locale(en-us, ko-kr, ...), if it is @c NULL, function will use the system locale automatically
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return char * type
* @retval name Allocated heap address
* @retval @c NULL Fails to get path of an icon, dynamicbox_last_status() will returns reason of failure if it fails.
@@ -748,12 +726,11 @@ extern char *dynamicbox_service_i18n_icon(const char *pkgid, const char *lang);
/**
* @internal
* @brief Gets the "nodisplay" value.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval 1 The box should not be listed by the dynamicbox list app
* @retval 0 Box should be listed, dynamicbox_last_status() will returns reason of failure if it fails.
@@ -764,12 +741,11 @@ extern int dynamicbox_service_nodisplay(const char *dboxid);
/**
* @internal
* @brief Gets the "ABI" of given package.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return char * type
* @retval abi String which is allocated in the heap
* @retval @c NULL Failed to get ABI of given dynamicbox, dynamicbox_last_status() will returns reason of failure if it fails.
@@ -781,13 +757,12 @@ extern char *dynamicbox_service_abi(const char *dboxid);
* @internal
* @brief Checks the status of the dynamicbox.
* @details Currently this API is not implemented. It just returns 1 all the time.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @remarks This API is not implemented. It will always return 1.
* @param[in] dboxid Dynamicbox AppId
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval 1 Enabled
* @retval 0 Disabled
@@ -797,12 +772,11 @@ extern int dynamicbox_service_is_enabled(const char *dboxid);
/**
* @internal
* @brief Gets the script file of dynamicbox.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return char * type
* @retval string Script file path
* @retval @c NULL Not specified script file, dynamicbox_last_status() will returns reason of failure if it fails.
@@ -815,12 +789,11 @@ extern char *dynamicbox_service_dbox_script_path(const char *dboxid);
/**
* @internal
* @brief Gets the script group of dynamicbox.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return char * type
* @retval Group Name of dynamicbox
* @retval @c NULL If there is no group defined, or dynamicbox_last_status() will returns reason of failure if it fails.
@@ -833,12 +806,11 @@ extern char *dynamicbox_service_dbox_script_group(const char *dboxid);
/**
* @internal
* @brief Gets the script file path of given dynamicbox package.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return char * type
* @retval string Script file path
* @retval @c NULL No specified script file for Glance Bar layout, or dynamicbox_last_status() will returns reason of failure if it fails.
@@ -850,12 +822,11 @@ extern char *dynamicbox_service_gbar_script_path(const char *dboxid);
/**
* @internal
* @brief Gets the group name for script file to load it.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return char * type
* @retval string Script group name
* @retval @c NULL No script path, or dynamicbox_last_status() will returns reason of failure if it fails.
@@ -867,7 +838,7 @@ extern char *dynamicbox_service_gbar_script_group(const char *dboxid);
/**
* @internal
* @brief Gets the supported size list.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @param[in] cnt Count of array w and h
* @param[in] w Width array
@@ -876,9 +847,8 @@ extern char *dynamicbox_service_gbar_script_group(const char *dboxid);
* @param[out] w Width array
* @param[out] h Height array
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval #DBOX_STATUS_ERROR_NONE If succeed to get supported size list
* @retval #DBOX_STATUS_ERROR_IO_ERROR Failed to access DB
@@ -891,15 +861,14 @@ extern int dynamicbox_service_get_supported_sizes(const char *dboxid, int *cnt,
/**
* @internal
* @brief Gets the supported size list of given pkgid.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @param[in] cnt Size of types array
* @param[out] cnt Result count of types array
* @param[out] types Array of types
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval #DBOX_STATUS_ERROR_INVALID_PARAMETER Invalid argument
* @retval #DBOX_STATUS_ERROR_IO_ERROR Failed to access DB
@@ -912,14 +881,13 @@ extern int dynamicbox_service_get_supported_size_types(const char *dboxid, int *
/**
* @internal
* @brief Gets the category list of given cluster.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] cluster Cluster name
* @param[in] cb Callback function
* @param[in] data Callback data
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval #DBOX_STATUS_ERROR_NONE Successfully done
* @retval #DBOX_STATUS_ERROR_IO_ERROR Failed to access DB
@@ -932,13 +900,12 @@ extern int dynamicbox_service_enumerate_category_list(const char *cluster, int (
/**
* @internal
* @brief Gets the cluster list.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] cb Callback function for retrieving the cluster list
* @param[in] data Callback data
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval #DBOX_STATUS_ERROR_INVALID_PARAMETER Invalid argument
* @retval #DBOX_STATUS_ERROR_IO_ERROR Failed to access DB
@@ -957,11 +924,10 @@ extern int dynamicbox_service_enumerate_cluster_list(int (*cb)(const char *clust
* using this, initate the dynamicbox service is more benefical to you.\n
* This API will prepare the DB operation, if you don't initiate the dynamicbox service,
* every API which are related with DB operation will open DB and close it before return from it.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval #DBOX_STATUS_ERROR_NONE Succeed to initialize
* @retval #DBOX_STATUS_ERROR_IO_ERROR Failed to access a DB
@@ -973,11 +939,10 @@ extern int dynamicbox_service_init(void);
/**
* @internal
* @brief Finalizes the dynamicbox service API.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval #DBOX_STATUS_ERROR_NONE Succeed to finalize
* @retval #DBOX_STATUS_ERROR_IO_ERROR Failed to close the DB (access failed to DB)
@@ -996,16 +961,15 @@ extern int dynamicbox_service_fini(void);
* Then you can get the records one by one, but there is no backward iterator.\n
* You can only get a forward iterator.\n
* After calling this function the iterator will be moved to the next record automatically.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @remarks
* If you call this function again using created pkglist handle, it will be reset.
* So you can get records from the first one again.
* @param[in] dboxid Dynamicbox AppId
* @param[in] handle @c NULL if you call this first, or it will be reset
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return handle
* @retval @c NULL If it fails, dynamicbox_last_status() will returns reason of failure if it fails.
* @retval handle If it successfully create the package list iterator
@@ -1016,15 +980,14 @@ extern dynamicbox_pkglist_h dynamicbox_service_pkglist_create(const char *dboxid
/**
* @internal
* @brief Gets the dboxid & package name & is_prime flag.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] handle Handle which is created by dynamicbox_service_pkglist_create() function
* @param[out] dboxid Dynamicbox Id
* @param[out] pkgname Package Id which includes dynamicboxes
* @param[out] is_prime If the returned dboxid is primary, this will be 1 or 0
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval #DBOX_STATUS_ERROR_NONE Successfully get the record
* @retval #DBOX_STATUS_ERROR_INVALID_PARAMETER Invalid argument
@@ -1039,12 +1002,11 @@ extern int dynamicbox_service_get_pkglist_item(dynamicbox_pkglist_h handle, char
/**
* @internal
* @brief Destroys the iterator of pkglist.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] handle Package list handle
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval #DBOX_STATUS_ERROR_INVALID_PARAMETER Invalid handle
* @retval #DBOX_STATUS_ERROR_NONE Successfully destroyed
@@ -1057,14 +1019,13 @@ extern int dynamicbox_service_pkglist_destroy(dynamicbox_pkglist_h handle);
/**
* @internal
* @brief Getting the activated instance count.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox Id, if you want to get whole instnaces list, use NULL.
* @param[in] cluster Cluster name if you don't know what this is, use NULL.
* @param[in] category Sub-cluster(category) name if you don't know what this is, use NULL.
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return count of instances
* @retval #DBOX_STATUS_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DBOX_STATUS_ERROR_FAULT Unrecorvarable error occurred
@@ -1075,12 +1036,11 @@ extern int dynamicbox_service_get_instance_count(const char *dboxid, const char
/**
* @internal
* @brief Gets the path of the plug-in module.
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @param[in] dboxid Dynamicbox AppId
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return char * type
* @retval path String which is allocated on the heap
* @retval @c NULL No libexec attribute, or dynamicbox_last_status() will returns reason of failure if it fails.
@@ -1092,13 +1052,12 @@ extern char *dynamicbox_service_libexec(const char *dboxid);
* @internal
* @brief Find the lbid using its libexec
* @details only if the dynamicbox should use the "libexec" attribute in its "<dynamicbox>" tag
- * @since_tizen 2.3
+ * @since_tizen 2.4
* @remarks Only usable for inhouse dynamicboxes
* @param[in] libexec so filename
* @privlevel public
- * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
- * @feature http://developer.samsung.com/tizen/feature/samsung_extension
- * @feature http://developer.samsung.com/tizen/feature/in_house/shell.appwidget
+ * @privilege %http://tizen.org/privilege/dynamicbox.viewer
+ * @feature http://tizen.org/feature/shell.appwidget
* @return char *
* @retval @c NULL if it fails to get pkgname, dynamicbox_last_status() will returns reason of failure.
* @retval address heap address of pkgname