summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authormk5004.lee <mk5004.lee@samsung.com>2019-01-09 15:32:38 +0900
committermk5004.lee <mk5004.lee@samsung.com>2019-01-09 16:45:18 +0900
commit1148664c50da8f0344426f3889c9d6445ddb6dc8 (patch)
treedd89ac70b6b15879406dcd25257b936e774ed007
parent17820ebcebaf98df77e0ac27405e36edbe0f9c49 (diff)
downloadnotification-1148664c50da8f0344426f3889c9d6445ddb6dc8.tar.gz
notification-1148664c50da8f0344426f3889c9d6445ddb6dc8.tar.bz2
notification-1148664c50da8f0344426f3889c9d6445ddb6dc8.zip
Check coding style
Change-Id: I0a11b220919abae84f270b7b616e5c4df3661806 Signed-off-by: mk5004.lee <mk5004.lee@samsung.com>
-rw-r--r--include/notification_internal.h408
1 files changed, 178 insertions, 230 deletions
diff --git a/include/notification_internal.h b/include/notification_internal.h
index d642728..84de388 100644
--- a/include/notification_internal.h
+++ b/include/notification_internal.h
@@ -62,12 +62,10 @@ int notification_del_deferred_task(
* @brief This function will be removed.
* @see notification_register_detailed_changed_cb()
*/
-int
-notification_resister_changed_cb(
+int notification_resister_changed_cb(
void (*changed_cb)(void *data, notification_type_e type),
void *user_data);
-int
-notification_resister_changed_cb_for_uid(
+int notification_resister_changed_cb_for_uid(
void (*changed_cb)(void *data, notification_type_e type),
void *user_data, uid_t uid);
@@ -75,11 +73,9 @@ notification_resister_changed_cb_for_uid(
* @brief This function will be removed.
* @see notification_unregister_detailed_changed_cb()
*/
-int
-notification_unresister_changed_cb(
+int notification_unresister_changed_cb(
void (*changed_cb)(void *data, notification_type_e type));
-int
-notification_unresister_changed_cb_for_uid(
+int notification_unresister_changed_cb_for_uid(
void (*changed_cb)(void *data, notification_type_e type), uid_t uid);
/**
@@ -89,9 +85,9 @@ notification_unresister_changed_cb_for_uid(
* @param[in] noti Notification handle or NULL if priv_id is valid
* @param[in] priv_id Private ID
* @param[in] progress Percentage value of progressive data
- * @return NOTIFICATION_ERROR_NONE on success, other value on failure
- * @retval NOTIFICATION_ERROR_NONE Success
- * @retval NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
+ * @return #NOTIFICATION_ERROR_NONE on success, other value on failure
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
* @par Sample code:
* @code
#include <notification_internal.h>
@@ -106,9 +102,7 @@ notification_unresister_changed_cb_for_uid(
}
* @endcode
*/
-int notification_update_progress(notification_h noti,
- int priv_id,
- double progress);
+int notification_update_progress(notification_h noti, int priv_id, double progress);
/**
* @brief Updates the size of inserted notification data. This only works for the ongoing notification (NOTIFICATION_TYPE_ONGOING).
@@ -117,9 +111,9 @@ int notification_update_progress(notification_h noti,
* @param[in] noti Notification handle or NULL if priv_id is valid
* @param[in] priv_id Private ID
* @param[in] size Bytes of progressive data
- * @return NOTIFICATION_ERROR_NONE if success, other value if failure
- * @retval NOTIFICATION_ERROR_NONE Success
- * @retval NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
+ * @return #NOTIFICATION_ERROR_NONE if success, other value if failure
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
* @par Sample code:
* @code
#include <notification_internal.h>
@@ -134,8 +128,7 @@ int notification_update_progress(notification_h noti,
}
* @endcode
*/
-int notification_update_size(notification_h noti,
- int priv_id, double size);
+int notification_update_size(notification_h noti, int priv_id, double size);
/**
* @brief Updates the content of the inserted notification data. This is only for the ongoing notification (NOTIFICATION_TYPE_ONGOING).
@@ -144,9 +137,9 @@ int notification_update_size(notification_h noti,
* @param[in] noti Notification handle or NULL if priv_id is valid
* @param[in] priv_id Private ID
* @param[in] content Text to update
- * @return NOTIFICATION_ERROR_NONE on success, other value on failure
- * @retval NOTIFICATION_ERROR_NONE Success
- * @retval NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
+ * @return #NOTIFICATION_ERROR_NONE on success, other value on failure
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
* @par Sample code:
* @code
#include <notification_internal.h>
@@ -161,131 +154,95 @@ int notification_update_size(notification_h noti,
}
* @endcode
*/
-int notification_update_content(notification_h noti,
- int priv_id,
- const char *content);
+int notification_update_content(notification_h noti, int priv_id, const char *content);
/**
* @brief This function will be deprecated.
* @see notification_set_image()
- *
*/
-NOTIFICATION_DEPRECATED_API int notification_set_icon(notification_h noti,
- const char *icon_path);
+int notification_set_icon(notification_h noti, const char *icon_path) NOTIFICATION_DEPRECATED_API;
/**
* @brief This function will be deprecated.
* @see notification_get_image()
- *
*/
-NOTIFICATION_DEPRECATED_API int notification_get_icon(notification_h noti,
- char **icon_path);
+int notification_get_icon(notification_h noti, char **icon_path) NOTIFICATION_DEPRECATED_API;
/**
* @brief This function will be deprecated.
* @see notification_set_text()
- *
*/
-NOTIFICATION_DEPRECATED_API int notification_set_title(notification_h noti,
- const char *title,
- const char *loc_title);
+int notification_set_title(notification_h noti, const char *title, const char *loc_title) NOTIFICATION_DEPRECATED_API;
/**
* @brief This function will be deprecated.
* @see notification_get_text()
- *
*/
-NOTIFICATION_DEPRECATED_API int notification_get_title(notification_h noti,
- char **title,
- char **loc_title);
+int notification_get_title(notification_h noti, char **title, char **loc_title) NOTIFICATION_DEPRECATED_API;
/**
* @brief This function will be deprecated.
* @see notification_set_text()
- *
*/
-NOTIFICATION_DEPRECATED_API int notification_set_content(notification_h noti,
- const char *content,
- const char *loc_content);
+int notification_set_content(notification_h noti, const char *content, const char *loc_content) NOTIFICATION_DEPRECATED_API;
/**
* @brief This function will be deprecated.
* @see notification_get_text()
- *
*/
-NOTIFICATION_DEPRECATED_API int notification_get_content(notification_h noti,
- char **content,
- char **loc_content);
+int notification_get_content(notification_h noti, char **content, char **loc_content) NOTIFICATION_DEPRECATED_API;
/**
* @brief This function will be removed.
* @see notification_set_execute_option()
- *
*/
-NOTIFICATION_DEPRECATED_API int notification_set_application(notification_h noti, const char *app_id); /* Do not use this */
+int notification_set_application(notification_h noti, const char *app_id) NOTIFICATION_DEPRECATED_API;
/**
* @brief This function will be removed.
* @see notification_get_execute_option()
- *
*/
-NOTIFICATION_DEPRECATED_API int notification_get_application(notification_h noti, char **app_id); /* Do not use this */
+int notification_get_application(notification_h noti, char **app_id) NOTIFICATION_DEPRECATED_API;
/**
* @brief This function will be deprecated.
* @see notification_set_execute_option()
- *
*/
-NOTIFICATION_DEPRECATED_API int notification_set_args(notification_h noti, bundle *args, bundle *group_args); /* Do not use this */
+int notification_set_args(notification_h noti, bundle *args, bundle *group_args) NOTIFICATION_DEPRECATED_API;
/**
* @brief This function will be deprecated.
* @see notification_get_execute_option()
- *
*/
-NOTIFICATION_DEPRECATED_API int notification_get_args(notification_h noti, bundle **args, bundle **group_args); /* Do not use this */
+int notification_get_args(notification_h noti, bundle **args, bundle **group_args) NOTIFICATION_DEPRECATED_API;
/**
* @brief This function is deprecated.
* @see notification_get_grouping_list()
- *
*/
-NOTIFICATION_DEPRECATED_API int notification_get_grouping_list(notification_type_e type,
- int count,
- notification_list_h *list);
+int notification_get_grouping_list(notification_type_e type, int count, notification_list_h *list) NOTIFICATION_DEPRECATED_API;
/**
* @brief This function will be deprecated.
* @see notification_delete_by_priv_id()
- *
*/
-NOTIFICATION_DEPRECATED_API int notification_delete_group_by_group_id(const char *app_id,
- notification_type_e type,
- int group_id);
+int notification_delete_group_by_group_id(const char *app_id, notification_type_e type, int group_id) NOTIFICATION_DEPRECATED_API;
/**
* @brief This function will be deprecated.
* @see notification_delete_by_priv_id()
- *
*/
-NOTIFICATION_DEPRECATED_API int notification_delete_group_by_priv_id(const char *app_id,
- notification_type_e type,
- int priv_id);
+int notification_delete_group_by_priv_id(const char *app_id, notification_type_e type, int priv_id) NOTIFICATION_DEPRECATED_API;
/**
* @brief This function will be deprecated.
- *
*/
-NOTIFICATION_DEPRECATED_API int notifiation_clear(notification_type_e type);
+int notifiation_clear(notification_type_e type) NOTIFICATION_DEPRECATED_API;
/**
* @brief This function will be deprecated.
- *
*/
-NOTIFICATION_DEPRECATED_API int notification_get_count(notification_type_e type,
- const char *app_id,
- int group_id, int priv_id,
- int *count);
+int notification_get_count(notification_type_e type, const char *app_id, int group_id, int priv_id, int *count) NOTIFICATION_DEPRECATED_API;
/**
* @internal
@@ -293,12 +250,12 @@ NOTIFICATION_DEPRECATED_API int notification_get_count(notification_type_e type,
* @since tizen 4.0
* @param[in] type The type of notification
* @param[out] count The numbers of all notifications
- * @return NOTIFICATION_ERROR_NONE on success, other value on failure
- * @retval NOTIFICATION_ERROR_NONE Success
- * @retval NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
- * @retval NOTIFICATION_ERROR_IO_ERROR I/O Error
- * @retval NOTIFICATION_ERROR_FROM_DB Error from DB
- * @retval NOTIFICATION_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
+ * @return #NOTIFICATION_ERROR_NONE on success, other value on failure
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
+ * @retval #NOTIFICATION_ERROR_IO_ERROR I/O Error
+ * @retval #NOTIFICATION_ERROR_FROM_DB Error from DB
+ * @retval #NOTIFICATION_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
*/
int notification_get_all_count(notification_type_e type, int *count);
int notification_get_all_count_for_uid(notification_type_e type, int *count, uid_t uid);
@@ -308,9 +265,9 @@ int notification_get_all_count_for_uid(notification_type_e type, int *count, uid
* @brief This function will be deprecated.
* @details Use only for the notification tray's clear button operation.
* @param[in] type Notification type
- * @return NOTIFICATION_ERROR_NONE on success, other value on failure
- * @retval NOTIFICATION_ERROR_NONE Success
- * @retval NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
+ * @return #NOTIFICATION_ERROR_NONE on success, other value on failure
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
* @see #notification_type_e
* @par Sample code:
* @code
@@ -326,35 +283,32 @@ int notification_get_all_count_for_uid(notification_type_e type, int *count, uid
}
* @endcode
*/
-NOTIFICATION_DEPRECATED_API int notification_clear(notification_type_e type);
+int notification_clear(notification_type_e type) NOTIFICATION_DEPRECATED_API;
/**
* @internal
* @brief This function will be deprecated.
* @return 1 on ready, other value on not ready
*/
-NOTIFICATION_DEPRECATED_API int notification_is_service_ready(void);
+int notification_is_service_ready(void) NOTIFICATION_DEPRECATED_API;
/**
* @internal
* @brief This function will be deprecated.
* @param[in] list Notification list handle
- * @return NOTIFICATION_ERROR_NONE on success, other value on failure
- * @retval NOTIFICATION_ERROR_NONE Success
- * @retval NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
+ * @return #NOTIFICATION_ERROR_NONE on success, other value on failure
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @pre notification_get_grouping_list() or notification_get_detail_list().
* @see #notification_op
*/
-NOTIFICATION_DEPRECATED_API int notification_op_get_data(notification_op *noti_op,
- notification_op_data_type_e type,
- void *data);
+int notification_op_get_data(notification_op *noti_op, notification_op_data_type_e type, void *data) NOTIFICATION_DEPRECATED_API;
/**
* @brief This function will be deprecated.
* @see notification_set_app_id()
*/
-NOTIFICATION_DEPRECATED_API int notification_set_pkgname(notification_h noti,
- const char *pkgname);
+int notification_set_pkgname(notification_h noti, const char *pkgname) NOTIFICATION_DEPRECATED_API;
/**
* @internal
@@ -363,9 +317,9 @@ NOTIFICATION_DEPRECATED_API int notification_set_pkgname(notification_h noti,
* @since_tizen 4.0
* @param[in] noti Notification handle
* @param[in] app_id Caller application id
- * @return NOTIFICATION_ERROR_NONE on success, other value on failure
- * @retval NOTIFICATION_ERROR_NONE Success
- * @retval NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
+ * @return #NOTIFICATION_ERROR_NONE on success, other value on failure
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
* @par Sample code:
* @code
#include <notification.h>
@@ -395,9 +349,9 @@ int notification_set_app_id(notification_h noti, const char *app_id);
* @details If @a app_id is NULL, caller_app_id is set internally.
* @param[in] app_id Caller application ID or NULL
* @param[in] type Notification type
- * @return NOTIFICATION_ERROR_NONE if success, other value if failure
- * @retval NOTIFICATION_ERROR_NONE Success
- * @retval NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
+ * @return #NOTIFICATION_ERROR_NONE if success, other value if failure
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
* @par Sample code:
* @code
#include <notification.h>
@@ -412,8 +366,7 @@ int notification_set_app_id(notification_h noti, const char *app_id);
}
* @endcode
*/
-NOTIFICATION_DEPRECATED_API int notification_delete_all_by_type(const char *app_id,
- notification_type_e type);
+int notification_delete_all_by_type(const char *app_id, notification_type_e type) NOTIFICATION_DEPRECATED_API;
/**
* @internal
@@ -422,9 +375,9 @@ NOTIFICATION_DEPRECATED_API int notification_delete_all_by_type(const char *app_
* @param[in] app_id Caller application ID or NULL
* @param[in] type Notification type
* @param[in] priv_id Priv ID
- * @return NOTIFICATION_ERROR_NONE if success, other value if failure
- * @retval NOTIFICATION_ERROR_NONE Success
- * @retval NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
+ * @return #NOTIFICATION_ERROR_NONE if success, other value if failure
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
* @par Sample code:
* @code
#include <notification.h>
@@ -439,9 +392,7 @@ NOTIFICATION_DEPRECATED_API int notification_delete_all_by_type(const char *app_
}
* @endcode
*/
-NOTIFICATION_DEPRECATED_API int notification_delete_by_priv_id(const char *app_id,
- notification_type_e type,
- int priv_id);
+int notification_delete_by_priv_id(const char *app_id, notification_type_e type, int priv_id) NOTIFICATION_DEPRECATED_API;
/**
* @internal
@@ -452,9 +403,9 @@ NOTIFICATION_DEPRECATED_API int notification_delete_by_priv_id(const char *app_i
* @param[in] text Basic text for button
* @param[in] key Value for localized text
* @param[in] service_handle Appsvc bundle data
- * @return NOTIFICATION_ERROR_NONE on success, other value on failure
- * @retval NOTIFICATION_ERROR_NONE Success
- * @retval NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
+ * @return #NOTIFICATION_ERROR_NONE on success, other value on failure
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @par Sample code:
* @code
#include <notification.h>
@@ -480,11 +431,11 @@ NOTIFICATION_DEPRECATED_API int notification_delete_by_priv_id(const char *app_i
}
* @endcode
*/
-NOTIFICATION_DEPRECATED_API int notification_set_execute_option(notification_h noti,
- notification_execute_type_e type,
- const char *text,
- const char *key,
- bundle *service_handle);
+int notification_set_execute_option(notification_h noti,
+ notification_execute_type_e type,
+ const char *text,
+ const char *key,
+ bundle *service_handle) NOTIFICATION_DEPRECATED_API;
/**
* @internal
@@ -493,9 +444,9 @@ NOTIFICATION_DEPRECATED_API int notification_set_execute_option(notification_h n
* @param[in] noti Notification handle
* @param[out] group_id Group ID
* @param[out] priv_id Private ID
- * @return NOTIFICATION_ERROR_NONE on success, other value on failure
- * @retval NOTIFICATION_ERROR_NONE Success
- * @retval NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
+ * @return #NOTIFICATION_ERROR_NONE on success, other value on failure
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @par Sample code:
* @code
#include <notification.h>
@@ -511,8 +462,7 @@ NOTIFICATION_DEPRECATED_API int notification_set_execute_option(notification_h n
}
* @endcode
*/
-NOTIFICATION_DEPRECATED_API int notification_get_id(notification_h noti,
- int *group_id, int *priv_id);
+int notification_get_id(notification_h noti, int *group_id, int *priv_id) NOTIFICATION_DEPRECATED_API;
/**
* @internal
@@ -520,9 +470,9 @@ NOTIFICATION_DEPRECATED_API int notification_get_id(notification_h noti,
* @since_tizen 4.0
* @param[in] noti Notification handle
* @param[in] priv_id Private ID
- * @return NOTIFICATION_ERROR_NONE on success, other value on failure
- * @retval NOTIFICATION_ERROR_NONE Success
- * @retval NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
+ * @return #NOTIFICATION_ERROR_NONE on success, other value on failure
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
*/
int notification_set_priv_id(notification_h noti, int priv_id);
@@ -552,8 +502,7 @@ int notification_set_priv_id(notification_h noti, int priv_id);
}
* @endcode
*/
-NOTIFICATION_DEPRECATED_API notification_h notification_load(char *app_id,
- int priv_id);
+notification_h notification_load(char *app_id, int priv_id) NOTIFICATION_DEPRECATED_API;
/**
* @internal
@@ -588,8 +537,8 @@ NOTIFICATION_DEPRECATED_API notification_h notification_load(char *app_id,
}
* @endcode
*/
-NOTIFICATION_DEPRECATED_API notification_h notification_new(notification_type_e type, int group_id,
- int priv_id);
+notification_h notification_new(notification_type_e type,
+ int group_id, int priv_id) NOTIFICATION_DEPRECATED_API;
/**
* @internal
@@ -598,9 +547,10 @@ NOTIFICATION_DEPRECATED_API notification_h notification_new(notification_type_e
* @param[in] type Notification execute type
* @param[out] text Text for button
* @param[out] service_handle Appsvc bundle data
- * @return NOTIFICATION_ERROR_NONE on success, other value on failure
- * @retval NOTIFICATION_ERROR_NONE Success
- * @retval NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
+ * @return #NOTIFICATION_ERROR_NONE on success,
+ * otherwise any other value on failure
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @par Sample code:
* @code
#include <notification.h>
@@ -620,10 +570,10 @@ NOTIFICATION_DEPRECATED_API notification_h notification_new(notification_type_e
}
* @endcode
*/
-NOTIFICATION_DEPRECATED_API int notification_get_execute_option(notification_h noti,
- notification_execute_type_e type,
- const char **text,
- bundle **service_handle);
+int notification_get_execute_option(notification_h noti,
+ notification_execute_type_e type,
+ const char **text,
+ bundle **service_handle) NOTIFICATION_DEPRECATED_API;
/**
* @internal
@@ -633,13 +583,13 @@ NOTIFICATION_DEPRECATED_API int notification_get_execute_option(notification_h n
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
- * @param[in] noti The notification handle
+ * @param[in] noti The notification handle
* @param[out] priv_id The private ID
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_NONE Success
* @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval NOTIFICATION_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
+ * @retval #NOTIFICATION_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
* @pre Notification handle should be created by notification_create().
* @post notification_free().
* @par Sample code:
@@ -667,12 +617,12 @@ int notification_insert_for_uid(notification_h noti, int *priv_id, uid_t uid);
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
* @remarks This function updates the notification asynchronously.
- * @param[in] noti The notification handle that is created by notification_create()
+ * @param[in] noti The notification handle that is created by notification_create()
* @param[in] result_cb The callback called when an update completed
* @param[in] user_data The user data which you want to use in callback
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_NONE Success
* @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
* @retval #NOTIFICATION_ERROR_NOT_EXIST_ID Priv ID does not exist
* @retval #NOTIFICATION_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
@@ -706,7 +656,7 @@ int notification_update_async_for_uid(notification_h noti,
* @param[in] user_data The user data
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_NONE Success
* @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #NOTIFICATION_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
* @see notification_unregister_detailed_changed_cb()
@@ -738,7 +688,7 @@ int notification_register_detailed_changed_cb_for_uid(
* @param[in] changed_cb The callback function
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_NONE Success
* @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #NOTIFICATION_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
* @see notification_register_detailed_changed_cb()
@@ -765,11 +715,11 @@ int notification_unregister_detailed_changed_cb_for_uid(
* @brief Sets the default button to display highlight on the notification.
* @since_tizen 3.0
* @remarks If you want to default button is off, you set that index is zero
- * @param[in] noti The notification handle
- * @param[in] index The notification button index
+ * @param[in] noti The notification handle
+ * @param[in] index The notification button index
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_NONE Success
* @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @pre Notification handle should be created by notification_create().
* @see #notification_button_index_e
@@ -797,16 +747,17 @@ int notification_unregister_detailed_changed_cb_for_uid(
}
* @endcode
*/
-int notification_set_default_button(notification_h noti, notification_button_index_e index);
+int notification_set_default_button(notification_h noti,
+ notification_button_index_e index);
/**
* @brief Gets the default button to display highlight on the notification.
* @since_tizen 3.0
- * @param[in] noti The notification handle
- * @param[out] index The notification button index
+ * @param[in] noti The notification handle
+ * @param[out] index The notification button index
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_NONE Success
* @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @pre Notification handle should be created by notification_create().
* @see #notification_button_index_e
@@ -831,11 +782,11 @@ int notification_set_default_button(notification_h noti, notification_button_ind
}
...
-
}
* @endcode
*/
-int notification_get_default_button(notification_h noti, notification_button_index_e *index);
+int notification_get_default_button(notification_h noti,
+ notification_button_index_e *index);
/**
* @brief Gets the notification ongoing value type.
@@ -844,7 +795,7 @@ int notification_get_default_button(notification_h noti, notification_button_ind
* @param[out] type The notification ongoing value type
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_NONE Success
* @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @pre Notification handle should be created by notification_create().
* @see #notification_ongoing_value_type_e
@@ -870,16 +821,17 @@ int notification_get_default_button(notification_h noti, notification_button_ind
}
* @endcode
*/
-int notification_get_ongoing_value_type(notification_h noti, notification_ongoing_value_type_e *type);
+int notification_get_ongoing_value_type(notification_h noti,
+ notification_ongoing_value_type_e *type);
/**
* @brief Sets the notification ongoing value type.
* @since_tizen 3.0
- * @param[in] noti The notification handle
- * @param[in] type The notification ongoing value type
+ * @param[in] noti The notification handle
+ * @param[in] type The notification ongoing value type
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_NONE Success
* @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @pre Notification handle should be created by notification_create().
* @see #notification_ongoing_value_type_e
@@ -907,17 +859,18 @@ int notification_get_ongoing_value_type(notification_h noti, notification_ongoin
}
* @endcode
*/
-int notification_set_ongoing_value_type(notification_h noti, notification_ongoing_value_type_e type);
+int notification_set_ongoing_value_type(notification_h noti,
+ notification_ongoing_value_type_e type);
/**
* @brief Gets the notification ongoing time when ongoint type value is set #NOTIFICATION_ONGOING_VALUE_TYPE_TIME.
* @since_tizen 3.0
- * @param[in] noti The notification handle
- * @param[out] current The ongoing current time
- * @param[out] duration The ongoing duration time
+ * @param[in] noti The notification handle
+ * @param[out] current The ongoing current time
+ * @param[out] duration The ongoing duration time
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_NONE Success
* @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @pre Notification handle should be created by notification_create().
* @see #notification_ongoing_value_type_e
@@ -949,12 +902,12 @@ int notification_get_ongoing_time(notification_h noti, int *current, int *durati
/**
* @brief Sets the notification ongoing time when ongoint type value is set #NOTIFICATION_ONGOING_VALUE_TYPE_TIME.
* @since_tizen 3.0
- * @param[in] noti The notification handle
- * @param[in] current The ongoing current time
- * @param[in] duration The ongoing duration time
+ * @param[in] noti The notification handle
+ * @param[in] current The ongoing current time
+ * @param[in] duration The ongoing duration time
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_NONE Success
* @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @pre Notification handle should be created by notification_create().
* @see #notification_ongoing_value_type_e
@@ -989,11 +942,11 @@ int notification_set_ongoing_time(notification_h noti, int current, int duration
/**
* @brief Gets timeout value in second when the notification can be hidden from the viewer.
* @since_tizen 3.0
- * @param[in] noti The notification handle
- * @param[out] timeout The timeout time(sec)
+ * @param[in] noti The notification handle
+ * @param[out] timeout The timeout time(sec)
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_NONE Success
* @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @pre Notification handle should be created by notification_create().
* @see #notification_event_type_extension_e
@@ -1024,11 +977,11 @@ int notification_get_hide_timeout(notification_h noti, int *timeout);
/**
* @brief Sets timeout value in second when the notification can be hidden from the viewer.
* @since_tizen 3.0
- * @param[in] noti The notification handle
- * @param[in] timeout The timeout time(sec)
+ * @param[in] noti The notification handle
+ * @param[in] timeout The timeout time(sec)
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_NONE Success
* @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @pre Notification handle should be created by notification_create().
* @see #notification_event_type_extension_e
@@ -1058,11 +1011,11 @@ int notification_set_hide_timeout(notification_h noti, int timeout);
/**
* @brief Gets timeout value in second when the notification can be deleted from the viewer.
* @since_tizen 3.0
- * @param[in] noti The notification handle
- * @param[out] timeout The timeout time(sec)
+ * @param[in] noti The notification handle
+ * @param[out] timeout The timeout time(sec)
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_NONE Success
* @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @pre Notification handle should be created by notification_create().
* @par Sample code:
@@ -1092,11 +1045,11 @@ int notification_get_delete_timeout(notification_h noti, int *timeout);
/**
* @brief Sets timeout value in second when the notification can be deleted from the viewer.
* @since_tizen 3.0
- * @param[in] noti The notification handle
- * @param[in] timeout The timeout time(sec)
+ * @param[in] noti The notification handle
+ * @param[in] timeout The timeout time(sec)
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_NONE Success
* @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @pre Notification handle should be created by notification_create().
* @par Sample code:
@@ -1127,17 +1080,17 @@ typedef void (*event_handler_cb)(notification_h noti, int event_type, void *user
/**
* @brief Posts a notification with event handler callback.
* @details The registered callback could be called when take notification event
- * and the callback is automatically deleted when notification you posted is deleted.
+ * and the callback is automatically deleted when notification you posted is deleted.
* @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
* @remarks Providing one event callback for each notification handle and distinguish the event by parameter.
- * @param[in] noti The notification handle
- * @param[in] cb The event handler callback function
- * @param[in] userdata The user data
+ * @param[in] noti The notification handle
+ * @param[in] cb The event handler callback function
+ * @param[in] userdata The user data
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_NONE Success
* @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #NOTIFICATION_ERROR_IO_ERROR I/O Error
* @retval #NOTIFICATION_PERMISSION_DENIED Permission denied
@@ -1174,8 +1127,8 @@ static void event_callback(notification_h noti, int event_type, void *userdata)
* @endcode
*/
int notification_post_with_event_cb(notification_h noti, event_handler_cb cb, void *userdata);
-int notification_post_with_event_cb_for_uid(notification_h noti, event_handler_cb cb,
- void *userdata, uid_t uid);
+int notification_post_with_event_cb_for_uid(notification_h noti,
+ event_handler_cb cb, void *userdata, uid_t uid);
/**
* @brief Sends a event type to an application that posted notification.
@@ -1183,11 +1136,11 @@ int notification_post_with_event_cb_for_uid(notification_h noti, event_handler_c
* @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
- * @param[in] noti The notification handle
- * @param[in] event_type The event type
+ * @param[in] noti The notification handle
+ * @param[in] event_type The event type
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_NONE Success
* @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #NOTIFICATION_ERROR_IO_ERROR I/O Error
* @retval #NOTIFICATION_PERMISSION_DENIED Permission denied
@@ -1219,17 +1172,17 @@ int notification_send_event_by_priv_id(int priv_id, int event_type);
/**
* @brief Gets the event flag.
* @details When you create a notification handle, a default value of event flag is false.
- * The flag automatically set true when post a notification using notification_post_with_event_cb().
- * The viewer application for showing the notifications can use this API to check if it needs to call
- * notification_send_event() to sends event of notification for making the callback of the processes
- * that have posted notification to be called. Call notification_send_event()
- * when the notification_get_event_flag() tells that the @event_flag is true.
+ * The flag automatically set true when post a notification using notification_post_with_event_cb().
+ * The viewer application for showing the notifications can use this API to check if it needs to call
+ * notification_send_event() to sends event of notification for making the callback of the processes
+ * that have posted notification to be called. Call notification_send_event()
+ * when the notification_get_event_flag() tells that the @event_flag is true.
* @since_tizen 3.0
- * @param[in] noti The notification handle
- * @param[out] event_flag The event flag
+ * @param[in] noti The notification handle
+ * @param[out] event_flag The event flag
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_NONE Success
* @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @pre Notification handle should be created by notification_create().
* @par Sample code:
@@ -1353,8 +1306,8 @@ notification_h notification_load_by_tag_for_uid(const char *tag, uid_t uid);
* @param[in] Max length of Text input
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
- * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
* @par Sample code:
* @code
#include <notification.h>
@@ -1376,45 +1329,41 @@ int notification_get_text_input_max_length(notification_h noti, int *text_input_
/**
* @brief Sets an extension data.
* @since_tizen 4.0
- * @param[in] noti The notification handle
- * @param[in] key The key
- * @param[in] value The bundle data
+ * @param[in] noti The notification handle
+ * @param[in] key The key
+ * @param[in] value The bundle data
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
- * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
*/
int notification_set_extension_data(notification_h noti, const char *key, bundle *value);
/**
* @brief Gets an extension data.
* @since_tizen 4.0
- * @param[in] noti The notification handle
- * @param[in] key The key
- * @param[out] value The bundle data
+ * @param[in] noti The notification handle
+ * @param[in] key The key
+ * @param[out] value The bundle data
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
- * @retval #NOTIFICATION_ERROR_NONE Success
- * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #NOTIFICATION_ERROR_IO_ERROR IO Error
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #NOTIFICATION_ERROR_IO_ERROR IO Error
*/
int notification_get_extension_data(notification_h noti, const char *key, bundle **value);
/**
* @brief This function will be deprecated.
* @see notification_set_extension_data()
- *
*/
-NOTIFICATION_DEPRECATED_API
-int notification_set_extention_data(notification_h noti, const char *key, bundle *value);
+int notification_set_extention_data(notification_h noti, const char *key, bundle *value) NOTIFICATION_DEPRECATED_API;
/**
* @brief This function will be deprecated.
* @see notification_get_extension_data()
- *
*/
-NOTIFICATION_DEPRECATED_API
-int notification_get_extention_data(notification_h noti, const char *key, bundle **value);
+int notification_get_extention_data(notification_h noti, const char *key, bundle **value) NOTIFICATION_DEPRECATED_API;
/**
* @brief Sets the handler for a specific extension event.
@@ -1439,7 +1388,7 @@ int notification_set_extension_event_handler(notification_h noti,
* @details When extension event occurs on notification, application launched by app_control_send_launch_request with app_control handle.
* @since_tizen 4.0
* @param[in] noti The notification handle
- * @param[in] event_type Event type
+ * @param[in] event Event type
* @param[out] event_handler App control handle
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
@@ -1459,9 +1408,9 @@ int notification_get_extension_event_handler(notification_h noti,
* @since_tizen 5.0
* @param[in] noti Notification handle
* @param[in] label Label of Caller application
- * @return NOTIFICATION_ERROR_NONE on success, other value on failure
- * @retval NOTIFICATION_ERROR_NONE Success
- * @retval NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
+ * @return #NOTIFICATION_ERROR_NONE on success, other value on failure
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
* @par Sample code:
* @code
#include <notification.h>
@@ -1493,9 +1442,9 @@ int notification_set_app_label(notification_h noti, char *label);
* @since_tizen 5.0
* @param[in] noti Notification handle
* @param[out] label Label of Caller application
- * @return NOTIFICATION_ERROR_NONE on success, other value on failure
- * @retval NOTIFICATION_ERROR_NONE Success
- * @retval NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
+ * @return #NOTIFICATION_ERROR_NONE on success, other value on failure
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
* @par Sample code:
* @code
#include <notification.h>
@@ -1516,8 +1465,7 @@ int notification_get_app_label(notification_h noti, char **label);
/**
* @ This API is only for App Framework internally.
*/
-int notification_set_indirect_request(notification_h noti, pid_t pid,
- uid_t uid);
+int notification_set_indirect_request(notification_h noti, pid_t pid, uid_t uid);
/**
* @internal
@@ -1526,14 +1474,14 @@ int notification_set_indirect_request(notification_h noti, pid_t pid,
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
* @param[in] viewer Combination value of display list
- * @return NOTIFICATION_ERROR_NONE on success, other value on failure
- * @retval NOTIFICATION_ERROR_NONE Success
- * @retval NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
- * @retval NOTIFICATION_ERROR_IO_ERROR I/O error
- * @retval NOTIFICATION_ERROR_OUT_OF_MEMORY Out of memory
- * @retval NOTIFICATION_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
- * @retval NOTIFICATION_ERROR_FROM_DB Error from DB query
- * @retval NOTIFICATION_ERROR_SERVICE_NOT_READY No response from notification service
+ * @return #NOTIFICATION_ERROR_NONE on success, other value on failure
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid input value
+ * @retval #NOTIFICATION_ERROR_IO_ERROR I/O error
+ * @retval #NOTIFICATION_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #NOTIFICATION_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
+ * @retval #NOTIFICATION_ERROR_FROM_DB Error from DB query
+ * @retval #NOTIFICATION_ERROR_SERVICE_NOT_READY No response from notification service
* @par Sample code:
* @code
#include <notification.h>