openApplication()

Description:

The openApplication method enables a widget to launch an S60 mobile application in the stand-alone mode.

Syntax:

[void] window.widget.openApplication(HexNumber Uid, String param) 

or

[void] widget.openApplication(HexNumber Uid, String param)

Arguments:

  • Uid:

    A hexadecimal number that specifies the UID of the S60 application to be activated. See the table below for example application UIDs.

  • param:

    A text string defining a possible argument string that is accepted by the S60 application to be activated. The arguments vary between applications. For example, when defined for the Web Browser for S60 application (UID: 0x10008D39), the parameter "4"+"<Space>"+"<url>" tells the browser to open with content from a specific URL. The parameter "5" launches the browser with the Start page open. You can also use an empty string with any application, which results in launching the specified application with default behavior.

Return value:

This method does not return a value.

Remarks:

For security reasons, a widget cannot open another widget by using this method.

Example code:

// function launches the S60 Profiles application
widget.openApplication(0x100058F8, "");

Example application UIDs:

The following table lists some of the applications that can be launched from a widget, as well as the application UIDs.

Application name

Application UID

Description

Web Browser for S60

0x10008D39

Default browser application of the S60 platform.

Messaging

0x100058C5

Enables messaging operations, such as sending and receiving text messages and email.

Contacts

0x101f4cce

Enables the mobile device user to store and manage information related to his or her contacts, for example, phone numbers and email addresses.

Log

0x101f4cd5

Provides a record of communication events, such as missed voice calls, duration of the last voice call, and received text messages.

Profiles

0x100058F8

Enables the mobile device user to have different settings for different situations, for example, to set the device ringing type to silent during a meeting or set the vibrating alert on when outdoors.

Calendar

0x10005901

Helps the mobile device user in organizing his or her schedule, for example by adding notes to specific dates.

Clock

0x10005903

Enables the mobile device user to see the date and time for selected cities around the world, as well as set alarms.

Recorder

0x100058CA

Enables the mobile device user to record audio clips.

Converter

0x101F4668

Enables the mobile device user to convert various measures from one unit to another, for example meters to yards.

Calculator

0x10005902

Enables the mobile device user to make basic calculations.

Notes

0x1000599d

Text editor that enables the mobile device user to write, view and edit short textual notes.

File Manager

0x101f84eb

Enables the mobile device user to manage and organize files that are stored in the phone memory of the device or on an external memory card.

Gallery

0x101f8599

Enables the mobile device user to view and manage media files, such as images, music files and video clips.

Camera - on a device with one camera

101f857a

Enables the mobile device user to take and manage still pictures as well as to record short video clips with the digital camera of the device.

Camera - on a device with two cameras

101ffa86

Enables the mobile device user to take and manage still pictures as well as to record short video clips with the digital cameras of the device.

Music Player

0x102072c3

Enables the mobile device user to listen to music and sound files as well as to manage his or her music collection.

RealPlayer

0x10005a3e

Enables the mobile device user to play and manage media files that are stored in the device, such as video clips, or media streams from remote locations.

Bluetooth

0x10005951

Enables the mobile device user to connect to other devices using the Bluetooth local connectivity technology.

Infrared

0x1000594d

Enables the mobile device user to connect to other devices using the infrared technology.

Settings

0x100058ec

Enables the mobile device user to manage application and device settings.

Themes

0x10005a32

Enables the mobile device user to personalize the look and feel of the device with specific UI themes.