<?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>

</tbody>

</tgroup>

</table>

<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>

</ul></section>