org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-1666F263-F1CB-4928-B2A7-E518B43983BA.html
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/><meta name="copyright" content="(C) Copyright 2009"/><meta name="DC.rights.owner" content="(C) Copyright 2009"/><meta name="DC.Type" content="concept"/><meta name="DC.Title" content="Handling text input"/><meta name="abstract" content="You can use HTML tags to create text boxes in widgets. The text boxes are mapped to an S60 text box component. The S60 platform interprets the key and character event and determines whether the input is given using the basic mobile device keyboard or a full keyboard and with or without predictive text input. To handle user input in text boxes, examine the textual input value."/><meta name="description" content="You can use HTML tags to create text boxes in widgets. The text boxes are mapped to an S60 text box component. The S60 platform interprets the key and character event and determines whether the input is given using the basic mobile device keyboard or a full keyboard and with or without predictive text input. To handle user input in text boxes, examine the textual input value."/><meta name="DC.Relation" scheme="URI" content="GUID-0EFEA51B-F98B-4C0B-9960-5D6247355ACA"/><meta name="DC.Relation" scheme="URI" content="GUID-C4B403C9-FA4D-47E2-821B-53FE7ACC33E3"/><meta name="DC.Relation" scheme="URI" content="GUID-D54DEFE7-E878-4530-B707-A5388DFE1D9D"/><meta name="DC.Relation" scheme="URI" content="GUID-6DD2B3D2-BA3B-4936-BBC9-F61B6757B6F8"/><meta name="DC.Relation" scheme="URI" content="GUID-13E2DE63-47E5-4E2A-85FF-C8B0CAB9D4DE"/><meta name="DC.Format" content="XHTML"/><meta name="DC.Identifier" content="GUID-1666F263-F1CB-4928-B2A7-E518B43983BA"/><title>Handling text input </title><script type="text/javascript">
function initPage() {}
</script><link href="../PRODUCT_PLUGIN/book.css" rel="stylesheet" type="text/css"/><link href="css/s60/style.css" rel="stylesheet" type="text/css" media="all"/></head><body onload="initPage();"><div class="body"><div class="contentLeft prTxt"><h1 class="pageHeading" id="GUID-1666F263-F1CB-4928-B2A7-E518B43983BA">Handling text input</h1><div><p>You can use HTML tags to create text boxes in widgets. The text boxes are mapped to an S60 text box component. The S60 platform interprets the key and character event and determines whether the input is given using the basic mobile device keyboard or a full keyboard and with or without predictive text input. To handle user input in text boxes, examine the textual input value.</p>
<div class="figure" id="GUID-BE9BB0BE-A725-438E-AA1E-E7B239CAA9D4"><img src="GUID-A566445D-26D1-460E-8B65-634245774B37_d0e3528_href.png"/><p class="figure-title"><strong>Figure: </strong>Text input field in a widget</p></div>
<p>When a text box is in editing mode, key events are absorbed by the widget engine. Therefore, widgets cannot instantly receive key events to detect which character users enter to the text box. This means that users must select the text box before they can type in it. You can use JavaScript to write a key map engine that detects key events to allow immediate input. This allows you to develop an instant search function where characters are detected immediately after users types them into the search field, for example. For an example of a key map engine, see <a href="http://wiki.forum.nokia.com/index.php/CS000943_-_WRT_NumKeyTranslator_Widget" target="_blank">WRT NumKeyTranslator Widget</a> on the Forum Nokia Wiki. </p>
<div><h3>To create text or input dialogs in your widget</h3><p>Use the <code><textarea></code> or <code><input type="text"></code> tag in the <a href="GUID-C294F32D-CAC7-499C-AD4B-701B9AB57ACA.html#GUID-C294F32D-CAC7-499C-AD4B-701B9AB57ACA">HTML file</a>, for example.</p></div>
</div></div></div><div class="footer"><hr/><div class="copy">© Nokia 2009.</div></div></body></html>