* @param[in] content The data set for the previous status
* @param[in] w The pixel value for widget width
* @param[in] h The pixel value for widget height
- * @param[in] user_data The user data passed from widget_app_class_create function
+ * @param[in] user_data The user data passed from widget_app_class_create() function
*
* @return #WIDGET_ERROR_NONE on success,
* otherwise an error code (see WIDGET_ERROR_XXX) on failure
* As a input parameter, content contains the saved status of the widget instance.
* You can fill the content parameter with the current status in this callback,
* then the framework will save the content by receiving it as a output parameter.
- * Consequently, you should not use widget_app_context_set_content_info() api in this callback.
+ * Consequently, you should not use widget_app_context_set_content_info() function in this callback.
* The content will be overwritten after this callback returns with the 'content' parameter.
* @param[in] context The context of widget instance
* @param[in] reason The reason for destruction
* @param[in,out] content The data set to save
- * @param[in] user_data The user data passed from widget_app_class_create function
+ * @param[in] user_data The user data passed from widget_app_class_create() function
* @return #WIDGET_ERROR_NONE on success,
* otherwise an error code (see WIDGET_ERROR_XXX) on failure
*/
* The paused instance may be destroyed by framework.
* @since_tizen 2.3.1
* @param[in] context The context of widget instance
- * @param[in] user_data The user data passed from widget_app_class_create function
+ * @param[in] user_data The user data passed from widget_app_class_create() function
* @return #WIDGET_ERROR_NONE on success,
* otherwise an error code (see WIDGET_ERROR_XXX) on failure
*/
* @details The callback function is called when the widget is visible.
* @since_tizen 2.3.1
* @param[in] context The context of widget instance
- * @param[in] user_data The user data passed from widget_app_class_create function
+ * @param[in] user_data The user data passed from widget_app_class_create() function
* @return #WIDGET_ERROR_NONE on success,
* otherwise an error code (see WIDGET_ERROR_XXX) on failure
*/
* @param[in] context The context of widget instance
* @param[in] w The pixel value for widget width
* @param[in] h The pixel value for widget height
- * @param[in] user_data The user data passed from widget_app_class_create function
+ * @param[in] user_data The user data passed from widget_app_class_create() function
* @return #WIDGET_ERROR_NONE on success,
* otherwise an error code (see WIDGET_ERROR_XXX) on failure
*/
* @param[in] content The data set for updating this widget. It will be provided by requester.
* Requester can use widget_service_trigger_update()
* @param[in] force Although the widget is paused, if it is TRUE, the widget can be updated
- * @param[in] user_data The user data passed from widget_app_class_create function
+ * @param[in] user_data The user data passed from widget_app_class_create() function
* @return #WIDGET_ERROR_NONE on success,
* otherwise an error code (see WIDGET_ERROR_XXX) on failure
* @see widget_service_trigger_update()
/**
* @brief Called for each widget context.
- * @details This function will be called in the function of widget_app_foreach_context repeatedly.
+ * @details This function will be called in the function of widget_app_foreach_context() repeatedly.
* @since_tizen 2.3.1
* @param[in] context The context for widget instance
- * @param[in] data The data for caller
+ * @param[in] user_data The data for caller
* @return @c true to continue with the next iteration of the loop,
* otherwise @c false to break out of the loop
* @see widget_app_foreach_context()
*/
-typedef bool (*widget_context_cb)(widget_context_h context, void *data);
+typedef bool (*widget_context_cb)(widget_context_h context, void *user_data);
/**
* @return #WIDGET_ERROR_NONE on success,
* otherwise an error code (see WIDGET_ERROR_XXX) on failure
* @retval #WIDGET_ERROR_NONE Successful
- * @retval #WIDGET_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #WIDGET_ERROR_NOT_SUPPORTED Not supported
+ * @retval #WIDGET_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #WIDGET_ERROR_FAULT Unrecoverable error
* @see widget_app_exit()
*/
* @return #WIDGET_ERROR_NONE on success,
* otherwise an error code (see WIDGET_ERROR_XXX) on failure
* @retval #WIDGET_ERROR_NONE Successful
- * @retval #WIDGET_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #WIDGET_ERROR_NOT_SUPPORTED Not supported
+ * @retval #WIDGET_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #WIDGET_ERROR_FAULT Unrecoverable error
*/
int widget_app_terminate_context(widget_context_h context);
* @return #WIDGET_ERROR_NONE on success,
* otherwise an error code (see WIDGET_ERROR_XXX) on failure
* @retval #WIDGET_ERROR_NONE Successful
+ * @retval #WIDGET_ERROR_NOT_SUPPORTED Not supported
* @retval #WIDGET_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #WIDGET_ERROR_CANCELED The iteration is canceled
- * @retval #WIDGET_ERROR_NOT_SUPPORTED Not supported
* @retval #WIDGET_ERROR_FAULT Unrecoverable error
- * @see widget_app_foreach_context()
+ * @see widget_context_cb()
*/
int widget_app_foreach_context(widget_context_cb callback, void *data);
* @return #WIDGET_ERROR_NONE on success,
* otherwise an error code (see WIDGET_ERROR_XXX) on failure
* @retval #WIDGET_ERROR_NONE Successful
+ * @retval #WIDGET_ERROR_NOT_SUPPORTED Not supported
* @retval #WIDGET_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #WIDGET_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #WIDGET_ERROR_NOT_SUPPORTED Not supported
* @retval #WIDGET_ERROR_FAULT Unrecoverable error
* @see app_event_type_e
* @see app_event_cb()
* @return #WIDGET_ERROR_NONE on success,
* otherwise an error code (see WIDGET_ERROR_XXX) on failure
* @retval #WIDGET_ERROR_NONE Successful
- * @retval #WIDGET_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #WIDGET_ERROR_NOT_SUPPORTED Not supported
+ * @retval #WIDGET_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #WIDGET_ERROR_FAULT Unrecoverable error
* @see widget_app_add_event_handler()
*/
* @param[in] context The context for widget instance
* @return widget instance id on success,
* otherwise NULL
+ * @exception #WIDGET_ERROR_NONE Successful
* @exception #WIDGET_ERROR_NOT_SUPPORTED Not supported
+ * @exception #WIDGET_ERROR_INVALID_PARAMETER Invalid parameter
* @exception #WIDGET_ERROR_FAULT Unrecoverable error
* @see get_last_result()
* @see widget_service_trigger_update()
* @return The new widget class object,
* NULL on error
* @exception #WIDGET_ERROR_NONE Successfully added
- * @exception #WIDGET_ERROR_INVALID_PARAMETER Invalid parameter
* @exception #WIDGET_ERROR_NOT_SUPPORTED Not supported
+ * @exception #WIDGET_ERROR_INVALID_PARAMETER Invalid parameter
* @exception #WIDGET_ERROR_OUT_OF_MEMORY Out of memory
* @see get_last_result()
*/
* @param[in] tag The value to save
* @return #WIDGET_ERROR_NONE on success,
* otherwise an error code (see WIDGET_ERROR_XXX) on failure
+ * @retval #WIDGET_ERROR_NONE Successful
* @retval #WIDGET_ERROR_NOT_SUPPORTED Not supported
* @retval #WIDGET_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #WIDGET_ERROR_FAULT Unrecoverable error
* @param[out] tag The value to get
* @return #WIDGET_ERROR_NONE on success,
* otherwise an error code (see WIDGET_ERROR_XXX) on failure
+ * @retval #WIDGET_ERROR_NONE Successful
* @retval #WIDGET_ERROR_NOT_SUPPORTED Not supported
* @retval #WIDGET_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #WIDGET_ERROR_FAULT Unrecoverable error
* @return #WIDGET_ERROR_NONE on success,
* otherwise an error code (see WIDGET_ERROR_XXX) on failure
* @retval #WIDGET_ERROR_NONE Successfully sent
- * @retval #WIDGET_ERROR_INVALID_PARAMETER Invalid argument
* @retval #WIDGET_ERROR_NOT_SUPPORTED Not supported
+ * @retval #WIDGET_ERROR_INVALID_PARAMETER Invalid argument
* @retval #WIDGET_ERROR_OUT_OF_MEMORY Out of memory
* @retval #WIDGET_ERROR_FAULT Unrecoverable error
*/
* @return #WIDGET_ERROR_NONE on success,
* otherwise an error code (see WIDGET_ERROR_XXX) on failure
* @retval #WIDGET_ERROR_NONE Successfully sent
- * @retval #WIDGET_ERROR_INVALID_PARAMETER Invalid argument
* @retval #WIDGET_ERROR_NOT_SUPPORTED Not supported
+ * @retval #WIDGET_ERROR_INVALID_PARAMETER Invalid argument
* @retval #WIDGET_ERROR_OUT_OF_MEMORY Out of memory
* @retval #WIDGET_ERROR_FAULT Unrecoverable error
*/
* @return The new widget class object,
* NULL on error
* @exception #WIDGET_ERROR_NONE Successfully added
- * @exception #WIDGET_ERROR_INVALID_PARAMETER Invalid parameter
* @exception #WIDGET_ERROR_NOT_SUPPORTED Not supported
+ * @exception #WIDGET_ERROR_INVALID_PARAMETER Invalid parameter
* @exception #WIDGET_ERROR_OUT_OF_MEMORY Out of memory
* @see get_last_result()
*/