1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
|
<html>
<head>
<title>
Handbuch der Java-Programmierung, 5. Auflage
</title>
</head>
<body>
<a name="startofbody"></a>
<script language="JavaScript" src="hjp4lib.js">
</script>
<script language="JavaScript">
installKbdHandler("97,#startofbody;101,#endofbody;116,cover.html;122,k100003.html;115,search.html;105,index.html;100,JDKDOCS;112,APIDOCS;104,k100206.html;106,k100212.html;107,k100214.html;108,k100219.html");
</script>
<table border=0 cellpadding=0 cellspacing=1 width="100%">
<tr bgcolor="#EEFFCC">
<td width="7%" align=center bgcolor="#DDCC99"><a href="cover.html"> Titel </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100003.html"> Inhalt </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="search.html"> Suchen </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="index.html"> Index </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="../jdkdocs/index.html" onClick="this.href=getDocIndex()"> DOC </a>
<td align="right">Handbuch der Java-Programmierung, 5. Auflage
<tr bgcolor="#EEFFCC">
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100206.html"> << </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100212.html"> < </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100214.html"> > </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100219.html"> >> </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="../jdkdocs/api/index.html" onClick="this.href=getApiIndex()"> API </a>
<td align="right">Kapitel 32 - AWT-Dialogelemente
</table>
<hr>
<!-- Section -->
<a name="sectlevel2id032007"></a>
<h2>32.7 TextArea </h2>
<hr>
<ul>
<li><a href="k100213.html#sectlevel2id032007">32.7 TextArea</a>
</ul>
<hr>
<p>
Im Gegensatz zur Klasse <a href="index_t.html#ixb101473"><font color=#000080><tt>TextField</tt></font></a>,
bei der der Text auf eine einzige Zeile beschränkt ist, können
mit der Klasse <a name="ixa102214"><a href="index_t.html#ixb101489"><font color=#000080><tt>TextArea</tt></font></a></a>
mehrzeilige Textfelder erzeugt werden. Zusätzlich kann der Text
in alle Richtungen scrollen, so dass auch größere Texte
bearbeitet werden können.
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public TextArea()
public TextArea(int rows, int cols)
public TextArea(String text)
public TextArea(String text, int rows, int cols)
public TextArea(String text, int rows, int cols, int scroll)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/java/awt/TextArea.html" onClick="this.href=getApiDoc('java.awt.TextArea')"><font color="#660066" size=-1>java.awt.TextArea</font></a></td>
</tr>
</table>
<p>
Der parameterlose Konstruktor erzeugt ein leeres <a href="index_t.html#ixb101489"><font color=#000080><tt>TextArea</tt></font></a>-Objekt
in einer vom System vorgegebenen Größe. Werden die Parameter
<font color="#000077"><tt>rows</tt></font> und <font color="#000077"><tt>cols</tt></font>
vorgegeben, legen sie die Anzahl der sichtbaren Zeilen und Spalten
fest. Mit dem Parameter <font color="#000077"><tt>text</tt></font>
kann die zu editierende Zeichenkette übergeben werden. Mit Hilfe
des zusätzlichen Parameters <font color="#000077"><tt>scroll</tt></font>
kann die Ausstattung der <a href="index_t.html#ixb101489"><font color=#000080><tt>TextArea</tt></font></a>
mit Schiebereglern festgelegt werden. Dazu stellt <a href="index_t.html#ixb101489"><font color=#000080><tt>TextArea</tt></font></a>
die Konstanten <a name="ixa102215"><a href="index_s.html#ixb101666"><font color=#000080><tt>SCROLLBARS_BOTH</tt></font></a></a>,
<a name="ixa102216"><a href="index_s.html#ixb101667"><font color=#000080><tt>SCROLLBARS_VERTICAL_ONLY</tt></font></a></a>,
<a name="ixa102217"><a href="index_s.html#ixb101668"><font color=#000080><tt>SCROLLBARS_HORIZONTAL_ONLY</tt></font></a></a>
und <a name="ixa102218"><a href="index_s.html#ixb101669"><font color=#000080><tt>SCROLLBARS_NONE</tt></font></a></a>
zur Verfügung, die als Argument übergeben werden können.
<p>
Ebenso wie <a href="index_t.html#ixb101473"><font color=#000080><tt>TextField</tt></font></a>
ist auch <a href="index_t.html#ixb101489"><font color=#000080><tt>TextArea</tt></font></a>
aus der Klasse <a href="index_t.html#ixb101653"><font color=#000080><tt>TextComponent</tt></font></a>
abgeleitet und besitzt mit Ausnahme von <a href="index_s.html#ixb101665"><font color=#000080><tt>setEchoCharacter</tt></font></a>
und <a name="ixa102219"><a href="index_g.html#ixb101670"><font color=#000080><tt>getEchoCharacter</tt></font></a></a>
alle Methoden, die bereits bei <a href="index_t.html#ixb101473"><font color=#000080><tt>TextField</tt></font></a>
vorgestellt wurden. Zusätzlich gibt es einige Methoden, mit denen
Teile des Textes verändert werden können:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public void insert(String str, int pos)
public void append(String str)
public void replaceRange(String text, int start, int end)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/java/awt/TextArea.html" onClick="this.href=getApiDoc('java.awt.TextArea')"><font color="#660066" size=-1>java.awt.TextArea</font></a></td>
</tr>
</table>
<p>
Mit <a name="ixa102220"><a href="index_i.html#ixb100547"><font color=#000080><tt>insert</tt></font></a></a>
wird die Zeichenkette <font color="#000077"><tt>str</tt></font> an
der Position <font color="#000077"><tt>pos</tt></font> eingefügt,
und der dahinter stehende Text wird entsprechend nach hinten geschoben.
<a name="ixa102221"><a href="index_a.html#ixb100546"><font color=#000080><tt>append</tt></font></a></a>
hängt den als Argument übergebenen Text hinten an den bestehenden
Text an, und <a name="ixa102222"><a href="index_r.html#ixb101671"><font color=#000080><tt>replaceRange</tt></font></a></a>
ersetzt den Text zwischen <font color="#000077"><tt>start</tt></font>
und <font color="#000077"><tt>end</tt></font> durch die übergebene
Zeichenkette <font color="#000077"><tt>text</tt></font>.
<p>
Ein Objekt der Klasse <a href="index_t.html#ixb101489"><font color=#000080><tt>TextArea</tt></font></a>
sendet Text-Events, so wie es bei <a href="index_t.html#ixb101473"><font color=#000080><tt>TextField</tt></font></a>
beschrieben wurde. Action-Events werden dagegen nicht gesendet, denn
die ENTER-Taste erzeugt eine Zeilenschaltung. Ein zum folgenden Beispiel
passender Event-Handler könnte so realisiert werden:
<a name="listingid032009"></a>
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#DDDDDD">
<tr>
<td valign=top>
<font color="#000055">
<pre>
<font color="#555555">001 </font><font color="#00AA00">/* TextArea2.inc */</font>
<font color="#555555">002 </font>
<font color="#555555">003 </font><font color="#0000AA">public</font> <font color="#006699">void</font> textValueChanged(TextEvent event)
<font color="#555555">004 </font>{
<font color="#555555">005 </font> TextArea tf = (TextArea)event.getSource();
<font color="#555555">006 </font> System.out.println(<font color="#0000FF">"textValueChanged: "</font>+tf.getText());
<font color="#555555">007 </font>}</pre>
</font>
</td>
<td valign=top align=right>
<a href="../examples/TextArea2.inc"><font color="#000055" size=-1>TextArea2.inc</font></a></td>
</tr>
</table>
<i>
Listing 32.9: Behandlung von Text-Events bei der Komponente TextArea</i></p>
<p>
Das Beispielprogramm zum Testen der <a href="index_t.html#ixb101489"><font color=#000080><tt>TextArea</tt></font></a>-Komponente
sieht so aus:
<a name="listingid032010"></a>
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#DDDDDD">
<tr>
<td valign=top>
<font color="#000055">
<pre>
<font color="#555555">001 </font><font color="#00AA00">/* TextArea1.inc */</font>
<font color="#555555">002 </font>
<font color="#555555">003 </font><font color="#0000AA">private</font> <font color="#006699">void</font> customizeLayout(Panel panel)
<font color="#555555">004 </font>{
<font color="#555555">005 </font> panel.setLayout(<font color="#0000AA">new</font> FlowLayout(FlowLayout.LEFT));
<font color="#555555">006 </font> TextArea ta = <font color="#0000AA">new</font> TextArea(10,40);
<font color="#555555">007 </font> ta.addTextListener(<font color="#006699">this</font>);
<font color="#555555">008 </font> panel.add(ta);
<font color="#555555">009 </font>}</pre>
</font>
</td>
<td valign=top align=right>
<a href="../examples/TextArea1.inc"><font color="#000055" size=-1>TextArea1.inc</font></a></td>
</tr>
</table>
<i>
Listing 32.10: Verwendung einer TextArea-Komponente</i></p>
<p>
<a name="imageid032007"></a>
<img src="images/TextArea.gif">
<p>
<p><i>
Abbildung 32.7: Ein Dialog mit einem TextArea-Objekt</i></p>
<hr>
<table border=0 cellpadding=0 cellspacing=1 width="100%">
<tr bgcolor="#EEFFCC">
<td width="7%" align=center bgcolor="#DDCC99"><a href="cover.html"> Titel </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100003.html"> Inhalt </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="search.html"> Suchen </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="index.html"> Index </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="../jdkdocs/index.html" onClick="this.href=getDocIndex()"> DOC </a>
<td align="right">Handbuch der Java-Programmierung, 5. Auflage, Addison
Wesley, Version 5.0.1
<tr bgcolor="#EEFFCC">
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100206.html"> << </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100212.html"> < </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100214.html"> > </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100219.html"> >> </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="../jdkdocs/api/index.html" onClick="this.href=getApiIndex()"> API </a>
<td align="right">© 1998, 2007 Guido Krüger & Thomas
Stark, <a href="http://www.javabuch.de">http://www.javabuch.de</a>
</table>
<a name="endofbody"></a>
</body>
</html>
|
