|
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-B35E6CAD-C9C8-467E-85CF-9781DEC8BF7C" xml:lang="en"><title>Text |
|
13 editing</title><shortdesc>This section describes the common principles of text editing, focusing |
|
14 on Latin based scripts. Requirements of other writing systems and input methods, |
|
15 such as those used for Chinese or Arabic, are not covered in detail.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
16 <p>Character input is accomplished using the keyboard. S60 supports both a |
|
17 full QWERTY keyboard and the ITU-T standard for numeric keypads. It specifies |
|
18 the mapping of Latin (English) characters to the keys, assigning three or |
|
19 four letters to each Numeric key from 2 to 9. The input of a specific character |
|
20 can happen either by repeated key presses within a time-out, or using some |
|
21 language-specific algorithm that tries to find the correct characters according |
|
22 to the produced key sequence.</p> |
|
23 <p>For more information on text input on touch devices, see <xref href="GUID-57B7DA8C-A62F-4C65-B754-47D9F5E76416.dita">Text |
|
24 input</xref>.</p> |
|
25 <p>Some keys, such as the star (*), hash (#) key, clear key, and edit key, |
|
26 have specific functions assigned to them during text editing. The functions |
|
27 depend on the keyboard type (ITU-T or QWERTY) and whether text prediction |
|
28 or multitapping mode is active. The four available modes are:</p> |
|
29 <ul> |
|
30 <li><p>ITU-T inmultitapping mode</p></li> |
|
31 <li><p>ITU-T with text prediction on</p></li> |
|
32 <li><p>QWERTY keyboard with text prediction on</p></li> |
|
33 <li><p>QWERTY keyboard with text prediction off</p></li> |
|
34 </ul> |
|
35 <table id="GUID-BFD539DB-0C98-4FAF-85CC-63EC012C9F48"><title>Specific key |
|
36 functions on ITU-T keypad</title> |
|
37 <tgroup cols="2"><colspec colname="col1"/><colspec colname="col2"/> |
|
38 <thead> |
|
39 <row> |
|
40 <entry><p>Key</p></entry> |
|
41 <entry><p>Function on ITU-T keypad</p></entry> |
|
42 </row> |
|
43 </thead> |
|
44 <tbody> |
|
45 <row> |
|
46 <entry><p>Numeric key 1</p></entry> |
|
47 <entry><p>Punctuation. The most used punctuation characters are available |
|
48 using repeated key presses within a time-out.</p></entry> |
|
49 </row> |
|
50 <row> |
|
51 <entry><p>Star (*) key</p></entry> |
|
52 <entry><p>In the alpha mode, offers the next match in Predictive Text input. |
|
53 In the alpha mode, a long press opens the special characters table, where |
|
54 the complete set of punctuation and other characters are displayed. One character |
|
55 can be picked at a time with Selection key. It is also possible to feed in |
|
56 more than one character without having to re-open the list by pressing 5 on |
|
57 the desired characters one after another and completing the selection by pressing |
|
58 Selection key on the last item. In a typical number mode, produces a * character, |
|
59 repeated presses produce other characters allowed within phone numbers: +, |
|
60 p, w.</p><p>In devices with no Edit key, a short press of the Star (*) key |
|
61 opens the editing menu and a long press opens the special characters table.</p></entry> |
|
62 </row> |
|
63 <row> |
|
64 <entry><p>Hash (#) key</p></entry> |
|
65 <entry><p>In the alpha mode, changes the character case (upper case, lower |
|
66 case, text case). In a typical number mode, produces a # character.In devices |
|
67 with no Edit key, a short press changes the current case and the text prediction |
|
68 mode (on/off), and a long key press (together with the Arrow keys) selects |
|
69 text.</p></entry> |
|
70 </row> |
|
71 <row> |
|
72 <entry><p>Clear key</p></entry> |
|
73 <entry><p>Clears the previous character from the cursor. In case more characters |
|
74 are selected, clears all the selected characters.</p></entry> |
|
75 </row> |
|
76 <row> |
|
77 <entry><p>Edit key </p></entry> |
|
78 <entry><p>Press and release: opens the editing menu (see <xref href="GUID-2E0F793F-3D80-4303-AF48-C7341F417DC9.dita">Editing |
|
79 menu</xref>). Selects characters when pressed simultaneously with the Arrow |
|
80 keys (see <xref href="GUID-C7D026AF-9C07-4221-AEDE-8CC0654A9D57.dita">Selecting |
|
81 text</xref>).</p></entry> |
|
82 </row> |
|
83 </tbody> |
|
84 </tgroup> |
|
85 </table> |
|
86 <section id="GUID-BD3EF056-DE12-4500-8924-22427DAE2100"><title>Using |
|
87 text editing in C++ applications</title><p>The API to use for providing text |
|
88 editing functionality is the <xref format="html" href="specs/guides/Editors_API_Specification/Editors_API_Specification.html" scope="peer">Editors API</xref>. For implementation information, see <xref format="html" href="specs/guides/Editors_API_Specification/Editors_API_Specification.html#Editors_API_Specification.topic3" scope="peer">Using the Editors API</xref>.</p></section> |
|
89 </conbody></concept> |