Notification

An application can create notifications for the user.

The Tizen Notification API requires the http://tizen.org/privilege/notification privilege.

To use the notification feature:

• To post a simple notification, use the notification_post() function, which accepts a notification handle as a parameter.

  The posted notification has a default notification icon and the application name as the title.

• To control the detailed behavior of the notification or to show the progress bar in the on-going activity area, use the notification_create() function to get a notification handle and set the details.

Notification Types

Tizen provides notifications by using a combination of any of the following notification types:

• Indicator
• Quick panel
• Sound

You can specify the message for the indicator or quick panel. The display area for quick panel notifications can be one of the following:

• Notification area

  The notification area is the reserved space for displaying all notifications, except the on-going notifications.

• On-going area

  The on-going area is the application screen area and is only used to display notifications for the currently running application.

Figure: Notification and on-going areas

Notification Layouts

The following notification layouts are provided:

• NOTIFICATION_LY_NOTI_EVENT_SINGLE

  Layout for a single event notification.

• NOTIFICATION_LY_NOTI_EVENT_MULTIPLE

  Layout for a multiple event notification.

• NOTIFICATION_LY_NOTI_THUMBNAIL

  Layout for a notification displaying images.

• NOTIFICATION_LY_ONGOING_EVENT

  Layout for an ongoing notification displaying a text message.

• NOTIFICATION_LY_ONGOING_PROGRESS

  Layout for an ongoing notification displaying progress.

Figure: Notification layouts