View source

__NOTOC__
__NOEDITSECTION__
{{KBCS}}
{{CodeSnippet
|id=CS001236
|platform=S60 5th Edition
|devices=Nokia 5800XpressMusic
|category=Web Runtime (WRT)
|subcategory=Messaging
|creationdate=December 18, 2008  
|keywords=device.getServiceObject(), Service.IMessaging.RegisterNotification(),
Service.IMessaging.Send()
}}

==Overview==

This code snippet shows how to register your application to receive notifications on sent messages using the Messaging Platform Service for S60 Web Runtime introduced in S60 5th Edition.

The <tt>device.getServiceObject("Service.Messaging", "IMessaging")</tt> method is used to obtain access to the service object for the Messaging Service API.

After setting up the values for the notification type (<tt>notificationCriteria.NotificationType</tt>), the <tt>IMessaging.RegisterNotification(notificationCriteria,showMessagesStatus)</tt> method is used to register for notifications. The <tt>IMessaging.RegisterNotification()</tt> method is asynchronous and uses the <tt>showMessagesStatus()</tt> as a callback function.

==Source: Relevant HTML components==

<code xml>
<p id="status"></p>
</code>

==Source: JavaScript file==

<code javascript>
var serviceObj = null;

// Initializes the widget
function initialize() {    
    document.getElementById("status").style.display = "none";

    // Obtain the service object
    try {
        serviceObj = device.getServiceObject("Service.Messaging",
            "IMessaging");
    } catch(exception) {
        alert("Service object cannot be found.");
        return;
    }
}

function sendMessageAndNotify() {
    // The sending part omitted. Refer to the See also section for the code
    // snippet that provides you with more information about the sending.
    // ...

    try {
        var notificationCriteria = new Object();
        notificationCriteria.Type = "NewMessage";
        //Registering for notification on new events.
        var result = serviceObj.IMessaging.RegisterNotification(
            notificationCriteria, showMessagesStatus);
    } catch (exception) {
        alert("Register message notification error: " + exception);
    }
}

/**
 * Callback function used to handle changes in the messaging status.
 * @param transId This is a number representing the transaction that called
 * the callback
 * @param eventCode This is a number representing the callback return status.
 * @param result This is an object for holding the callback return value.
 */
function showMessagesStatus(transId, eventCode, result) {
    if (result.ErrorCode == 0) {
        document.getElementById("status").innerHTML =
            "You have a new message!";
        document.getElementById("status").style.display = "block";
    }
}
</code>

==Postconditions==

The snippet shows how to register for receiving notifications on message status changing.

==Supplementary material==

The source file and executable application are available for download at [[Media:Showing_messages_information_notifications_in_WRT.zip]].

==See also==

* [[CS001242 - Sending SMS messages in WRT]]

[[Category:Web Runtime (WRT)]][[Category:Code Examples]][[Category:Messaging]][[Category:S60 5th Edition]]