MIME type handling in Symbian Web Runtime

Template:KBCS

Article Metadata

---

Tested with

Devices(s): Nokia 5800 XpressMusic

---

Compatibility

Platform(s): S60 5th Edition

---

Article

Keywords: device.getServiceObject(),Service.IAppManager.LaunchDoc(),

menu.setRightSoftkeyLabel(),widget.setNavigationEnabled(),

Service.IDataSource.GetList()

Created: (08 Jun 2009)

Last edited: copyeditor (16 Jun 2009)

Overview

This code snippet demonstrates how to launch an application based on a given document using the AppManager Platform Service for Web Runtime, introduced in S60 5th Edition. Image files were chosen to present the MIME type handling in WRT.

Source file: Relevant HTML components

<select size = "5" id = "imageList" onclick = "show();">
    <option></option>
</select>

Source

/**
 * Shows the selected image.
 */
function show() {
    var so = null;
 
    try {
        //Getting service object for application management.
        var so = device.getServiceObject("Service.AppManager", "IAppManager");
    } catch (ex) {
        alert("Exception in getting application service object: " + ex);
        return;
    }
 
    var imageList = document.getElementById("imageList");
    for (var i = 0; i < imageList.options.length; i++) {
        if (imageList.options[i].selected) {
            var criteria = new Object();
            criteria.Document = new Object();
            //Setting the path to file that must be opened in a standalone
            //application
            criteria.Document.DocumentPath = imageList.options[i].value;
            //Opening the file in standalone application
            try {
                var res = so.IAppManager.LaunchDoc(criteria);
                if (res.ErrorCode != 0){
                    alert(res.ErrorCode + ' ; ' + res.ErrorMessage);
                }
            } catch (ex){
                alert("Exception in launching document: " + ex);
            }
        }
    }
}

Postconditions

The image selected from the list is displayed in a standalone application.

See also

• CS001245 - Loading images in WRT

Supplementary material

This code snippet is part of the stub concept, which means that it has been patched on top of a template application in order to be more useful to developers. The version of the WRT stub application used as a template in this snippet is v1.1.

• The patched, executable application that can be used to test the features described in this snippet is available for download at Media:MimeTypeHandling.zip.
• You can view all the changes that are required to implement the above-mentioned features. The changes are provided in unified diff and colour-coded diff (HTML) formats in Media:MimeTypeHandling.diff.zip.
• For general information on applying the patch, see Using Diffs.
• For unpatched stub applications, see Example stub.