Symbian3/PDK/Source/GUID-57B7DA8C-A62F-4C65-B754-47D9F5E76416.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Tue, 30 Mar 2010 11:56:28 +0100
changeset 5 f345bda72bc4
parent 1 25a17d01db0c
child 9 59758314f811
permissions -rw-r--r--
Week 12 contribution of PDK documentation_content. See release notes for details. Fixes Bug 2054, Bug 1583, Bug 381, Bug 390, Bug 463, Bug 1897, Bug 344, Bug 1319, Bug 394, Bug 1520, Bug 1522, Bug 1892"

<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-57B7DA8C-A62F-4C65-B754-47D9F5E76416" xml:lang="en"><title>Text
input</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>There are several finger-optimized text input methods available for touch-enabled
devices. The available methods depend on the orientation of the device. The
following methods are available in the portrait orientation:</p>
<ul>
<li><p>Virtual ITU-T keyboard with text prediction</p></li>
<li><p>Handwriting recognition (HWR) for some language variants. Not available
for Latin languages.</p></li>
</ul>
<p>The following methods are available in the landscape orientation:</p>
<ul>
<li><p>Virtual QWERTY opened in full screen with input preview</p></li>
<li><p>Handwriting recognition</p></li>
</ul>
<p>The input methods that are available to mobile device users depend on the
product. Users can select the suitable input method for each situation from
the input methods that are included in the product. The device recalls the
last used method and offers it the next time when the user wants to input
something.</p>
<fig id="GUID-0A84FE47-C9D6-48AF-A4A5-F643342733F9">
<title>Virtual ITU-T keypad</title>
<image href="GUID-F7A17E65-CB2D-41D3-9404-1A7D7F55FABC_d0e103779_href.png" placement="inline"/>
</fig>
<fig id="GUID-A294F7A7-79E4-41E3-8456-9554FA23A3B4">
<title>Virtual QWERTY keyboard</title>
<image href="GUID-47AA7F26-FF3F-4FEE-BBB4-F4E8A8E0E335_d0e103787_href.png" placement="inline"/>
</fig>
<p>The virtual QWERTY keyboard displays a keyboard that has a collection of
basic keyboard functions (Shift, Caps lock, punctuation marks, and so on)
and a text field where the user can see the given input without having to
follow it from the editor field. The handwriting recognition allows user to
write characters on the screen with a finger.</p>
<p>If touch input has been launched from an editor, pressing any hardware
character key closes the touch input. This also applies to hybrid devices
having both a hardware and virtual keyboard. Activating the hardware keyboard
character key closes the virtual keyboard. Touch input never starts up automatically
(that is, a change of view does not launch it), but the user has to launch
it by tapping the editing field. Moving the focus onto an editing field with
the hardware keys does not launch touch input.</p>
<section id="GUID-122BA229-0C5D-47C7-ABDE-4C6279B79FFD"><title>Using
touch-based text input in C++ applications</title><p>AVKON editor components
support touch-based text input.</p><p>The API to use for providing touch-based
text input 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>
</conbody></concept>