7 Nokia Corporation - initial contribution. |
7 Nokia Corporation - initial contribution. |
8 Contributors: |
8 Contributors: |
9 --> |
9 --> |
10 <!DOCTYPE concept |
10 <!DOCTYPE concept |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 <concept id="GUID-13DEE42F-3EAB-4EB7-9CE1-C4930BCACE01" xml:lang="en"><title>List query</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
12 <concept id="GUID-13DEE42F-3EAB-4EB7-9CE1-C4930BCACE01" xml:lang="en"><title>List |
|
13 query</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
13 <p>A List query offers a list of predefined choices for the user. It can be |
14 <p>A List query offers a list of predefined choices for the user. It can be |
14 used when more than two options must be offered to the user. There is a prompt |
15 used when more than two options must be offered to the user. There is a prompt |
15 text (optional) on top of the window, and a list of options to choose from.</p> |
16 text (optional) on top of the window, and a list of options to choose from.</p> |
16 <p>The list in a List query is a menu list: the user can select an item or |
17 <p>The list in a List query is a menu list: the user can select an item or |
17 dismiss the query; the Options menu is not available. The default softkey |
18 dismiss the query; the Options menu is not available. The default softkey |
18 labels are OK on the left and Cancel on the right, the actual texts can be |
19 labels are OK on the left and Cancel on the right, the actual texts can be |
19 specific to the context. The Selection key causes the same action as the left |
20 specific to the context. The Selection key causes the same action as the left |
20 softkey.</p> |
21 softkey.</p> |
21 <p>Any list item layout suitable for menu lists can be used; see <xref href="GUID-CB548959-A1D6-4585-B8E3-B09E37E0CB43.dita">List |
22 <p>Any list item layout suitable for menu lists can be used; see <xref href="GUID-CB548959-A1D6-4585-B8E3-B09E37E0CB43.dita">List |
22 layouts</xref>.</p> |
23 layouts</xref>.</p> |
23 <fig id="GUID-C40BEE37-FF71-442B-A1CF-7E6CCA2157F6"> |
24 <fig id="GUID-A44481C9-82CA-46DE-8D54-1BCC033A8CAB"> |
24 <title>List query </title> |
25 <title>List query </title> |
25 <image href="GUID-84B088C0-7013-4B6A-BA34-8F022E38E822_d0e68775_href.png" scale="40" placement="inline"/> |
26 <image href="GUID-431119D1-1B55-4503-905E-6E290FA241CE_d0e63537_href.png" placement="inline"/> |
26 </fig> |
27 </fig> |
27 <p>The number of items in the list should be kept low, so that all items can |
28 <p>The number of items in the list should be kept low, so that all items can |
28 be seen without scrolling.</p> |
29 be seen without scrolling.</p> |
29 <section><title>Using list queries in |
30 <section id="GUID-79EFB689-9545-473D-A843-C9283F1D1091"><title>Using |
30 C++ applications</title><p>For implementation information, see <xref href="GUID-7B275129-5EF7-4B27-B603-3BDE2C650A93.dita">Queries</xref>.</p></section> |
31 list queries in applications</title><p>For implementation information, |
|
32 see <xref href="GUID-7B275129-5EF7-4B27-B603-3BDE2C650A93.dita">Queries</xref>.</p></section> |
31 </conbody></concept> |
33 </conbody></concept> |