|
1 <?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"> |
|
2 <html lang="en" xml:lang="en"> |
|
3 <head> |
|
4 <meta content="text/html; charset=utf-8" http-equiv="Content-Type" /> |
|
5 <meta name="copyright" content="(C) Copyright 2005" /> |
|
6 <meta name="DC.rights.owner" content="(C) Copyright 2005" /> |
|
7 <meta content="concept" name="DC.Type" /> |
|
8 <meta name="DC.Title" content="Text entry" /> |
|
9 <meta scheme="URI" name="DC.Relation" content="WRTKit_Developing_widgets_using_the_WRTKit-GUID-a321db96-0a01-4e55-b24b-96905f40cb5c.html" /> |
|
10 <meta content="XHTML" name="DC.Format" /> |
|
11 <meta content="GUID-B52E3343-5A39-4A83-AE97-461A53761207" name="DC.Identifier" /> |
|
12 <meta content="en" name="DC.Language" /> |
|
13 <link href="commonltr.css" type="text/css" rel="stylesheet" /> |
|
14 <title> |
|
15 Text entry</title> |
|
16 </head> |
|
17 <body id="GUID-B52E3343-5A39-4A83-AE97-461A53761207"><a name="GUID-B52E3343-5A39-4A83-AE97-461A53761207"><!-- --></a> |
|
18 |
|
19 |
|
20 |
|
21 <h1 class="topictitle1"> |
|
22 Text entry</h1> |
|
23 |
|
24 <div> |
|
25 |
|
26 <p> |
|
27 |
|
28 The WRTKit has two controls for text entry needs. For situations when only a |
|
29 single line of text is needed there's the TextField control. The TextField |
|
30 control supports "masked text entry", meaning that any text that is entered into |
|
31 the control is masked so it cannot be read. The mask is implemented so that |
|
32 every typed character is shown as an asterisk (*) character. |
|
33 </p> |
|
34 |
|
35 <p> |
|
36 |
|
37 When longer or multi-line text entry is needed, the TextArea control |
|
38 can be used instead of the single-line TextField. The TextArea size |
|
39 can be defined in number of rows when the control is created. If the |
|
40 argument for rows is omitted a default of 3 rows will be used. |
|
41 Longer text can still be entered - the size refers to number of rows |
|
42 that are visible without scrolling. Note that TextArea controls do |
|
43 not support masked text entry. |
|
44 </p> |
|
45 |
|
46 <div class="fignone" id="GUID-B52E3343-5A39-4A83-AE97-461A53761207__GUID-F9A88AF0-067A-43EC-8C0B-7E0B092A6850"><a name="GUID-B52E3343-5A39-4A83-AE97-461A53761207__GUID-F9A88AF0-067A-43EC-8C0B-7E0B092A6850"><!-- --></a><span class="figcap">Figure 1. |
|
47 TextField and TextArea controls</span> |
|
48 |
|
49 |
|
50 <br /><img src="Text_Entry_Controls_Screenshot_1.png" /><br /> |
|
51 </div> |
|
52 |
|
53 <p> |
|
54 |
|
55 The text in TextField and TextArea controls can be retrieved and set using |
|
56 getter and setter methods. |
|
57 </p> |
|
58 |
|
59 <p> |
|
60 |
|
61 Text entry controls fire "TextChanged" events when the user edits the text in |
|
62 the control. |
|
63 </p> |
|
64 |
|
65 </div> |
|
66 |
|
67 <div> |
|
68 <div class="familylinks"> |
|
69 <div class="parentlink"><strong>Parent topic:</strong> <a href="WRTKit_Developing_widgets_using_the_WRTKit-GUID-a321db96-0a01-4e55-b24b-96905f40cb5c.html">Developing widgets using the WRTKit</a></div> |
|
70 </div> |
|
71 </div> |
|
72 |
|
73 </body> |
|
74 </html> |