/**
* @brief Sets an absolute path for an image file to display on the notification view.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[in] type The notification image type
* @param[in] image_path The image file full path
/**
* @brief Gets the absolute path of an image file.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @remarks Do not free @a image_path. It will be freed when notification_free() is called.
* @param[in] noti Notification handle
* @param[in] type Notification image type
/**
* @brief Sets a timestamp.
* @details If input_time is @c 0, time information is taken from the current time.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[in] input_time The input time. If you want the time stamp to not be shown, set this as #NOTIFICATION_DO_NOT_SHOW_TIME_STAMP
* @return #NOTIFICATION_ERROR_NONE on success,
/**
* @brief Gets a timestamp.
* @details If ret_time is @c 0, time information is not set before.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[out] ret_time The return time value
* @return #NOTIFICATION_ERROR_NONE on success,
/**
* @brief Gets an insertion timestamp of the notification.
* @details If ret_time is @c 0, this notification data is not inserted before.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[out] ret_time The return time value
* @return #NOTIFICATION_ERROR_NONE on success,
* The application must supply a String KEY as the fourth argument to support localization.
* If the language on the system changes, the contents of the notification are also translated.
*
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[in] type The notification text type
* @param[in] text The basic text
/**
* @brief Gets the text from the notification handle.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @remarks Do not free @a text. It will be freed when notification_free() is called.
* @param[in] noti The notification handle
* @param[in] type The notification text type
/**
* @brief Sets the timestamp to display on the notification view.
* @details The timestamp will be converted to a formatted string and it will be displayed on the set text area.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[in] type The notification text type
* @param[in] time The timestamp
/**
* @brief Gets the timestamp from the notification handle.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[in] type The notification text type
* @param[in] time The pointer of time stamp
/**
* @brief Sets the sound type for the notification.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[in] type The notification sound type
* @param[in] path The user sound file path
/**
* @brief Gets the sound type from the notification handle.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @remarks Do not free @a path. It will be freed when notification_free() is called.
* @param[in] noti The notification handle
* @param[out] type The notification sound type
/**
* @brief Sets the vibration type for the notification.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[in] type The notification vibration type
* @param[in] path The user vibration file path
/**
* @brief Gets the vibrate type from the notification handle.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @remarks Do not free @a path. It will be freed when notification_free() is called.
* @param[in] noti The notification handle
* @param[out] type The notification sound type
/**
* @brief Sets the LED displaying option.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[in] operation The LED notification operation
* @param[in] led_argb The notification LED color
/**
* @brief Gets the LED displaying option from the notification handle.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[out] operation The LED notification operation
* @param[out] led_argb The notification LED color
/**
* @brief Sets the time period of flashing the LED.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[in] on_ms The time for turning on the LED
* @param[in] off_ms The time for turning off the LED
/**
* @brief Gets the time period of flashing the LED from the notification handle.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[out] on_ms The time for turning on the LED
* @param[out] off_ms The time for turning on the LED
/**
* @brief Sets the launch option for a notification.
* @details When notification data selected in display application, application launched by app_control_send_launch_request with app_control handle.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/appmanager.launch
* @remarks Since 4.0, %http://tizen.org/privilege/appmanager.launch privilege is additionally required.
/**
* @brief Gets the launch option from the notification handle.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @remarks You must release @a option using app_control_destroy().
* @param[in] noti The notification handle
* @param[in] type Launching option type
* @brief Sets the handler for a specific event.
* @details When some event occurs on notification, application launched by app_control_send_launch_request with app_control handle. \n
* Setting event handler of a button means that the notification will show the button.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/appmanager.launch
* @remarks Since 4.0, %http://tizen.org/privilege/appmanager.launch privilege is additionally required.
/**
* @brief Gets the event handler of a specific event.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @remarks You must release @a event_handler using app_control_destroy().
* @param[in] noti The notification handle
* @param[in] event_type Launching option type
/**
* @brief Sets the property of the notification.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[in] flags The property with | operation
* @return #NOTIFICATION_ERROR_NONE on success,
/**
* @brief Gets the property of the notification from the notification handle.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[out] flags The notification property
* @return #NOTIFICATION_ERROR_NONE on success,
/**
* @brief Sets applications to display the notification.
* @details All display application is enabled(#NOTIFICATION_DISPLAY_APP_ALL) if you do not call this function.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[in] applist The with | operation
* @return #NOTIFICATION_ERROR_NONE on success,
/**
* @brief Gets the application list displaying the notification from the notification handle.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[out] applist The display application list
* @return #NOTIFICATION_ERROR_NONE on success,
/**
* @brief Sets the initial size for the ongoing type.
* @details After notification_post() call, the size is not updated.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[in] size The double type size
* @return #NOTIFICATION_ERROR_NONE on success,
/**
* @brief Gets the progress size.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[out] size The progress size
* @return #NOTIFICATION_ERROR_NONE on success,
/**
* @brief Sets the initial progress for the ongoing type.
* @details After the notification_post() call, the progress is not updated.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[in] percentage The progress percentage
* @return #NOTIFICATION_ERROR_NONE on success,
/**
* @brief Gets the progress from the notification handle.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @remarks At the end of the operation, the progress should be @c 1.0.
* @param[in] noti The notification handle
* @param[out] percentage The progress percentage
/**
* @brief Sets the layout of the notification view.
* @details Caller can set displaying layout of notification.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[in] layout The type of layout
* @return #NOTIFICATION_ERROR_NONE on success,
/**
* @brief Gets the layout of the notification view from the notification handle.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[out] layout The type of layout
* @return #NOTIFICATION_ERROR_NONE on success,
/**
* @brief Gets the type of a notification.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[out] type The notification type
* @return #NOTIFICATION_ERROR_NONE on success,
/**
* @brief Updates notification data.
* @details The updated notification will appear in the notification area.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
* @param[in] noti The notification handle that is created by notification_create()
/**
* @brief Deletes a notification with the given handle.
* @details notification_delete() removes notification data from database and notification_free() releases memory of notification data.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
* @param[in] noti The notification handle
* @details Available type is #NOTIFICATION_TYPE_NOTI and #NOTIFICATION_TYPE_ONGOING.
* #NOTIFICATION_TYPE_NOTI is remaining notification data even if device is restarted.
* #NOTIFICATION_TYPE_ONGOING can display progress on a notification with #NOTIFICATION_LY_ONGOING_PROGRESS layout.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* The returned value should be released using notification_free().
* @param[in] type The notification type
/**
* @brief Creates a notification clone.
* @details Newly created notification handle is returned.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @remarks This cloned notification handle should be freed using notification_free().
* @param[in] noti The notification handle
* @param[out] clone The newly created notification handle that has same with input @a noti
/**
* @brief Frees the internal structure data of a notification handle.
* @details Internal data of a notification handle is released. Data of the inserted notification is not deleted.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
/**
* @brief Sets the tag of the notification handle.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] noti Notification handle
* @param[in] tag Tag for loading notification handle
* @return #NOTIFICATION_ERROR_NONE on success,
/**
* @brief Gets the tag of the notification handle.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @remarks Do not free @a tag. It will be freed when notification_free() is called.
* @param[in] noti Notification handle
* @param[out] tag Tag for loading notification handle
/**
* @brief Loads a notification from the notification's database with the tag.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
/**
* @brief Deletes all notifications of the given type.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
* @param[in] type Notification type
/**
* @brief Posts a notification.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
* @param[in] noti Notification handle
/**
* @brief Gets the package name of the notification.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @remarks Do not free @a pkgname. It will be freed when notification_free() is called.
* @param[in] noti Notification handle
* @param[out] pkgname The package name of the notification
/**
* @brief Adds a button on the notification.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @param[in] noti Notification handle
* @param[in] button_index Button index
* @return #NOTIFICATION_ERROR_NONE on success,
/**
* @brief Removes a button on the notification.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @param[in] noti Notification handle
* @param[in] button_index Button index
* @return #NOTIFICATION_ERROR_NONE on success,
/**
* @brief Sets the 'auto remove' option of the active notification.
* @details The 'auto remove' option lets the active notification be removed several seconds after it shows. Default value is true.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @remarks When 'auto_remove' is set as false, the active notification will not be removed
* as long as the user removes the active notification or the app which posted the active notification removes the active notification.
* @param[in] noti Notification handle
/**
* @brief Gets the 'auto remove' option of the active notification.
* @details The 'auto remove' option lets the active notification be removed several seconds after it shows. Default value is true.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @param[in] noti Notification handle
* @param[out] auto_remove Auto remove option
* @return #NOTIFICATION_ERROR_NONE On success, other value on failure
/**
* @brief Enumeration for notification errors.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
typedef enum _notification_error {
NOTIFICATION_ERROR_NONE = TIZEN_ERROR_NONE, /**< Success */
NOTIFICATION_ERROR_OUT_OF_MEMORY = TIZEN_ERROR_OUT_OF_MEMORY, /**< Out of memory */
NOTIFICATION_ERROR_IO_ERROR = TIZEN_ERROR_IO_ERROR, /**< I/O error */
NOTIFICATION_ERROR_PERMISSION_DENIED = TIZEN_ERROR_PERMISSION_DENIED, /**< Permission denied */
- NOTIFICATION_ERROR_INVALID_OPERATION = TIZEN_ERROR_INVALID_OPERATION, /**< Function not implemented (@b Since: @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
+ NOTIFICATION_ERROR_INVALID_OPERATION = TIZEN_ERROR_INVALID_OPERATION, /**< Function not implemented (@b Since: 2.4 */
NOTIFICATION_ERROR_FROM_DB = TIZEN_ERROR_NOTIFICATION | 0x01, /**< Error from DB query */
NOTIFICATION_ERROR_ALREADY_EXIST_ID = TIZEN_ERROR_NOTIFICATION | 0x02, /**< Already exist private ID */
NOTIFICATION_ERROR_FROM_DBUS = TIZEN_ERROR_NOTIFICATION | 0x03, /**< Error from DBus */
/**
* @brief Updates the progress of the inserted notification. This only works for the ongoing notification (NOTIFICATION_TYPE_ONGOING).
* @details The Notification view on the notification area could be updated.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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
/**
* @brief Updates the size of inserted notification data. This only works for the ongoing notification (NOTIFICATION_TYPE_ONGOING).
* @details Notification view on notification area could be updated.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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
/**
* @brief Updates the content of the inserted notification data. This is only for the ongoing notification (NOTIFICATION_TYPE_ONGOING).
* @details Notification view on notification area could be updated.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] noti Notification handle or NULL if priv_id is valid
* @param[in] priv_id Private ID
* @param[in] content Text to update
* @brief Inserts a notification.
* @details The notification will be inserted to the database and then it will appear in the notification area.
* When notification_create() is called, if priv_id is #NOTIFICATION_PRIV_ID_NONE, priv_id returns the internally set priv_id.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
* @param[in] noti The notification handle
* @internal
* @brief Updates a notification, asynchronously.
* @details The updated notification will appear in the notification area.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
* @remarks This function updates the notification asynchronously.
* @internal
* @brief Registers a callback for all notification events.
* @details The registered callback could be called for all notification events.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
* @param[in] changed_cb The callback function
/**
* @internal
* @brief Unregisters a callback for all notification events.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
* @param[in] changed_cb The callback function
/**
* @brief Notification list handle.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
typedef struct _notification_list *notification_list_h;
* @internal
* @brief Returns the notification list handle.
* @details If count is equal to @c -1, all notifications are returned.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
* @remarks The @a list should be released using notification_free_list().
* @internal
* @brief Returns the notification detail list handle of grouping data.
* @details If count is equal to c -1, all notifications are returned.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
* @remarks The @a list should be released using notification_free_list().
/**
* @internal
* @brief Frees a notification list.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
* @param[in] list The notification list handle
/**
* @internal
* @brief Gets the head pointer of the notification list.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* The returned value should be released using notification_free_list().
* @param[in] list Notification list handle
/**
* @internal
* @brief Gets the tail pointer to the notification list.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* The returned value should be released using notification_free_list().
* @param[in] list Notification list handle
/**
* @internal
* @brief Gets the previous pointer of the current notification list.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* The returned value should be released using notification_free_list().
* @param[in] list Notification list handle
/**
* @internal
* @brief Gets the next pointer of the current notification list.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* The returned value should be released using notification_free_list().
* @param[in] list Notification list handle
/**
* @internal
* @brief Gets the notification handle that the list has.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* The returned value should be released using notification_free().
* @param[in] list Notification list handle
/**
* @internal
* @brief Appends notification data to the notification list.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] list Notification list handle
* @param[in] noti Notification handle
/**
* @internal
* @brief Removes notification data from the notification list.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] list The notification list handle
* @param[in] noti The notification handle
/**
* @brief Updates progress.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] caller_app_id
* @param[in] priv_id
* @param[in] progress
/**
* @brief Updates size.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] caller_app_id
* @param[in] priv_id
* @param[in] size
/**
* @brief Updates content.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] caller_app_id
* @param[in] priv_id
* @param[in] content
/**
* @brief Sets the ongoing flag of the notification
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @param[in] noti The notification handle
* @param[in] ongoing_flag The ongoing flag
* @return #NOTIFICATION_ERROR_NONE on success,
/**
* @brief Gets the ongoing flag of the notification
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @param[in] noti The notification handle
* @param[out] ongoing_flag The ongoing flag
* @return #NOTIFICATION_ERROR_NONE on success,
/**
* @internal
* @brief Gets setting handle of current process.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @param[out] setting The setting handle
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
/**
* @internal
* @brief Refreshs the setting table of current user.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @param[in] uid User id
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
/**
* @internal
* @brief Initializes the system setting table of the current user.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @param[in] uid User id
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
/**
* @internal
* @brief Gets the array of notification setting.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
* @param[out] setting_array The array of notification setting
/**
* @brief Shows a toast popup window with given message.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @param[in] message The messages to be posted
* @return #NOTIFICATION_ERROR_NONE on success,
* otherwise any other value on failure
/**
* @internal
* @brief Unregisters a callback for all notification events.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/notification
* @param[in] changed_cb The callback function
/**
* @internal
* @brief Called when a new message is posted.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] message The message posted
* @param[in] data The user data
* @pre notification_status_monitor_message_cb_set() used to register this callback.
/**
* @internal
* @brief Registers a callback to receive a message.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] callback The callback function
* @param[in] data The user_data
* @return #NOTIFICATION_ERROR_NONE if success, other value if failure
/**
* @internal
* @brief Unregisters a callback to receive a message.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] callback The callback function
* @param[in] data The user_data
* @return #NOTIFICATION_ERROR_NONE if success, other value if failure
/**
* @brief Sets the text domain to localize the notification.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] noti The notification handle
* @param[in] domain The text domain
* @param[in] dir The text dir
/**
* @brief Gets the text domain from the notification handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks Do not free returned domain and dir. They are freed when notification_free() or notification_free_list() is called.
* @param[in] noti The notification handle
* @param[out] domain The domain
/**
* @brief Enumeration for notification layout type.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
typedef enum _notification_ly_type {
NOTIFICATION_LY_NONE = 0, /**< Default */
NOTIFICATION_LY_NOTI_THUMBNAIL, /**< Layout for notification. Used to display images */
NOTIFICATION_LY_ONGOING_EVENT, /**< Layout for ongoing notification. Used to display text message.
* notifications with #NOTIFICATION_LY_ONGOING_EVENT can not be protected from
- * removing by user since tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif */
+ * removing by user since tizen 2.4 */
NOTIFICATION_LY_ONGOING_PROGRESS, /**< Layout for ongoing notification. Used to display progress */
NOTIFICATION_LY_EXTENSION, /**< Layout for extended notification (Since 4.0) */
} notification_ly_type_e;
/**
* @brief Enumeration for notification launch option type.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
typedef enum _notification_launch_option_type {
NOTIFICATION_LAUNCH_OPTION_APP_CONTROL = 1, /**< Launching with app control */
/**
* @brief Enumeration for event type on notification.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*/
typedef enum _notification_event_type {
NOTIFICATION_EVENT_TYPE_CLICK_ON_BUTTON_1 = 0, /**< Event type : Click on button 1 */
/**
* @brief Enumeration for notification sound type.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
typedef enum _notification_sound_type {
NOTIFICATION_SOUND_TYPE_NONE = -1, /**< Default value. no sound */
/**
* @brief Enumeration for notification vibration type.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
typedef enum _notification_vibration_type {
NOTIFICATION_VIBRATION_TYPE_NONE = -1, /**< Default value. No vibration */
/**
* @brief Enumeration for notification LED operation.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
typedef enum _notification_led_op {
NOTIFICATION_LED_OP_OFF = -1, /**< Default value. Disable the LED notification */
/**
* @brief Enumeration for button.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*/
typedef enum _notification_button_index {
NOTIFICATION_BUTTON_1 = 1, /**< button 1 */
/**
* @brief Enumeration for notification text type.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
typedef enum _notification_text_type {
NOTIFICATION_TEXT_TYPE_NONE = -1, /**< None */
/**
* @brief Enumeration for image type.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
typedef enum _notification_image_type {
NOTIFICATION_IMAGE_TYPE_NONE = -1, /**< None */
/**
* @brief Enumeration for application execution type.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
typedef enum _notification_execute_type {
NOTIFICATION_EXECUTE_TYPE_NONE = -1, /**< No operation */
/**
* @brief Enumeration for notification type.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
typedef enum _notification_type {
NOTIFICATION_TYPE_NONE = -1, /**< None */
/**
* @brief Enumeration for Group ID.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
enum _notification_group_id {
NOTIFICATION_GROUP_ID_NONE = -1, /**< Not Grouping */
/**
* @brief Enumeration for Private ID.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
enum _notification_priv_id {
NOTIFICATION_PRIV_ID_NONE = -1, /**< Internally set priv_id */
/**
* @brief Enumeration for notification property.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
enum _notification_property {
NOTIFICATION_PROP_DISPLAY_ONLY_SIMMODE = 0x00000001, /**< Display only SIM card inserted */
/**
* @brief Enumeration for display application list.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
enum _notification_display_applist {
NOTIFICATION_DISPLAY_APP_NOTIFICATION_TRAY = 0x00000001, /**< Notification Tray(Quickpanel) */
/**
* @brief Enumeration for notification operation code.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
typedef enum _notification_op_type {
NOTIFICATION_OP_NONE = 0, /**< Default */
/**
* @brief Enumeration for notification operation data code.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
typedef enum _notification_op_data_type {
NOTIFICATION_OP_DATA_MIN = 0, /**< Default */
/**
* @brief Enumeration for notification count position in the text.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
typedef enum _notifcation_count_pos_type {
NOTIFICATION_COUNT_POS_NONE = -1, /**< Count data is not displaying in the text */
/**
* @brief Enumeration for notification variable parameter type.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
typedef enum _notification_variable_type {
NOTIFICATION_VARIABLE_TYPE_NONE = -1, /**< Variable parameter type is NONE */
/**
* @brief Notification handle.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
typedef struct _notification *notification_h;
/**
* @brief The structure for notification operation.
- * @since_tizen @if WEARABLE 2.3.1 @elseif MOBILE 2.3 @endif
+ * @since_tizen 2.3
*/
typedef struct _notification_op {
notification_op_type_e type; /**< Notification operation type */
/**
* @brief Enumeration for permission.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*/
typedef enum notification_permission_type {
NOTIFICATION_PERMISSION_TYPE_NONE = 0, /**< None */