Master/Reference Architectures and Patterns/hjp5/html/k100215.html


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

<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,k100214.html;107,k100216.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">&nbsp;Titel&nbsp;</a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100003.html">&nbsp;Inhalt&nbsp;</a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="search.html">&nbsp;Suchen&nbsp;</a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="index.html">&nbsp;Index&nbsp;</a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="../jdkdocs/index.html" onClick="this.href=getDocIndex()">&nbsp;DOC&nbsp;</a>
<td align="right">Handbuch der Java-Programmierung, 5. Auflage
<tr bgcolor="#EEFFCC">
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100206.html">&nbsp;&lt;&lt;&nbsp;</a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100214.html">&nbsp;&nbsp;&lt;&nbsp;&nbsp;</a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100216.html">&nbsp;&nbsp;&gt;&nbsp;&nbsp;</a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100219.html">&nbsp;&gt;&gt;&nbsp;</a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="../jdkdocs/api/index.html" onClick="this.href=getApiIndex()">&nbsp;API&nbsp;</a>
<td align="right">Kapitel 32 - AWT-Dialogelemente
</table>
<hr>


<!-- Section -->
<a name="sectlevel2id032009"></a>
<h2>32.9 List </h2>
<hr>
<ul>
<li><a href="k100215.html#sectlevel2id032009">32.9 List</a>
</ul>
<hr>

<p>
Eine <a name="ixa102240"><a href="index_l.html#ixb100717"><font color=#000080><tt>List</tt></font></a></a>
ist eine listenartige Darstellung von Werten, aus denen der Anwender
einen oder mehrere ausw&auml;hlen kann. Anders als ein <a href="index_c.html#ixb101484"><font color=#000080><tt>Choice</tt></font></a>-Element
ist ein Element der Klasse <a href="index_l.html#ixb100717"><font color=#000080><tt>List</tt></font></a>
st&auml;ndig in voller Gr&ouml;&szlig;e auf dem Bildschirm sichtbar.
Unter Windows werden Objekte der Klasse <a href="index_l.html#ixb100717"><font color=#000080><tt>List</tt></font></a>
durch <a name="ixa102241"><i>Listboxen</i></a> dargestellt. 
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public List()

public List(int size)

public List(int size, boolean multiselect)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/java/awt/List.html" onClick="this.href=getApiDoc('java.awt.List')"><font color="#660066" size=-1>java.awt.List</font></a></td>
</tr>
</table>

<p>
Der parameterlose Konstruktor legt eine leere Listbox an, deren dargestellte
Gr&ouml;&szlig;e vom Layoutmanager begrenzt wird. Der Parameter <font color="#000077"><tt>size</tt></font>
legt die Anzahl der angezeigten Zeilen fest. Dabei k&ouml;nnen auch
mehr Elemente in der Listbox enthalten sein, als auf einmal angezeigt
werden k&ouml;nnen. <a href="index_l.html#ixb100717"><font color=#000080><tt>List</tt></font></a>-Dialogelemente
k&ouml;nnen wahlweise die <a name="ixa102242"><i>Mehrfachselektion</i></a>
von Elementen zulassen. Wird bei der Konstruktion der Listbox der
Parameter <font color="#000077"><tt>multiselect</tt></font> auf <a href="index_t.html#ixb100233"><font color=#000080><tt>true</tt></font></a>
gesetzt, kann der Anwender nicht nur ein Element, sondern auch mehrere
Elemente selektieren. 

<p>
Das Dialogelement <a href="index_l.html#ixb100717"><font color=#000080><tt>List</tt></font></a>
bietet nahezu dieselbe Funktionalit&auml;t wie <a href="index_c.html#ixb101484"><font color=#000080><tt>Choice</tt></font></a>.
Zus&auml;tzlich stehen die Methoden <a name="ixa102243"><a href="index_g.html#ixb101679"><font color=#000080><tt>getSelectedIndexes</tt></font></a></a>
und <a name="ixa102244"><a href="index_g.html#ixb101680"><font color=#000080><tt>getSelectedItems</tt></font></a></a>
zur Verf&uuml;gung, um bei einer Mehrfachselektion auf die selektierten
Elemente zugreifen zu k&ouml;nnen: 
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public int[] getSelectedIndexes()

public String[] getSelectedItems()
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/java/awt/List.html" onClick="this.href=getApiDoc('java.awt.List')"><font color="#660066" size=-1>java.awt.List</font></a></td>
</tr>
</table>

<p>
<a href="index_g.html#ixb101679"><font color=#000080><tt>getSelectedIndexes</tt></font></a>
liefert ein Array mit den Indexpositionen aller selektierten Elemente,
und <a href="index_g.html#ixb101680"><font color=#000080><tt>getSelectedItems</tt></font></a>
liefert eine Liste der Werte selbst. 

<p>
Mit den Methoden <a name="ixa102245"><a href="index_s.html#ixb101657"><font color=#000080><tt>select</tt></font></a></a>
und <a name="ixa102246"><a href="index_d.html#ixb101681"><font color=#000080><tt>deselect</tt></font></a></a>
lassen sich einzelne Elemente selektieren oder deselektieren: 
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public void select(int index)

public void deselect(int index)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/java/awt/List.html" onClick="this.href=getApiDoc('java.awt.List')"><font color="#660066" size=-1>java.awt.List</font></a></td>
</tr>
</table>

<p>
Im Gegensatz zu <a href="index_c.html#ixb101484"><font color=#000080><tt>Choice</tt></font></a>
ist es bei einer Komponente des Typs <a href="index_l.html#ixb100717"><font color=#000080><tt>List</tt></font></a>
auch m&ouml;glich, Elemente zu entfernen oder ihren Wert zu &auml;ndern:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public void delItem(int index)

public void remove(int index)

public void replaceItem(String newValue, int index)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/java/awt/List.html" onClick="this.href=getApiDoc('java.awt.List')"><font color="#660066" size=-1>java.awt.List</font></a></td>
</tr>
</table>

<p>
Sowohl <a name="ixa102247"><a href="index_d.html#ixb101682"><font color=#000080><tt>delItem</tt></font></a></a>
als auch <a name="ixa102248"><a href="index_r.html#ixb100730"><font color=#000080><tt>remove</tt></font></a></a>
l&ouml;schen das Element an der Position <font color="#000077"><tt>index</tt></font>,
und <a name="ixa102249"><a href="index_r.html#ixb101683"><font color=#000080><tt>replaceItem</tt></font></a></a>
ersetzt das Element an der Position <font color="#000077"><tt>index</tt></font>
durch den neuen Wert <font color="#000077"><tt>newValue</tt></font>.

<p>
Eine <a href="index_l.html#ixb100717"><font color=#000080><tt>List</tt></font></a>
sendet sowohl Item-Ereignisse als auch Action-Ereignisse. Ein Action-Ereignis
wird dann generiert, wenn ein Listenelement per Doppelklick ausgew&auml;hlt
wurde. Das Dr&uuml;cken der ENTER-Taste l&ouml;st - wenigstens in
der aktuellen Windows-Implementierung - <i>kein</i> Action-Ereignis
aus. Ein Item-Ereignis wird ausgel&ouml;st, nachdem in der Liste ein
Element ausgew&auml;hlt wurde. Bez&uuml;glich der Implementierung
von Event-Handlern f&uuml;r diese Ereignisse verweisen wir auf die
Beschreibungen der Klassen <a href="index_c.html#ixb101484"><font color=#000080><tt>Choice</tt></font></a>
und <a href="index_t.html#ixb101473"><font color=#000080><tt>TextField</tt></font></a>
weiter oben. 
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100%>
<tr>
<td width=1 align=left valign=top bgcolor="#CC0000"><img src="trp1_1.gif"></td>
<td><img src="trp1_1.gif" width=1></td>
<td width=1 align=left valign=top bgcolor="#CC0000"><img src="trp1_1.gif"></td>
<td><img src="trp1_1.gif" width=2></td>
<td valign=top width=1000>

<p>
Falls ein Item-Ereignis ausgel&ouml;st wurde, verh&auml;lt sich die
Methode <a href="index_g.html#ixb101646"><font color=#000080><tt>getItemSelectable</tt></font></a>
des <a href="index_i.html#ixb101406"><font color=#000080><tt>ItemEvent</tt></font></a>
analog zu <a href="index_c.html#ixb101484"><font color=#000080><tt>Choice</tt></font></a>
und liefert das <a href="index_l.html#ixb100717"><font color=#000080><tt>List</tt></font></a>-Objekt,
das das Ereignis ausgel&ouml;st hat. Der R&uuml;ckgabewert von <a href="index_g.html#ixb101560"><font color=#000080><tt>getItem</tt></font></a>
ist dagegen anders zu interpretieren, denn er liefert nicht das ausgew&auml;hlte
Element als <a href="index_s.html#ixb100117"><font color=#000080><tt>String</tt></font></a>,
sondern dessen Position als <a href="index_i.html#ixb100170"><font color=#000080><tt>Integer</tt></font></a>-Objekt.
Dieses kann mit <a href="index_i.html#ixb100474"><font color=#000080><tt>intValue</tt></font></a>
in ein <a href="index_i.html#ixb100244"><font color=#000080><tt>int</tt></font></a>
konvertiert werden, das die Position des ausgew&auml;hlten Elements
liefert. Beispielhafte Implementierungen von <a href="index_a.html#ixb101474"><font color=#000080><tt>actionPerformed</tt></font></a>
und <a href="index_i.html#ixb101486"><font color=#000080><tt>itemStateChanged</tt></font></a>
k&ouml;nnten folgenderma&szlig;en aussehen:</td>
<td><img src="trp1_1.gif" width=2></td>
<td valign=top>
<table border=0 cellspacing=0 cellpadding=1 width=100% bgcolor="#CC0000">
<tr>
<td><font color="#FFFFFF">&nbsp;Warnung&nbsp;</font></td>
</tr>
</table>
</td>
<td width=1 align=left valign=top bgcolor="#CC0000"><img src="trp1_1.gif"></td>
</tr>
</table>
<a name="listingid032013"></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">/* List2.inc */</font>
<font color="#555555">002 </font>
<font color="#555555">003 </font><font color="#0000AA">public</font> <font color="#006699">void</font> itemStateChanged(ItemEvent event)
<font color="#555555">004 </font>{
<font color="#555555">005 </font>  List list = (List) event.getItemSelectable();
<font color="#555555">006 </font>  String str1 = list.getSelectedItem();
<font color="#555555">007 </font>  <font color="#006699">int</font> pos = ((Integer) event.getItem()).intValue();
<font color="#555555">008 </font>  System.out.println(<font color="#0000FF">"list.getSelectedItem: "</font> + str1);
<font color="#555555">009 </font>  System.out.println(<font color="#0000FF">"event.getItem:        "</font> + pos);
<font color="#555555">010 </font>}
<font color="#555555">011 </font>
<font color="#555555">012 </font><font color="#0000AA">public</font> <font color="#006699">void</font> actionPerformed(ActionEvent event)
<font color="#555555">013 </font>{
<font color="#555555">014 </font>   Object obj = event.getSource();
<font color="#555555">015 </font>   <font color="#0000AA">if</font> (obj <font color="#0000AA">instanceof</font> List) {
<font color="#555555">016 </font>      System.out.println(<font color="#0000FF">"ListAction: "</font>+event.getActionCommand());
<font color="#555555">017 </font>   } <font color="#0000AA">else</font> <font color="#0000AA">if</font> (obj <font color="#0000AA">instanceof</font> Button) {
<font color="#555555">018 </font>      <font color="#0000AA">if</font> (event.getActionCommand().equals(<font color="#0000FF">"Ende"</font>)) {
<font color="#555555">019 </font>         endDialog();
<font color="#555555">020 </font>      }
<font color="#555555">021 </font>   }
<font color="#555555">022 </font>}</pre>
</font>
</td>
<td valign=top align=right>
<a href="../examples/List2.inc"><font color="#000055" size=-1>List2.inc</font></a></td>
</tr>
</table>
<i>
Listing 32.13: Behandlung der Ereignisse einer List-Komponente</i></p>

<p>
Das Beispielprogramm f&uuml;r die Verwendung der <a href="index_l.html#ixb100717"><font color=#000080><tt>List</tt></font></a>-Komponente
sieht so aus: 
<a name="listingid032014"></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">/* List1.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>  List list = <font color="#0000AA">new</font> List(6,<font color="#006699">false</font>);
<font color="#555555">007 </font>  list.addActionListener(<font color="#006699">this</font>);
<font color="#555555">008 </font>  list.addItemListener(<font color="#006699">this</font>);
<font color="#555555">009 </font>  list.add(<font color="#0000FF">"&Auml;pfel"</font>);
<font color="#555555">010 </font>  list.add(<font color="#0000FF">"Birnen"</font>);
<font color="#555555">011 </font>  list.add(<font color="#0000FF">"Bananen"</font>);
<font color="#555555">012 </font>  list.add(<font color="#0000FF">"Pfirsiche"</font>);
<font color="#555555">013 </font>  list.add(<font color="#0000FF">"Kirschen"</font>);
<font color="#555555">014 </font>  list.add(<font color="#0000FF">"Kiwis"</font>);
<font color="#555555">015 </font>  list.add(<font color="#0000FF">"Ananas"</font>);
<font color="#555555">016 </font>  list.add(<font color="#0000FF">"Erdbeeren"</font>);
<font color="#555555">017 </font>  list.add(<font color="#0000FF">"Blaubeeren"</font>);
<font color="#555555">018 </font>  list.add(<font color="#0000FF">"Mandarinen"</font>);
<font color="#555555">019 </font>  panel.add(list);
<font color="#555555">020 </font>  list.select(1);
<font color="#555555">021 </font>}</pre>
</font>
</td>
<td valign=top align=right>
<a href="../examples/List1.inc"><font color="#000055" size=-1>List1.inc</font></a></td>
</tr>
</table>
<i>
Listing 32.14: Verwendung einer List-Komponente</i></p>
<p>
<a name="imageid032009"></a>
<img src="images/ListBox.gif">
<p>

<p><i>
Abbildung 32.9: Ein Dialog mit einer Listbox</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">&nbsp;Titel&nbsp;</a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100003.html">&nbsp;Inhalt&nbsp;</a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="search.html">&nbsp;Suchen&nbsp;</a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="index.html">&nbsp;Index&nbsp;</a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="../jdkdocs/index.html" onClick="this.href=getDocIndex()">&nbsp;DOC&nbsp;</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">&nbsp;&lt;&lt;&nbsp;</a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100214.html">&nbsp;&nbsp;&lt;&nbsp;&nbsp;</a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100216.html">&nbsp;&nbsp;&gt;&nbsp;&nbsp;</a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100219.html">&nbsp;&gt;&gt;&nbsp;</a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="../jdkdocs/api/index.html" onClick="this.href=getApiIndex()">&nbsp;API&nbsp;</a>
<td align="right">&copy; 1998, 2007 Guido Kr&uuml;ger &amp; Thomas
Stark, <a href="http://www.javabuch.de">http://www.javabuch.de</a>
</table>
<a name="endofbody"></a>
</body>
</html>