org.symbian.wrttools.doc.WRTKit/html/WRTKit_Using_text_entry_controls-GUID-76aeb0e3-698d-41de-a34b-8fea6d8e00d2.html
--- a/org.symbian.wrttools.doc.WRTKit/html/WRTKit_Using_text_entry_controls-GUID-76aeb0e3-698d-41de-a34b-8fea6d8e00d2.html Fri Mar 05 19:11:15 2010 -0800
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,125 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html lang="en" xml:lang="en">
-<head>
-<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
-<meta name="copyright" content="(C) Copyright 2005" />
-<meta name="DC.rights.owner" content="(C) Copyright 2005" />
-<meta content="concept" name="DC.Type" />
-<meta name="DC.Title" content="Using text entry controls" />
-<meta scheme="URI" name="DC.Relation" content="WRTKit_Common_WRTKit_tasks-GUID-24870895-4449-4307-9a54-7c90f7b3905e.html" />
-<meta content="XHTML" name="DC.Format" />
-<meta content="GUID-76AEB0E3-698D-41DE-A34B-8FEA6D8E00D2" name="DC.Identifier" />
-<meta content="en" name="DC.Language" />
-<link href="commonltr.css" type="text/css" rel="stylesheet" />
-<title>
-Using text entry controls</title>
-</head>
-<body id="GUID-76AEB0E3-698D-41DE-A34B-8FEA6D8E00D2"><a name="GUID-76AEB0E3-698D-41DE-A34B-8FEA6D8E00D2"><!-- --></a>
-
-
-
- <h1 class="topictitle1">
-Using text entry controls</h1>
-
- <div>
-
- <p>
-
- The WRTKit supports two controls for text entry: TextField for
- a single line of text and TextArea for multiple lines of text.
- The API for both controls is identical, except for the constructor.
- The TextField can be created in masked mode, which is useful for
- entry of text that should not be displayed (e.g. passwords). For
- every character that is typed in masked mode, an asterisk is shown
- instead in the text field. While a TextArea control can hold an
- unlimited number of lines of text, its height (as number of rows
- to display without scrolling) is specified when it is constructed.
- </p>
-
- <div class="fignone" id="GUID-76AEB0E3-698D-41DE-A34B-8FEA6D8E00D2__GUID-D4E1D422-DAB9-4F40-9A13-231B4ACF1FE5"><a name="GUID-76AEB0E3-698D-41DE-A34B-8FEA6D8E00D2__GUID-D4E1D422-DAB9-4F40-9A13-231B4ACF1FE5"><!-- --></a><span class="figcap">Figure 1.
-TextField and TextArea controls</span>
-
-
- <br /><img src="Text_Entry_Controls_Screenshot_1.png" /><br />
- </div>
-
- <p>
-
- TextField and TextArea controls are created and added to views like
- any other controls in the WRTKit. The code assumes that a view has
- already been created and that a variable called exampleView refers
- to it.
- </p>
-
-<pre>
-
-// create textfield
-var nameField = new TextField("field1", "Enter your name");
-exampleView.addControl(nameField);
-</pre>
-
- <p>
-
- "field1" is a unique identifier for the control and "Enter your
- name" is the control caption. An optional third argument to the
- constructor can be used to specify the text to display in the
- control, however the text can also be set at any time later on using
- the setText() method as follows:
- </p>
-
-<pre>
-
-// set the text in the textfield
-nameField.setText("John Smith");
-</pre>
-
- <p>
-
- The current text in a text entry control can be retrieved using the
- getText() method:
- </p>
-
-<pre>
-
-// get the current text from the textfield
-var text = nameField.getText();
-</pre>
-
- <p>
-
- Text entry controls fire "TextChanged" events when a user edits the
- text in a control. These events can be handled using by registering
- an event listener to the control. The code below shows what a
- typical callback function would look like:
- </p>
-
-<pre>
-
-// Callback function for text changed events.
-function nameChanged(event) {
- // implement what happens when the text changed here
-}
-</pre>
-
- <p>
-
- Registering the event listener function is done as follows, for
- example right after the control was created:
- </p>
-
-<pre>
-
-// register event listener
-nameField.addEventListener("TextChanged", nameChanged);
-</pre>
-
- </div>
-
-<div>
-<div class="familylinks">
-<div class="parentlink"><strong>Parent topic:</strong> <a href="WRTKit_Common_WRTKit_tasks-GUID-24870895-4449-4307-9a54-7c90f7b3905e.html">Common WRTKit tasks</a></div>
-</div>
-</div>
-
-</body>
-</html>
\ No newline at end of file