*/
/**
+ * @internal
* @brief Definition for COLOR BLOCK.
* @since_tizen 2.3
*/
#define DBOX_DESC_TYPE_COLOR "color"
/**
+ * @internal
* @brief Definition for TEXT BLOCK.
* @since_tizen 2.3
*/
#define DBOX_DESC_TYPE_TEXT "text"
/**
+ * @internal
* @brief Definition for IMAGE BLOCK.
* @since_tizen 2.3
*/
#define DBOX_DESC_TYPE_IMAGE "image"
/**
+ * @internal
* @brief Definition for SIGNAL BLOCK.
* @since_tizen 2.3
*/
#define DBOX_DESC_TYPE_SIGNAL "signal"
/**
+ * @internal
* @brief Definition for INFO BLOCK.
* @since_tizen 2.3
*/
#define DBOX_DESC_TYPE_INFO "info"
/**
+ * @internal
* @brief Definition for DRAG BLOCK.
* @since_tizen 2.3
*/
#define DBOX_DESC_TYPE_DRAG "drag"
/**
+ * @internal
* @brief Definition for SCRIPT SCRIPT.
* @since_tizen 2.3
*/
#define DBOX_DESC_TYPE_SCRIPT "script"
/**
+ * @internal
* @brief Definition for ACCESSIBILITY INFORMATION BLOCK.
* @since_tizen 2.3
*/
#define DBOX_DESC_TYPE_ACCESS "access"
/**
+ * @internal
* @brief Definition for accessibility operation.
* @since_tizen 2.3
*/
#define DBOX_DESC_TYPE_ACCESS_OPERATION "access,operation"
/**
+ * @internal
* @brief Definition for set highlight on specified part.
* @since_tizen 2.3
*/
#define DBOX_DESC_DATA_ACCESS_OPERATION_HL_SET "set,hl"
/**
+ * @internal
* @brief Definition for remove highlight from specified part.
* @since_tizen 2.3
*/
#define DBOX_DESC_DATA_ACCESS_OPERATION_HL_UNSET "unset,hl"
/**
+ * @internal
* @brief Definition for move the highlight to next part.
* @since_tizen 2.3
*/
#define DBOX_DESC_DATA_ACCESS_OPERATION_HL_NEXT "next,hl"
/**
+ * @internal
* @brief Definition for move the highlight to previous part.
* @since_tizen 2.3
*/
#define DBOX_DESC_DATA_ACCESS_OPERATION_HL_PREV "prev,hl"
/**
+ * @internal
* @brief Definition for reset the chain of accessibility highlight list.
* @since_tizen 2.3
*/
#define DBOX_DESC_DATA_ACCESS_OPERATION_RESET "reset,focus"
/**
+ * @internal
* @brief Definition for specify the highlight move option.
* @details If the highlight list reaches to the last object, move back to the first object.
* @since_tizen 2.3
#define DBOX_DESC_OPTION_ACCESS_HL_LOOP "cycle"
/**
+ * @internal
* @brief Definition for specify the highlight move option.
* @details If the highlight list reaches to the last object(or the first object),
* the "prev,hl", "next,hl" will be failed.
#define DBOX_DESC_OPTION_ACCESS_HL_NOLOOP "no,cycle"
/**
+ * @internal
* @brief Dynamic Box description data handle.
* @since_tizen 2.3
*/
typedef void (*dynamicbox_flush_cb)(void *snapshot_window, const char *id, int status, void *data);
/**
+ * @internal
* @brief Updates a description file.
* @since_tizen 2.3
* @remarks Must be used only by Inhouse Dynamic Box.
extern dynamicbox_desc_h dynamicbox_desc_open(const char *id, int gbar);
/**
+ * @internal
* @brief Completes the description file update.
* @details Only if this API is called, the description data will be applied to the content of Dynamic Box (or GBar).
* @since_tizen 2.3
extern int dynamicbox_desc_close(dynamicbox_desc_h handle);
/**
+ * @internal
* @brief Sets the category information of current description data.
* @details Creates a new description block for updating category information of layout object.
* @since_tizen 2.3
extern int dynamicbox_desc_set_category(dynamicbox_desc_h handle, const char *id, const char *category);
/**
+ * @internal
* @brief Sets the content size.
* @details Sets the content size of layout.
* @since_tizen 2.3
extern int dynamicbox_desc_set_size(dynamicbox_desc_h handle, const char *id, int w, int h);
/**
+ * @internal
* @brief Sets the target id of the given block.
* @details Only available for the script block.
* @since_tizen 2.3
extern int dynamicbox_desc_set_id(dynamicbox_desc_h handle, int idx, const char *id);
/**
+ * @internal
* @brief Adds a new block.
* @since_tizen 2.3
* @param[in] handle Handle which is created by the dynamicbox_desc_open() function
extern int dynamicbox_desc_add_block(dynamicbox_desc_h handle, const char *id, const char *type, const char *part, const char *data, const char *option);
/**
+ * @internal
* @brief Deletes an added block.
* @since_tizen 2.3
* @details If you discard the added desc block, use this API and the index of the created desc block.
* @param[in] gbar 1 if this object is created for Glance Bar or 0 (for Dynamic Box)
* @privlevel public
* @privilege %http://tizen.org/privilege/core/dynamicbox
+ * @feature http://developer.samsung.com/tizen/feature/samsung_extension
+ * @feature http://tizen.org/feature/shell.appwidget
* @return void* Object type
* @retval Address Valid evas object
* @retval @c NULL failed to create
* @param[in] icon Path of icon image file - alternative image content
* @param[in] name Name of a box - alternative text content
* @return int type
+ * @feature http://developer.samsung.com/tizen/feature/samsung_extension
+ * @feature http://tizen.org/feature/shell.appwidget
* @retval #DBOX_STATUS_ERROR_OUT_OF_MEMORY Out of memory
* @retval #DBOX_STATUS_ERROR_INVALID_PARAMETER Invalid parameters
* @retval #DBOX_STATUS_ERROR_FAULT Unrecoverable error
typedef struct dynamicbox_buffer *dynamicbox_buffer_h;
/**
- * @internal
* @brief Return values of dynamicbox programming interfaces: Operation is successfully done.
* @since_tizen 2.3
*/
extern const int DBOX_DONE;
/**
- * @internal
* @brief Return values of dynamicbox programming interfaces: Contents are updated.
* @since_tizen 2.3
*/
extern const int DBOX_OUTPUT_UPDATED;
/**
- * @internal
* @brief Return values of dynamicbox programming interfaces: Need to call the dynamicbox_need_to_update and dynamicbox_update_content.
* @since_tizen 2.3
*/
extern const int DBOX_NEED_TO_SCHEDULE;
/**
- * @internal
* @brief Return values of dynamicbox programming interfaces: Need to do force update.
* @since_tizen 2.3
*/
extern const int DBOX_NEED_TO_CREATE;
/**
- * @internal
* @brief Return values of dynamicbox programming interfaces: Need to destroy this instance.
* @since_tizen 2.3
*/
extern const int DBOX_NEED_TO_DESTROY;
/**
- * @internal
* @brief Return values of dynamicbox programming interfaces: Need to update.
* @since_tizen 2.3
*/
extern const int DBOX_USE_NET;
/**
- * @internal
* @brief System event type: System font is changed.
* @since_tizen 2.3
*/
extern const int DBOX_SYS_EVENT_FONT_CHANGED;
/**
- * @internal
* @brief System event type: System language is changed.
* @since_tizen 2.3
*/
extern const int DBOX_SYS_EVENT_LANG_CHANGED;
/**
- * @internal
* @brief System event type: System time is changed.
* @since_tizen 2.3
*/
extern const int DBOX_SYS_EVENT_TIME_CHANGED;
/**
- * @internal
* @brief System event type: Region changed.
* @since_tizen 2.3
*/
extern const int DBOX_SYS_EVENT_REGION_CHANGED;
/**
- * @internal
* @brief System event type: Accessibility mode changed.
* @since_tizen 2.3
*/
extern const int DBOX_SYS_EVENT_TTS_CHANGED;
/**
- * @internal
* @brief System event type: Dynamic Box is paused.
* @since_tizen 2.3
*/
extern const int DBOX_SYS_EVENT_PAUSED;
/**
- * @internal
* @brief System event type: Dynamic Box is resumed.
* @since_tizen 2.3
*/
extern const int DBOX_SYS_EVENT_MMC_STATUS_CHANGED;
/**
- * @internal
* @brief System event type: Dynamic Box instance is removed from a viewer.
* @since_tizen 2.3
*/
extern int dynamicbox_sync_buffer(dynamicbox_buffer_h handle);
/**
- * @internal
* @brief Requests to schedule the update operation to a provider.
* Your DBox will get the update request, if the @a id is specified, specific box only will get it.
* @since_tizen 2.3
extern int dynamicbox_request_close_glance_bar(const char *dboxid, const char *id, int reason);
/**
- * @internal
* @brief Send a freeze request to the viewer (homescreen)
* @details
* The viewer will get this request via event callback.
* @param[in] id Instance Id which is passed to you via the first parameter of every dynamicbox_XXXX interface functions
* @privlevel public
* @privilege %http://tizen.org/privilege/core/dynamicbox
+ * @feature http://developer.samsung.com/tizen/feature/samsung_extension
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval #DBOX_STATUS_ERROR_INVALID_PARAMETER Invalid parameters
* @retval #DBOX_STATUS_ERROR_OUT_OF_MEMORY Out of memory
extern int dynamicbox_freeze_scroller(const char *dboxid, const char *id);
/**
- * @internal
* @brief Send a release request to the viewer (homescreen)
* @details
* The viewer will get this request via event callback.
* @param[in] id Instance Id which is passed to you via the first parameter of every dynamicbox_XXXX interface functions
* @privlevel public
* @privilege %http://tizen.org/privilege/core/dynamicbox
+ * @feature http://developer.samsung.com/tizen/feature/samsung_extension
+ * @feature http://tizen.org/feature/shell.appwidget
* @return int type
* @retval #DBOX_STATUS_ERROR_INVALID_PARAMETER Invalid parameters
* @retval #DBOX_STATUS_ERROR_OUT_OF_MEMORY Out of memory