Titel | Inhalt | Suchen | Index | DOC | Handbuch der Java-Programmierung, 3. Auflage |
<< | < | > | >> | API | Kapitel 32 - AWT-Dialogelemente |
Eine List ist eine listenartige Darstellung von Werten, aus denen der Anwender einen oder mehrere auswählen kann. Anders als ein Choice-Element ist ein Element der Klasse List ständig in voller Größe auf dem Bildschirm sichtbar. Unter Windows werden Objekte der Klasse List durch Listboxen dargestellt.
public List() public List(int size) public List(int size, boolean multiselect) |
java.awt.List |
Der parameterlose Konstruktor legt eine leere Listbox an, deren dargestellte Größe vom Layoutmanager begrenzt wird. Der Parameter size legt die Anzahl der angezeigten Zeilen fest. Dabei können auch mehr Elemente in der Listbox enthalten sein, als auf einmal angezeigt werden können. List-Dialogelemente können wahlweise die Mehrfachselektion von Elementen zulassen. Wird bei der Konstruktion der Listbox der Parameter multiselect auf true gesetzt, kann der Anwender nicht nur ein Element, sondern auch mehrere Elemente selektieren.
Das Dialogelement List bietet nahezu dieselbe Funktionalität wie Choice. Zusätzlich stehen die Methoden getSelectedIndexes und getSelectedItems zur Verfügung, um bei einer Mehrfachselektion auf die selektierten Elemente zugreifen zu können:
public int[] getSelectedIndexes() public String[] getSelectedItems() |
java.awt.List |
getSelectedIndexes liefert ein Array mit den Indexpositionen aller selektierten Elemente, und getSelectedItems liefert eine Liste der Werte selbst.
Mit den Methoden select und deselect lassen sich einzelne Elemente selektieren oder deselektieren:
public void select(int index) public void deselect(int index) |
java.awt.List |
Im Gegensatz zu Choice ist es bei einer Komponente des Typs List auch möglich, Elemente zu entfernen oder ihren Wert zu ändern:
public void delItem(int index) public void remove(int index) public void replaceItem(String newValue, int index) |
java.awt.List |
Sowohl delItem als auch remove löschen das Element an der Position index, und replaceItem ersetzt das Element an der Position index durch den neuen Wert newValue.
Eine List sendet sowohl Item-Ereignisse als auch Action-Ereignisse. Ein Action-Ereignis wird dann generiert, wenn ein Listenelement per Doppelklick ausgewählt wurde. Das Drücken der ENTER-Taste löst - wenigstens in der aktuellen Windows-Implementierung - kein Action-Ereignis aus. Ein Item-Ereignis wird ausgelöst, nachdem in der Liste ein Element ausgewählt wurde. Bezüglich der Implementierung von Event-Handlern für diese Ereignisse verweisen wir auf die Beschreibungen der Klassen Choice und TextField weiter oben.
Falls ein Item-Ereignis ausgelöst wurde, verhält sich die Methode getItemSelectable des ItemEvent analog zu Choice und liefert das List-Objekt, das das Ereignis ausgelöst hat. Der Rückgabewert von getItem ist dagegen anders zu interpretieren, denn er liefert nicht das ausgewählte Element als String, sondern dessen Position als Integer-Objekt. Dieses kann mit intValue in ein int konvertiert werden, das die Position des ausgewählten Elements liefert. Beispielhafte Implementierungen von actionPerformed und itemStateChanged könnten folgendermaßen aussehen: |
|
001 /* List2.inc */ 002 003 public void itemStateChanged(ItemEvent event) 004 { 005 List list = (List) event.getItemSelectable(); 006 String str1 = list.getSelectedItem(); 007 int pos = ((Integer) event.getItem()).intValue(); 008 System.out.println("list.getSelectedItem: " + str1); 009 System.out.println("event.getItem: " + pos); 010 } 011 012 public void actionPerformed(ActionEvent event) 013 { 014 Object obj = event.getSource(); 015 if (obj instanceof List) { 016 System.out.println("ListAction: "+event.getActionCommand()); 017 } else if (obj instanceof Button) { 018 if (event.getActionCommand().equals("Ende")) { 019 endDialog(); 020 } 021 } 022 } |
List2.inc |
Das Beispielprogramm für die Verwendung der List-Komponente sieht so aus:
001 /* List1.inc */ 002 003 private void customizeLayout(Panel panel) 004 { 005 panel.setLayout(new FlowLayout(FlowLayout.LEFT)); 006 List list = new List(6,false); 007 list.addActionListener(this); 008 list.addItemListener(this); 009 list.add("Äpfel"); 010 list.add("Birnen"); 011 list.add("Bananen"); 012 list.add("Pfirsiche"); 013 list.add("Kirschen"); 014 list.add("Kiwis"); 015 list.add("Ananas"); 016 list.add("Erdbeeren"); 017 list.add("Blaubeeren"); 018 list.add("Mandarinen"); 019 panel.add(list); 020 list.select(1); 021 } |
List1.inc |
Abbildung 32.9: Ein Dialog mit einer Listbox
Titel | Inhalt | Suchen | Index | DOC | Handbuch der Java-Programmierung, 3. Auflage, Addison Wesley, Version 3.0.1 |
<< | < | > | >> | API | © 1998-2003 Guido Krüger, http://www.javabuch.de |