12 <concept id="GUID-48482288-B60B-477A-8E28-132F7CBE2C94" xml:lang="en"><title>Confirmation |
12 <concept id="GUID-48482288-B60B-477A-8E28-132F7CBE2C94" xml:lang="en"><title>Confirmation |
13 query</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
13 query</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
14 <p>A confirmation query requests the user to confirm an operation, or asks |
14 <p>A confirmation query requests the user to confirm an operation, or asks |
15 a Yes-No-type of question. It can be used e.g. to make sure that the user |
15 a Yes-No-type of question. It can be used e.g. to make sure that the user |
16 does not accidentally delete important information or start an operation which |
16 does not accidentally delete important information or start an operation which |
17 cannot be cancelled.</p> |
17 cannot be cancelled. A touch down and release on the query has no effect. |
|
18 Confirmation query cannot be dismissed by tapping outside.</p> |
18 <p>The layout for a Confirmation query is the same as the note layout, with |
19 <p>The layout for a Confirmation query is the same as the note layout, with |
19 an optional graphic item.</p> |
20 an optional graphic item.</p> |
20 <p>One or two softkey labels can be used. In case the query can cause two |
21 <p>One or two softkey labels can be used. In case the query can cause two |
21 different consequences, the positive choice (<b>Yes</b>) is placed on the |
22 different consequences, the positive choice (<b>Yes</b>) is placed on the |
22 left softkey, and the negative one (<b>No</b>) on the right softkey. In pure |
23 left softkey, and the negative one (<b>No</b>) on the right softkey. In pure |
23 confirmations, only one way to proceed is possible, and the response text |
24 confirmations, only one way to proceed is possible, and the response text |
24 (for example <b>OK</b>) is placed on the left softkey.</p> |
25 (for example <b>OK</b>) is placed on the left softkey.</p> |
25 <p>The Selection key always causes the same action as the left softkey.</p> |
26 <p>The Selection key always causes the same action as the left softkey.</p> |
26 <fig id="GUID-F5C18BD7-D656-4769-B841-C636628E9B1C"> |
27 <fig id="GUID-123C27EC-BC2D-4CC7-9E4D-015C6B2ABE1D"> |
27 <title>Confirmation query</title> |
28 <title>Confirmation query</title> |
28 <image href="GUID-0DEC4D1B-2CD6-49BC-92E4-F0CB0BCBFA9D_d0e68726_href.jpg" scale="40" placement="inline"/> |
29 <image href="GUID-1A905563-EF60-4A01-BC55-5B35904F96AB_d0e63486_href.png" placement="inline"/> |
29 </fig> |
30 </fig> |
30 <p>Guidelines for designing Confirmation queries:</p> |
31 <p>Guidelines for designing Confirmation queries:</p> |
31 <ul> |
32 <ul> |
32 <li><p>When designing the prompt text, make sure that the positive answer |
33 <li><p>When designing the prompt text, make sure that the positive answer |
33 is also a safe one. Users tend to proceed pressing the left softkey or the |
34 is also a safe one. Users tend to proceed pressing the left softkey or the |
34 Selection key without thinking too much. </p></li> |
35 Selection key without thinking too much. </p></li> |
35 <li><p>Redundant Confirmation queries should be avoided. Do not add a Confirmation |
36 <li><p>Redundant Confirmation queries should be avoided. Do not add a Confirmation |
36 query if there already are other forms of feedback, unless it is crucial that |
37 query if there already are other forms of feedback, unless it is crucial that |
37 the user gets a certain piece of information.</p></li> |
38 the user gets a certain piece of information.</p></li> |
38 </ul> |
39 </ul> |
39 <section><title>Using confirmation queries |
40 <section id="GUID-3EDD5DCB-58C7-4D15-A933-6E73F7F9B709"><title>Using |
40 in C++ applications</title><p>For implementation information, see <xref href="GUID-7B275129-5EF7-4B27-B603-3BDE2C650A93.dita">Queries</xref>.</p></section> |
41 confirmation queries in applications</title><p>For implementation |
|
42 information, see <xref href="GUID-7B275129-5EF7-4B27-B603-3BDE2C650A93.dita">Queries</xref>.</p></section> |
41 </conbody></concept> |
43 </conbody></concept> |