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
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
|
<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,k100211.html;107,k100213.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="k100211.html"> < </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100213.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="textfield"></a>
<h2>32.6 TextField </h2>
<hr>
<ul>
<li><a href="k100212.html#textfield">32.6 TextField</a>
</ul>
<hr>
<p>
Ein <a name="ixa102191"><a href="index_t.html#ixb101473"><font color=#000080><tt>TextField</tt></font></a></a>
dient zur Darstellung und zur Eingabe von Text. Sowohl der Anwender
als auch das Programm können den dargestellten Text auslesen
und verändern.
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public TextField()
public TextField(int width)
public TextField(String text)
public TextField(String text, int width)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/java/awt/TextField.html" onClick="this.href=getApiDoc('java.awt.TextField')"><font color="#660066" size=-1>java.awt.TextField</font></a></td>
</tr>
</table>
<p>
Der parameterlose Konstruktor erzeugt ein leeres Textfeld, in das
der Anwender beliebig viel Text eingeben kann. Wird mit <font color="#000077"><tt>width</tt></font>
die Breite des Textfeldes vorgegeben, so beschränkt sich die
Anzahl der auf dem Bildschirm angezeigten Zeichen auf den angegebenen
Wert. Die Anzahl <i>einzugebender</i> Zeichen wird allerdings nicht
begrenzt. Ist der Text länger, scrollt er innerhalb des Textfelds.
Mit dem Parameter <font color="#000077"><tt>text</tt></font> kann
eine Zeichenkette vorgegeben werden, die beim Aufruf des Textfeldes
vorgelegt wird.
<p>
Die Klasse <font color="#000077"><tt>Textfield</tt></font> ist aus
<a name="ixa102192"><a href="index_t.html#ixb101653"><font color=#000080><tt>TextComponent</tt></font></a></a>
abgeleitet. Sie besitzt eine ganze Reihe von Methoden, mit denen es
möglich ist, auf den Text zuzugreifen oder die Eigenschaften
des Textfeldes zu verändern. Die Methoden <a name="ixa102193"><a href="index_g.html#ixb101645"><font color=#000080><tt>getText</tt></font></a></a>
und <a name="ixa102194"><a href="index_s.html#ixb101644"><font color=#000080><tt>setText</tt></font></a></a>
werden zum Lesen und Verändern des Textes verwendet:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public String getText()
public void setText(String text)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/java/awt/TextField.html" onClick="this.href=getApiDoc('java.awt.TextField')"><font color="#660066" size=-1>java.awt.TextField</font></a></td>
</tr>
</table>
<p>
Mit <a name="ixa102195"><a href="index_g.html#ixb101654"><font color=#000080><tt>getColumns</tt></font></a></a>
kann die Anzahl der darstellbaren Zeichen des Textfeldes abgefragt
und mit <a name="ixa102196"><a href="index_s.html#ixb101655"><font color=#000080><tt>setColumns</tt></font></a></a>
verändert werden:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public int getColumns()
public void setColumns(int columns)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/java/awt/TextField.html" onClick="this.href=getApiDoc('java.awt.TextField')"><font color="#660066" size=-1>java.awt.TextField</font></a></td>
</tr>
</table>
<p>
Zwei weitere Methoden stehen für das Markieren von Text zur Verfügung:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public void selectAll()
public void select(int first, int last)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/java/awt/TextField.html" onClick="this.href=getApiDoc('java.awt.TextField')"><font color="#660066" size=-1>java.awt.TextField</font></a></td>
</tr>
</table>
<p>
<a name="ixa102197"><a href="index_s.html#ixb101656"><font color=#000080><tt>selectAll</tt></font></a></a>
markiert den kompletten Text und <a name="ixa102198"><a href="index_s.html#ixb101657"><font color=#000080><tt>select</tt></font></a></a>
den Bereich von <font color="#000077"><tt>first</tt></font> bis <font color="#000077"><tt>last</tt></font>
(die Zählung beginnt bei 0). Mit den beiden Methoden <a name="ixa102199"><a href="index_g.html#ixb101658"><font color=#000080><tt>getSelectionStart</tt></font></a></a>
und <a name="ixa102200"><a href="index_g.html#ixb101659"><font color=#000080><tt>getSelectionEnd</tt></font></a></a>
kann die aktuelle Selektion abgefragt werden, <a name="ixa102201"><a href="index_g.html#ixb101660"><font color=#000080><tt>getSelectedText</tt></font></a></a>
liefert den selektierten Text:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public int getSelectionStart()
public int getSelectionEnd()
public String getSelectedText()
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/java/awt/TextField.html" onClick="this.href=getApiDoc('java.awt.TextField')"><font color="#660066" size=-1>java.awt.TextField</font></a></td>
</tr>
</table>
<p>
Auf die aktuelle Cursorposition innerhalb des Textes kann mit den
Methoden <a name="ixa102202"><a href="index_g.html#ixb101661"><font color=#000080><tt>getCaretPosition</tt></font></a></a>
und <a name="ixa102203"><a href="index_s.html#ixb101662"><font color=#000080><tt>setCaretPosition</tt></font></a></a>
zugegriffen werden:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public int getCaretPosition()
public void setCaretPosition(int position)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/java/awt/TextField.html" onClick="this.href=getApiDoc('java.awt.TextField')"><font color="#660066" size=-1>java.awt.TextField</font></a></td>
</tr>
</table>
<p>
Des weiteren kann man verhindern, dass der Text geändert wird,
und es besteht die Möglichkeit, verdeckte Eingaben (etwa für
Paßwörter) zu realisieren:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public void setEditable(boolean allowed)
public boolean isEditable()
public void setEchoCharacter(char c)
public char getEchoChar()
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/java/awt/TextField.html" onClick="this.href=getApiDoc('java.awt.TextField')"><font color="#660066" size=-1>java.awt.TextField</font></a></td>
</tr>
</table>
<p>
Durch einen Aufruf von <a name="ixa102204"><a href="index_s.html#ixb101663"><font color=#000080><tt>setEditable</tt></font></a></a>
mit <a href="index_f.html#ixb100234"><font color=#000080><tt>false</tt></font></a>
als Parameter werden weitere Eingaben unterbunden. Der aktuelle Status
kann mit <a name="ixa102205"><a href="index_i.html#ixb101664"><font color=#000080><tt>isEditable</tt></font></a></a>
abgefragt werden. Mit Hilfe von <a name="ixa102206"><a href="index_s.html#ixb101665"><font color=#000080><tt>setEchoCharacter</tt></font></a></a>
kann ein Zeichen übergeben werden, das bei jedem Tastendruck
anstelle des vom Anwender eingegebenen Zeichens ausgegeben wird. Durch
Übergabe eines '*' kann beispielsweise die verdeckte Eingabe
eines Paßworts realisiert werden.
<p>
Ein Textfeld generiert ein Action-Event, wenn der Anwender innerhalb
des Textfeldes die ENTER-Taste drückt. In diesem Fall liefert
die Methode <a name="ixa102207"><a href="index_g.html#ixb101572"><font color=#000080><tt>getActionCommand</tt></font></a></a>
des Action-Events den Inhalt des Textfeldes. Eine Methode <a href="index_s.html#ixb101569"><font color=#000080><tt>setActionCommand</tt></font></a>,
die es wie bei Buttons erlaubt, den Rückgabewert von <a href="index_g.html#ixb101572"><font color=#000080><tt>getActionCommand</tt></font></a>
zu verändern, gibt es bei Textfeldern nicht. Um die Action-Events
mehrerer Textfelder, die einen gemeinsamen Empfänger haben, unterscheiden
zu können, kann mit <a name="ixa102208"><a href="index_g.html#ixb101401"><font color=#000080><tt>getSource</tt></font></a></a>
die Ereignisquelle abgefragt werden. Wird ein gemeinsamer Empfänger
für alle Action-Events verwendet, so kann das von <a href="index_g.html#ixb101401"><font color=#000080><tt>getSource</tt></font></a>
gelieferte Objekt mit dem Operator <a name="ixa102209"><a href="index_i.html#ixb100330"><font color=#000080><tt>instanceof</tt></font></a></a>
daraufhin untersucht werden, ob es sich um ein <a href="index_t.html#ixb101473"><font color=#000080><tt>TextField</tt></font></a>
oder einen <a href="index_b.html#ixb101471"><font color=#000080><tt>Button</tt></font></a>
handelt. Für das nachfolgende Beispiel könnte das etwa so
aussehen:
<a name="listingid032006"></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">/* TextField1.inc */</font>
<font color="#555555">002 </font>
<font color="#555555">003 </font><font color="#0000AA">public</font> <font color="#006699">void</font> actionPerformed(ActionEvent event)
<font color="#555555">004 </font>{
<font color="#555555">005 </font> Object obj = event.getSource();
<font color="#555555">006 </font> <font color="#0000AA">if</font> (obj <font color="#0000AA">instanceof</font> TextField) {
<font color="#555555">007 </font> System.out.println(
<font color="#555555">008 </font> <font color="#0000FF">"ButtonAction: "</font>+event.getActionCommand()
<font color="#555555">009 </font> );
<font color="#555555">010 </font> } <font color="#0000AA">else</font> <font color="#0000AA">if</font> (obj <font color="#0000AA">instanceof</font> Button) {
<font color="#555555">011 </font> <font color="#0000AA">if</font> (event.getActionCommand().equals(<font color="#0000FF">"Ende"</font>)) {
<font color="#555555">012 </font> endDialog();
<font color="#555555">013 </font> }
<font color="#555555">014 </font> }
<font color="#555555">015 </font>}</pre>
</font>
</td>
<td valign=top align=right>
<a href="../examples/TextField1.inc"><font color="#000055" size=-1>TextField1.inc</font></a></td>
</tr>
</table>
<i>
Listing 32.6: Verwendung von Textfeldern</i></p>
<p>
Neben dem Action-Ereignis generiert ein Textfeld bei jeder Textänderung
ein <i>Text-Ereignis</i>. Ein Empfänger für Text-Ereignisse
kann mit der Methode <a name="ixa102210"><a href="index_a.html#ixb101488"><font color=#000080><tt>addTextListener</tt></font></a></a>
von <a href="index_t.html#ixb101473"><font color=#000080><tt>TextField</tt></font></a>
registriert werden, die als Argument ein Objekt erwartet, das das
Interface <a name="ixa102211"><a href="index_t.html#ixb101487"><font color=#000080><tt>TextListener</tt></font></a></a>
implementiert. Beim Auftreten eines Text-Ereignisses wird im <a href="index_t.html#ixb101487"><font color=#000080><tt>TextListener</tt></font></a>
die Methode <a name="ixa102212"><a href="index_t.html#ixb101490"><font color=#000080><tt>textValueChanged</tt></font></a></a>
mit einem <a name="ixa102213"><a href="index_t.html#ixb101407"><font color=#000080><tt>TextEvent</tt></font></a></a>
als Parameter aufgerufen. <a href="index_t.html#ixb101407"><font color=#000080><tt>TextEvent</tt></font></a>
ist aus <a href="index_a.html#ixb101402"><font color=#000080><tt>AWTEvent</tt></font></a>
abgeleitet und erbt die Methoden <a href="index_g.html#ixb101409"><font color=#000080><tt>getID</tt></font></a>
und <a href="index_g.html#ixb101401"><font color=#000080><tt>getSource</tt></font></a>,
stellt darüber hinaus aber keine eigenen Methoden zur Verfügung.
Typischerweise wird innerhalb von <a href="index_t.html#ixb101490"><font color=#000080><tt>textValueChanged</tt></font></a>
mit <a href="index_g.html#ixb101401"><font color=#000080><tt>getSource</tt></font></a>
das zugehörige <a href="index_t.html#ixb101473"><font color=#000080><tt>TextField</tt></font></a>
beschafft und mit <a href="index_g.html#ixb101645"><font color=#000080><tt>getText</tt></font></a>
auf seinen Inhalt zugegriffen:
<a name="listingid032007"></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">/* TextField2.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> TextField tf = (TextField)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/TextField2.inc"><font color="#000055" size=-1>TextField2.inc</font></a></td>
</tr>
</table>
<i>
Listing 32.7: Behandlung von Text-Events</i></p>
<p>
Das folgende Beispiel zeigt die Anwendung von Textfeldern und die
Registrierung von Empfängern für Text-Events und Action-Events.
Das Beispiel demonstriert auch, wie man Textfelder und Beschriftungen
kombinieren kann. Innerhalb des Dialogs werden in einem <a href="index_f.html#ixb101598"><font color=#000080><tt>FlowLayout</tt></font></a>
zwei Panels nebeneinander angeordnet. Das erste Panel enthält
ein <a href="index_g.html#ixb101599"><font color=#000080><tt>GridLayout</tt></font></a>
mit drei Zeilen Beschriftung und das zweite ein <a href="index_g.html#ixb101599"><font color=#000080><tt>GridLayout</tt></font></a>
mit drei Textfeldern. Da die Höhe der Elemente im <a href="index_g.html#ixb101599"><font color=#000080><tt>GridLayout</tt></font></a>
in beiden Panels identisch ist, stehen Beschriftung und Text jeweils
auf der gleichen Höhe nebeneinander.
<a name="listingid032008"></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">/* TextField3.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> Panel labelPanel = <font color="#0000AA">new</font> Panel();
<font color="#555555">007 </font> labelPanel.setLayout(<font color="#0000AA">new</font> GridLayout(3,1));
<font color="#555555">008 </font> labelPanel.add(<font color="#0000AA">new</font> Label(<font color="#0000FF">"Name"</font>,Label.LEFT));
<font color="#555555">009 </font> labelPanel.add(<font color="#0000AA">new</font> Label(<font color="#0000FF">"Vorname"</font>,Label.LEFT));
<font color="#555555">010 </font> labelPanel.add(<font color="#0000AA">new</font> Label(<font color="#0000FF">"Ort"</font>,Label.LEFT));
<font color="#555555">011 </font> Panel editPanel = <font color="#0000AA">new</font> Panel();
<font color="#555555">012 </font> editPanel.setLayout(<font color="#0000AA">new</font> GridLayout(3,1));
<font color="#555555">013 </font>
<font color="#555555">014 </font> <font color="#00AA00">//Dieses Textfeld sendet Action- und Text-Ereignisse</font>
<font color="#555555">015 </font> TextField tf = <font color="#0000AA">new</font> TextField(<font color="#0000FF">"Meier"</font>,20);
<font color="#555555">016 </font> tf.addActionListener(<font color="#006699">this</font>);
<font color="#555555">017 </font> tf.addTextListener(<font color="#006699">this</font>);
<font color="#555555">018 </font> editPanel.add(tf);
<font color="#555555">019 </font>
<font color="#555555">020 </font> <font color="#00AA00">//Diese Textfelder senden keine Ereignisse</font>
<font color="#555555">021 </font> editPanel.add(<font color="#0000AA">new</font> TextField(<font color="#0000FF">"Luise"</font>,20));
<font color="#555555">022 </font> editPanel.add(<font color="#0000AA">new</font> TextField(<font color="#0000FF">"Hamburg"</font>,20));
<font color="#555555">023 </font> panel.add(labelPanel);
<font color="#555555">024 </font> panel.add(editPanel);
<font color="#555555">025 </font>}</pre>
</font>
</td>
<td valign=top align=right>
<a href="../examples/TextField3.inc"><font color="#000055" size=-1>TextField3.inc</font></a></td>
</tr>
</table>
<i>
Listing 32.8: Textfelder mit Beschriftung</i></p>
<p>
<a name="imageid032006"></a>
<img src="images/TextField.gif">
<p>
<p><i>
Abbildung 32.6: Ein Dialog mit beschrifteten Textfeldern</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="k100211.html"> < </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100213.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>
|
