|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-2922758C-37A4-436E-B0F3-358944F84E2A" xml:lang="en"><title>Pop-up |
|
13 windows</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p>Certain UI components are displayed within pop-up windows. A common characteristic |
|
15 for all these components is that they are temporary states This means that |
|
16 typically back stepping from one state to the previous state does not lead |
|
17 into pop-up windows; they are skipped.</p> |
|
18 <table id="GUID-75280CEE-CE19-48CB-8B23-DB0A0295987B"><title>Pop-up components</title> |
|
19 <tgroup cols="2"><colspec colname="col1" colwidth="0.42*"/><colspec colname="col2" colwidth="1.58*"/> |
|
20 <thead> |
|
21 <row> |
|
22 <entry>Component</entry> |
|
23 <entry>Description</entry> |
|
24 </row> |
|
25 </thead> |
|
26 <tbody> |
|
27 <row> |
|
28 <entry><p>Options menu</p></entry> |
|
29 <entry><p>The commands and options that are available in the current context |
|
30 can be accessed via the <b>Options</b> menu. It is displayed as a list in |
|
31 a pop-up window.</p></entry> |
|
32 </row> |
|
33 <row> |
|
34 <entry><p>Query</p></entry> |
|
35 <entry><p>A query is a component where the software requests user input. All |
|
36 query components are displayed in pop-up windows. They consist of a prompt |
|
37 (possibly containing a graphical element) and some kind of an input component. |
|
38 Various types of queries exist: </p><ul> |
|
39 <li><p>A Confirmation query has either one or two possible input values, given |
|
40 by using the softkeys. </p></li> |
|
41 <li><p>A List query has a limited number of possible input values, and the |
|
42 user selects one from a list. </p></li> |
|
43 <li><p>A multi-selection List query has a limited number of possible input |
|
44 values, and the user can select zero, one or more of them in one pass. </p></li> |
|
45 <li><p>A Data query contains an input field for a numeric or alphanumeric |
|
46 value that the user can edit.</p></li> |
|
47 </ul></entry> |
|
48 </row> |
|
49 <row> |
|
50 <entry><p>Note</p></entry> |
|
51 <entry><p>A note is a feedback component that informs the user about the current |
|
52 situation. They contain a text and possibly a graphical element, and their |
|
53 layout is similar to a Confirmation query. However, the softkey labels do |
|
54 typically not exist, as notes do not require user input and by default they |
|
55 disappear within a time-out.</p></entry> |
|
56 </row> |
|
57 <row> |
|
58 <entry><p>Soft notification</p></entry> |
|
59 <entry><p>Soft notifications are reminders that inform the user of events |
|
60 that have typically occurred during the user's absence. Soft notifications |
|
61 can only be seen in the Idle state, and the user can acknowledge them. There |
|
62 are two types of soft notifications; the layouts resemble those of Confirmation |
|
63 queries and List queries: </p><ul> |
|
64 <li><p>A single soft notification contains one notification. </p></li> |
|
65 <li><p>A grouped soft notification contains a number of information items |
|
66 presented as a list, and a title text common to all of the items.</p></li> |
|
67 </ul></entry> |
|
68 </row> |
|
69 <row> |
|
70 <entry><p>Call window</p></entry> |
|
71 <entry><p>Incoming calls and outgoing calls are presented in pop-up windows.</p></entry> |
|
72 </row> |
|
73 </tbody> |
|
74 </tgroup> |
|
75 </table> |
|
76 <section id="GUID-58FB6AAA-5721-41D2-8593-D1117485563D"><title>Using |
|
77 pop-up windows in C++ applications</title><p>For implementation information |
|
78 on the pop-up window components, see:</p><ul> |
|
79 <li><p><xref href="GUID-BFEEECCA-190B-4DDE-8A04-4FE918BE8690.dita">Options menu</xref></p></li> |
|
80 <li><p><xref href="GUID-7B275129-5EF7-4B27-B603-3BDE2C650A93.dita">Query</xref></p></li> |
|
81 <li><p><xref href="GUID-24D51B0B-7EBE-49AE-84CF-098096BE0A1C.dita">Note</xref></p></li> |
|
82 <li><p><xref href="GUID-40F5B725-A5D7-487F-BF5D-A616F768F40D.dita">Soft notification</xref></p></li> |
|
83 </ul></section> |
|
84 </conbody></concept> |