Symbian3/PDK/Source/GUID-2922758C-37A4-436E-B0F3-358944F84E2A.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Tue, 30 Mar 2010 11:56:28 +0100
changeset 5 f345bda72bc4
parent 3 46218c8b8afa
child 9 59758314f811
permissions -rw-r--r--
Week 12 contribution of PDK documentation_content. See release notes for details. Fixes Bug 2054, Bug 1583, Bug 381, Bug 390, Bug 463, Bug 1897, Bug 344, Bug 1319, Bug 394, Bug 1520, Bug 1522, Bug 1892"

<?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 Idle state, 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 C++ 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>