Symbian3/SDK/Source/GUID-2922758C-37A4-436E-B0F3-358944F84E2A.dita
author Dominic Pinkman <dominic.pinkman@nokia.com>
Fri, 11 Jun 2010 12:39:03 +0100
changeset 8 ae94777fff8f
parent 7 51a74ef9ed63
child 13 48780e181b38
permissions -rw-r--r--
Week 23 contribution of SDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.

<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-2922758C-37A4-436E-B0F3-358944F84E2A" xml:lang="en"><title>Pop-up
windows</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>Certain UI components are displayed within pop-up windows. A common characteristic
for all these components is that they are temporary states  This means that
typically back stepping from one state to the previous state does not lead
into pop-up windows; they are skipped.</p>
<table id="GUID-75280CEE-CE19-48CB-8B23-DB0A0295987B"><title>Pop-up components</title>
<tgroup cols="2"><colspec colname="col1" colwidth="0.42*"/><colspec colname="col2" colwidth="1.58*"/>
<thead>
<row>
<entry>Component</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry><p>Options menu</p></entry>
<entry><p>The commands and options that are available in the current context
can be accessed via the <b>Options</b> menu. It is displayed as a list in
a pop-up window.</p></entry>
</row>
<row>
<entry><p>Query</p></entry>
<entry><p>A query is a component where the software requests user input. All
query components are displayed in pop-up windows. They consist of a prompt
(possibly containing a graphical element) and some kind of an input component.
Various types of queries exist: </p><ul>
<li><p>A Confirmation query has either one or two possible input values, given
by using the softkeys. </p></li>
<li><p>A List query has a limited number of possible input values, and the
user selects one from a list. </p></li>
<li><p>A multi-selection List query has a limited number of possible input
values, and the user can select zero, one or more of them in one pass. </p></li>
<li><p>A Data query contains an input field for a numeric or alphanumeric
value that the user can edit.</p></li>
</ul></entry>
</row>
<row>
<entry><p>Note</p></entry>
<entry><p>A note is a feedback component that informs the user about the current
situation. They contain a text and possibly a graphical element, and their
layout is similar to a Confirmation query. However, the softkey labels do
typically not exist, as notes do not require user input and by default they
disappear within a time-out.</p></entry>
</row>
<row>
<entry><p>Soft notification</p></entry>
<entry><p>Soft notifications are reminders that inform the user of events
that have typically occurred during the user's absence. Soft notifications
can only be seen in the home screen, and the user can acknowledge them. There
are two types of soft notifications; the layouts resemble those of Confirmation
queries and List queries: </p><ul>
<li><p>A single soft notification contains one notification. </p></li>
<li><p>A grouped soft notification contains a number of information items
presented as a list, and a title text common to all of the items.</p></li>
</ul></entry>
</row>
<row>
<entry><p>Call window</p></entry>
<entry><p>Incoming calls and outgoing calls are presented in pop-up windows.</p></entry>
</row>
<row>
<entry><p>Discreet pop-up</p></entry>
<entry><p>Discreet pop-up is a temporary pop-up that appears on the upper
left corner for certain time-out. When discreet pop-up appears, it does not
dim the background and it does not have the focus. User can navigate in the
underlying application normally.</p><p>Pop-up can have simple touch functionality.
It can be used, for example, for the information and confirmation note.</p></entry>
</row>
<row>
<entry><p>Universal indicator pop-up</p></entry>
<entry><p>Universal indicator pop-up is opened from the universal indicator
pane. It contains more information of the active status indicators.</p></entry>
</row>
</tbody>
</tgroup>
</table>
<p>For more information, see <xref href="GUID-3A923665-D003-461B-9332-28689CFB39E5.dita">Pop-ups</xref></p>
<section id="GUID-58FB6AAA-5721-41D2-8593-D1117485563D"><title>Using
pop-up windows in applications</title><p>For implementation information on
the pop-up window components, see:</p><ul>
<li><p><xref href="GUID-BFEEECCA-190B-4DDE-8A04-4FE918BE8690.dita">Options menu</xref></p></li>
<li><p><xref href="GUID-7B275129-5EF7-4B27-B603-3BDE2C650A93.dita">Query</xref></p></li>
<li><p><xref href="GUID-24D51B0B-7EBE-49AE-84CF-098096BE0A1C.dita">Note</xref></p></li>
<li><p><xref href="GUID-40F5B725-A5D7-487F-BF5D-A616F768F40D.dita">Soft notification</xref></p></li>
<li><p><xref href="GUID-5B9F25B5-5FE1-4E38-BC8D-A0273F458C36.dita">Discreet pop-up</xref></p></li>
<li><p><xref href="GUID-EC98E7E0-872D-467D-BDC8-6471F6165705.dita">Universal indicator
pop-up</xref></p></li>
</ul></section>
</conbody></concept>