org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-05A1F618-5FB1-4821-8408-A213F38F2EDA.html
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/><meta name="copyright" content="(C) Copyright 2009"/><meta name="DC.rights.owner" content="(C) Copyright 2009"/><meta name="DC.Type" content="concept"/><meta name="DC.Title" content="Introduction to widgets"/><meta name="DC.Relation" scheme="URI" content="GUID-DA3E6868-F769-4576-A0C3-6776BF358B44"/><meta name="DC.Relation" scheme="URI" content="GUID-B00941F9-2530-4D3D-BBC7-59EDA3A4C151"/><meta name="DC.Relation" scheme="URI" content="GUID-91B65EA3-06B7-475E-9557-29EE584731E5"/><meta name="DC.Format" content="XHTML"/><meta name="DC.Identifier" content="GUID-05A1F618-5FB1-4821-8408-A213F38F2EDA"/><title>Introduction
to widgets </title><script type="text/javascript">
function initPage() {}
</script><link href="../PRODUCT_PLUGIN/book.css" rel="stylesheet" type="text/css"/><link href="css/s60/style.css" rel="stylesheet" type="text/css" media="all"/></head><body onload="initPage();"><div class="body"><div class="contentLeft prTxt"><h1 class="pageHeading" id="GUID-05A1F618-5FB1-4821-8408-A213F38F2EDA">Introduction
to widgets</h1><div>
<p>S60 3<sup>rd</sup> Edition, Feature Pack 2 and later support installing
and running widgets on mobile devices.</p>
<div><h3>Default behavior of widgets on mobile devices</h3><p>From
the mobile device user point of view, the appearance and functionality of
a widget is similar to any other mobile application. Users can download widgets
to mobile devices in several ways, as a <code>wgz</code> file. The device
platform takes care of the actual installation process. For more information
on downloading and installing widgets, see the <a href="GUID-CCA3FA0B-9D75-453A-947C-B3CB2A85C684.html#GUID-DDDC3E75-8875-49D8-A893-43F9A8FBA16F">deployment
methods table</a>.</p><p>Once a widget has been installed on a mobile device,
it can be found in the application menu, under the folder that contains installed
applications. The name of this folder varies between mobile devices, and can
be <span class="uicontrol">Installations</span> or <span class="uicontrol">Applications</span>,
for example. A widget has its own icon and name, which are defined in the <a href="GUID-0E3095DB-03FF-4240-83F2-6D876AD2083A.html#GUID-0E3095DB-03FF-4240-83F2-6D876AD2083A">widget component files</a>.
The user can launch a widget by navigating to it and opening it.</p><p>Widgets
can have a full screen view and a home screen view. In full screen mode, only
one widget can be on the <a href="GUID-EAE0823B-5914-49C2-9DBC-15B61DE49E60.html#GUID-EAE0823B-5914-49C2-9DBC-15B61DE49E60">foreground</a> at
a time. The home screen can display several widgets at a time.</p><div class="figure" id="GUID-86E9DE0E-8447-4A1E-A0A7-5F415232BF3A"><img src="GUID-3DA7780D-3B24-40CF-8896-8FA33B5F87FB_d0e1183_href.png"/><p class="figure-title"><strong>Figure: </strong>A widget in the Installations folder and a widget using the full screen
of the device</p></div><p>When a widget is running, it is visible in the <strong>Open applications</strong> list.
To see the list, long-press the menu key.</p><div class="figure" id="GUID-64F1A9DB-F66B-4CF8-9284-781FB82B7917"><img src="GUID-4BDA5932-90A7-4569-ADA7-27E090D2F447_d0e1195_href.png"/><p class="figure-title"><strong>Figure: </strong>A widget in the Open applications list</p></div></div>
<div><h3>Customization options for the mobile device user</h3><p>Similarly
to mobile applications, users can also create shortcuts to their widgets.
They can have widgets in the My Today applications list in the Active Idle,
which is intended for frequently used applications. From there, the widget
can be launched by navigating to its icon and selecting it. Users can also
set widgets to the active idle softkeys, so that they can be launched by pressing
the left of right softkey. In addition, users can move widgets into folders
that they have created themselves in the application menu.</p><div class="figure" id="GUID-8B6E5459-336A-47D9-8850-3BBBD094299E"><img src="GUID-AB95A8E1-584D-4A58-9500-FD578F91B1BB_d0e1208_href.png"/><p class="figure-title"><strong>Figure: </strong>A widget in Active Idle</p></div></div>
<div><h3>Adding widgets to the home screen</h3><p>Users can add
widgets to the home screen on <a href="GUID-1A3ECAC1-3F09-4602-A1CD-82164040A664.html#GUID-1A3ECAC1-3F09-4602-A1CD-82164040A664">compatible
devices</a>. Users cannot interact with a widget in home screen view. It
is a graphical representation of the widget that is for data display only.
The mobile device user must access the full screen view to make selections,
request specific data, and so on. For example, if a weather widget is added
to the home screen, the mobile device user must open it in full screen view
to change the location for local weather. For more information, see <a href="GUID-DA3E6868-F769-4576-A0C3-6776BF358B44.html#GUID-DA3E6868-F769-4576-A0C3-6776BF358B44">Introduction to home screen widgets</a>.</p><div class="figure" id="GUID-E38EBDE1-C97B-4A74-8E72-B59B71B46D5B"><img src="GUID-2A567315-DB83-4876-8E78-C3F1944CAB89_d0e1228_href.png"/><p class="figure-title"><strong>Figure: </strong>Widgets on the home screen</p></div></div>
</div></div></div><div class="footer"><hr/><div class="copy">© Nokia 2009.</div></div></body></html>