Symbian3/SDK/Source/GUID-2922758C-37A4-436E-B0F3-358944F84E2A.dita
changeset 0 89d6a7a84779
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-2922758C-37A4-436E-B0F3-358944F84E2A.dita	Thu Jan 21 18:18:20 2010 +0000
@@ -0,0 +1,84 @@
+<?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>
+</conbody></concept>
\ No newline at end of file