13 button</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
13 button</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
14 <p>Button is a generic component, which may have touch down and release and/or |
14 <p>Button is a generic component, which may have touch down and release and/or |
15 touch down and hold functionality. Touch down and hold can be interpreted |
15 touch down and hold functionality. Touch down and hold can be interpreted |
16 as touch down and hold or key repeat. Generic buttons can be placed, for example, |
16 as touch down and hold or key repeat. Generic buttons can be placed, for example, |
17 inside the toolbar. </p> |
17 inside the toolbar. </p> |
18 <p>The generic button can have the following properties:<ul> |
18 <p>The generic button can have properties such as ON/OFF button, Mode toggle |
19 <li><p><b>ON/OFF button</b> - it can be used for active/inactive type of functions |
19 button and Command button. For more details, see <xref href="GUID-EB212C35-5416-4CA7-8091-61B45D78E220.dita">Toolbar</xref>: </p> |
20 such as Loudspeaker or Font italics.</p></li> |
20 <fig id="GUID-3D7CD4D9-206C-462E-9C87-B7D73D39C810"> |
21 <li><p><b>Mode toggle button</b> - can be used for switching between several |
21 <image href="GUID-8AEE1966-D348-41BB-8513-61C379945DB8_d0e52168_href.png" placement="inline"/> |
22 modes as in Flash.</p></li> |
22 </fig> |
23 <li><p><b>Command button</b> - it offers direct action (functions/view access) |
|
24 such as Send or New contact with a button press feedback. </p></li> |
|
25 </ul> </p> |
|
26 <p>Buttons can have the following states:<ul> |
23 <p>Buttons can have the following states:<ul> |
27 <li><p><i>Unavailable / dimmed</i> when button function is not available</p></li> |
24 <li><p><i>Unavailable / dimmed</i> when button function is not available</p></li> |
28 <li><p><i>Available and not pressed with or without focus</i> when the button |
25 <li><p><i>Available and not pressed with or without focus</i> when the button |
29 is active but has not been pressed</p></li> |
26 is active but has not been pressed</p></li> |
30 <li><p><i>Latched down with or without focus</i>, for example, in case where |
27 <li><p><i>Latched down with or without focus</i>, for example, in case where |
54 <entry><p>Graphical indication and possible tooltip </p><p>Tactile: Basic |
50 <entry><p>Graphical indication and possible tooltip </p><p>Tactile: Basic |
55 button effect and audio feedback is provided with touch down.</p></entry> |
51 button effect and audio feedback is provided with touch down.</p></entry> |
56 </row> |
52 </row> |
57 <row> |
53 <row> |
58 <entry><p>Touch release</p></entry> |
54 <entry><p>Touch release</p></entry> |
59 <entry><p>Activates the button, launches other view or event. </p><p>Button |
55 <entry><p>Activates the button, launches another view or event. </p><p>Button |
60 is latched down or set to available and non-pressed.</p></entry> |
56 is latched down or set to available and non-pressed.</p></entry> |
61 <entry><p>Switches between down look and non-pressed look of the button.</p><p> When |
57 <entry><p>Switches between down look and non-pressed look of the button.</p><p> When |
62 the toolbar button launches another view or event, the button does not appear |
58 the toolbar button launches another view or event, the button does not appear |
63 latched down. </p><p>Tactile: Basic button effect is provided with touch release. |
59 latched down. </p><p>Tactile: Basic button effect is provided with touch release. |
64 No audio feedback is provided.</p></entry> |
60 No audio feedback is provided.</p></entry> |
65 </row> |
61 </row> |
66 <row> |
62 <row> |
67 <entry><p>Touch down on a multiple mode button</p></entry> |
63 <entry><p>Touch down on a multiple mode button.</p></entry> |
68 <entry><p>Button is pressed.</p></entry> |
64 <entry><p>Button is pressed.</p></entry> |
69 <entry><p>Tactile: Basic button effect and audio feedback is provided with |
65 <entry><p>Tactile: Basic button effect and audio feedback is provided with |
70 touch down.</p></entry> |
66 touch down.</p></entry> |
71 </row> |
67 </row> |
72 <row> |
68 <row> |
73 <entry><p>Touch release on a multiple mode button</p></entry> |
69 <entry><p>Touch release on a multiple mode button.</p></entry> |
74 <entry><p>Current mode’s function is executed.</p><p> User can switch between |
70 <entry><p>Current mode’s function is executed.</p><p> User can switch between |
75 different modes by touching the multiple mode button again. State changes |
71 different modes by touching the multiple mode button again. State changes |
76 after touch release and current mode’s functions are executed. Button states |
72 after touch release and current mode’s functions are executed. Button states |
77 loop when the user touches those again.</p></entry> |
73 loop when the user touches those again.</p></entry> |
78 <entry><p>Tactile: Basic button effect given with touch release. No audio |
74 <entry><p>Tactile: Basic button effect given with touch release. No audio |
79 feedback given.</p></entry> |
75 feedback given.</p></entry> |
80 </row> |
76 </row> |
81 <row> |
77 <row> |
82 <entry><p>Touch down and hold (also known as long tap)</p></entry> |
78 <entry><p>Touch down and hold (also known as long tap).</p></entry> |
83 <entry><p>Activates the button functionality, assigned for the touch down |
79 <entry><p>Activates the button functionality, assigned for the touch down |
84 and hold event. </p><p>Application specific</p></entry> |
80 and hold event. </p><p>Application specific.</p></entry> |
85 <entry><p>Tactile: Basic button effect and audio feedback is provided with |
81 <entry><p>Tactile: Basic button effect and audio feedback is provided with |
86 touch down event.</p></entry> |
82 touch down event.</p></entry> |
87 </row> |
83 </row> |
88 <row> |
84 <row> |
89 <entry><p>Touch down and hold (also known as key repeat</p></entry> |
85 <entry><p>Touch down and hold (also known as key repeat).</p></entry> |
90 <entry><p>May or may not have key repeat functionality</p><p>Application specific</p></entry> |
86 <entry><p>May or may not have key repeat functionality</p><p>Application specific.</p></entry> |
91 <entry><p>Tactile: Basic button effect is provide with touch down. In case |
87 <entry><p>Tactile: Basic button effect is provide with touch down. In case |
92 of key repeat, sensitive button effect is provided.</p></entry> |
88 of key repeat, sensitive button effect is provided.</p></entry> |
93 </row> |
89 </row> |
94 <row> |
90 <row> |
95 <entry><p>Touch down and move out from the button and releasing</p></entry> |
91 <entry><p>Touch down and move out from the button and releasing.</p></entry> |
96 <entry><p>If the drag moves outside the container, button functionality is |
92 <entry><p>If the drag moves outside the container, button functionality is |
97 canceled with release event.</p></entry> |
93 canceled with release event.</p></entry> |
98 <entry><p>Tactile: Basic button effect and audio feedback with touch down |
94 <entry><p>Tactile: Basic button effect and audio feedback with touch down |
99 is provided. No feedback with release.</p></entry> |
95 is provided. No feedback with release.</p></entry> |
100 </row> |
96 </row> |
101 <row> |
97 <row> |
102 <entry><p>Touch down and move out from the button and then back before up |
98 <entry><p>Touch down and move out from the button and then back before up |
103 event</p></entry> |
99 event.</p></entry> |
104 <entry><p>As in touch down and release.</p></entry> |
100 <entry><p>As in touch down and release.</p></entry> |
105 <entry><p>Tactile: Basic button effect and audio feedback is provided with |
101 <entry><p>Tactile: Basic button effect and audio feedback is provided with |
106 touch down. If release activates a function, then basic button effect is also |
102 touch down. If release activates a function, then basic button effect is also |
107 provided with touch release. No audio feedback with touch release.</p></entry> |
103 provided with touch release. No audio feedback with touch release.</p></entry> |
108 </row> |
104 </row> |
109 <row> |
105 <row> |
110 <entry><p>Touch down and move out from a button to another button and then |
106 <entry><p>Touch down and move out from a button to another button and then |
111 releasing</p></entry> |
107 releasing.</p></entry> |
112 <entry><p>If the drag goes outside the container, button functionality is |
108 <entry><p>If the drag goes outside the container, button functionality is |
113 canceled with release event and does not activate the other button.</p></entry> |
109 canceled with release event and does not activate the another button.</p></entry> |
114 <entry><p>Tactile: Basic button effect and audio feedback with touch down. |
110 <entry><p>Tactile: Basic button effect and audio feedback with touch down. |
115 No feedback with release.</p></entry> |
111 No feedback with release.</p></entry> |
116 </row> |
112 </row> |
117 </tbody> |
113 </tbody> |
118 </tgroup> |
114 </tgroup> |
119 </table> |
115 </table> |
120 <section id="GUID-6A8BFD02-3F77-4C95-BFC4-180D2DD211EF"><title>Using generic |
116 <section id="GUID-6A8BFD02-3F77-4C95-BFC4-180D2DD211EF"><title>Using generic |
121 buttons in C++ applications</title>The API to use for creating the generic |
117 buttons in applications</title>The API to use for creating the generic button |
122 button component is the <xref href="GUID-F3EE1000-71A6-4D48-A30B-3D2357BF20FB.dita">Generic |
118 component is the <xref href="GUID-F3EE1000-71A6-4D48-A30B-3D2357BF20FB.dita">Generic |
123 Button API</xref>. </section> |
119 Button API</xref>. </section> |
124 </conbody></concept> |
120 </conbody></concept> |