JAVA - Graphische Komponenten - List
Startseite  Graphische Komponenten  Indexverzeichnis	JAVA - Graphische Komponenten - List Eine List-Komponente ist eine Scroll-Liste mit mehreren Listeneinträgen. Constructor Methoden Indexvariablen Vererbung Beispiel

Constructor

public List()	Erzeugt ein neues Skroll-Menü. Standardmäßig werden vier Zeilen angezeigt und eine Mehrfachauswahl ist nicht möglich.
public List(int rows)	Erzeugt ein neues Skroll-Menü mit rows sichtbaren Zeilen. Standardmäßig ist eine Mehrfachauswahl nicht möglich. Parameter: rows - Anzahl der sichtbaren Zeilen
public List(int rows, boolean multipleMode)	Erzeugt ein neues Skroll-Menü mit rows sichtbaren Zeilen. Wenn der Wert von mulitipleMode true ist, ist eine Mehrfachauswahl von Feldern möglich. Bei false kann nur ein Punkt markiert werden. Parameter: rows - Anzahl der sichtbaren Zeilen mulitpleMode - wenn true, Mehrfachauswahl möglich, ansonsten kann nur ein Listenpunkt ausgewählt werden.

Methoden

public void add(String item)	Fügt ein Feld mit der Bezeichnung item am Ende der Scrolliste hinzu. Parameter: item - Feld, das hinzugefügt werden soll
public void add(String item, int index)	Fügt ein Feld mit der Bezeichnung item an der Position index ein. Der Index beginnt mit 0. Wenn index größer als die Anzahl der Listenpunkte ist, wird das neue Feld am Ende hinzugefügt. Parameter: item - Feld, das hinzugefügt werden soll. Wenn dieser Parameter Null ist, wird das Feld mit einem leeren String "" hinzugefügt. index - Position, an der das Feld hinzugefügt werden soll. Exception: ArrayIndexOutOfBoundsException, wenn index kleiner als -1 ist
public void addActionListener(ActionListener l)	Fügt einen ActionListener zur Liste hinzu. ActionEvents treten auf, wenn der Benutzer mit der Maus einen Doppelklick auf ein Listenfeld macht. Wenn l Null ist, werden keine Exceptions verarbeitet und nichts ausgeführt. Parameter: l ActionListener
public void addItem(String item)	Deprecated = nicht mehr gültig. Wurde ersetzt durch add(String).
public void addItem(String item, int index)	Deprecated = nicht mehr gültig. Wurde ersetzt durch add(String, int).
public void addItemListener(ItemListener l)	Fügt eine ItemListener zur Liste hinzu. Wenn l Null ist, werden keine Exceptions verarbeitet und nichts ausgeführt. Definiert durch: addItemListener im Interface ItemSelectable Parameter: l - ItemListener
public void addNotify()	Erzeugt ein Handle auf die Liste. Dieses Handle ermöglicht es, das Aussehen der Liste zu ändern, ohne ihre Funktionalität zu ändern. Überschreibt: addNotify in der Klasse java.awt.Component
public boolean allowsMultipleSelections()	Deprecated = nicht mehr gültig. Wurde ersetzt durch isMultipleMode().
public void clear()	Deprecated = nicht mehr gültig. Wurde ersetzt durch removeAll().
public int countItems()	Deprecated = nicht mehr gültig. Wurde ersetzt durch getItemCount().
public void delItem(int position)	Deprecated = nicht mehr gültig. Wurde ersetzt durch remove(String) und remove(int).
public void delItems(int start, int end)	Deprecated = nicht mehr gültig. Wird nicht mehr als public zur Verfügung gestellt. Diese Methode wurde nur als Package-private Methode behalten.
public void deselect(int index)	"Entmarkiert" ein Listenfeld an der Stelle index. Sollte dieses Listenfeld nicht markiert sein oder ist der index größer als die Anzahl der Felder, wird diese Anweisung ignoriert. Parameter: index Position des Listenfeldes, das entmarkiert werden soll
public String getItem(int index)	Gibt das Feld der Liste mit dem Index index zurück. Parameter: index Position des Listenfeldes Rückgabe: ein Feld, das durch den index definiert wird
public int getItemCount()	Gibt die Anzahl der Listenfelder zurück. Rückgabe: Anzahl der Listenfelder
public String[] getItems()	Gibt die Felder der Liste zurück. Rückgabe: String-Array, das die Felder der Liste enthält
public Dimension getMinimumSize()	Gibt die minimale Größe der Liste zurück. Rückgabe: minimum-Maße, die benötigt werden, um die Liste darstellen zu können Überschreibt: getMinimumSize in der Klasse java.awt.Component
public Dimension getMinimumSize(int rows)	Gibt die minmalen Maße einer Liste mit rows Zeilen zurück Parameter: rows - Anzahl der Zeilen der Liste Rückgabe: minimum-Maße, die benötigt werden, um die Liste mit entsprechenden Zeilen darstellen zu können
public Dimension getPreferredSize()	Gibt die bevorzugte Größe der Liste zurück. Rückgabe: bevorzugte Größe, um die Liste darstellen zu können Überschreibt: getPreferredSize in der Klasse java.awt.Component
public Dimension getPreferredSize(int rows)	Gibt die bevorzugte Größe der Liste mit einer bestimmten Anzahl von Zeilen zurück. Parameter: rows - Anzahl der Zeilen in der Liste Rückgabe: bevorzugte Größe, um die Liste mit der entsprechenden Anzahl von Zeilen darzustellen
public int getRows()	Gibt die anzahl der sichtbaren Zeilen zurück. Rückgabe: Anzahl der sichtbaren Zeilen in der Liste
public int getSelectedIndex()	Gibt den Index des ausgewählten Feldes in der Liste zurück. Rückgabe: Index, des selektierten Feldes, bzw. -1 wenn kein Feld selektiert wurde oder mehr als ein Feld markiert ist
public int[] getSelectedIndexes()	Gibt den selektierten Index der Liste zurück. Rückgabe: Array der selektierten Indexe der Liste
public String getSelectedItem()	Gibt das ausgewählte Feld der Liste zurück. Rückgabe: ausgewälte Feld der Liste, bzw. Null, wenn kein Feld markiert wurde.
public String[] getSelectedItems()	Gibt die ausgewählten Felder der Liste zurück. Rückgabe: Array der ausgewählten Fellder der Liste
public Object[] getSelectedObjects()	Gibt die ausgewälten Felder der Liste in einem Array von Objects zurück. Definiert durch: getSelectedObjects im Interface ItemSelectable
public int getVisibleIndex()	Gibt den Index des Listenfeldes zurück, das durch die Methode makeVisible sichtbar wurde. Rückgabe: index des Listenfeldes, das zuletzt sichtbar gemacht wurde.
public boolean isIndexSelected(int index)	Überprüft, ob das Listenfeld mit dem Index index markiert ist. Parameter: index - Listenfeld, das überprüft werden soll Rückgabe: true = markiert, false = nicht markiert
public boolean isMultipleMode()	Überprüft, ob die Mehrfachauswahl für die Liste zugelassen ist. Rückgabe: true = Mehrfachauswahl zugelassen, false = Mehrfachauswahl nicht zugelassen
public boolean isSelected(int index)	Deprecated = nicht mehr gültig. Wurde ersetzt durch isIndexSelected(int).
public void makeVisible(int index)	Macht das Listenfeld mit dem Index index sichtbar. Parameter: index - Position des Listenfeldes
public Dimension minimumSize()	Deprecated = nicht mehr gültig. Wurde ersetzt durch getMinimumSize(). Überschreibt: minimumSize in der Klasse java.awt.Component
public Dimension minimumSize(int rows)	Deprecated = nicht mehr gültig. Wurde ersetzt durch getMinimumSize(int).
protected String paramString()	Gibt den String zurück, der der Status der Liste beschreibt. Dieser String ist für den Debugger nützlich. Rückgabe: Parameter-String der Liste Überschreibt: Methode paramString der Klasse java.awt.Component
public Dimension preferredSize()	Deprecated = nicht mehr gültig. Wurde ersetzt durch getPreferredSize(). Überschreibt: preferredSize in der Klasse java.awt.Component
public Dimension preferredSize(int rows)	Deprecated = nicht mehr gültig. Wurde ersetzt durch getPreferredSize(int).
protected void processActionEvent(ActionEvent e)	Verarbeitet ActionEvents der Liste, indem die Komponente an einen registrierten ActionListner weitergeleitet wird. Diese Methode wird nur aufgerufen, wenn ActionEvents für diese Liste zugelassen wurden. ActionEvents sind zugelassen wenn: - ein ActionListener mit addActionListener hinzugefügt wurde - ActionEvents mit der Methode enableEvents zugelassen wurden. Parameter: e - ActionEvent
protected void processEvent(AWTEvent e)	Verarbeitet Ereignisse der Liste. Wenn das Ereignis eine Instanz eines ItemEvent ist, ruft diese Methode die Methode processItemEvent auf. Wenn das Ereignis eine Instanz eines ActionEvent ist, ruft diese Methode die Methode processActionEvent auf. Ansonsten ruft es die Methode processEvent der Superklasse auf. Parameter: e - Ereignis Überschreibt: Methode processEvent der Klasse java.awt.Component
protected void processItemEvent(ItemEvent e)	Bearbeitet die auftretenden ItemEvents, indem es das Ereignis an einen registrierten ItemListener sendet. Diese Methode wird nur aufgerufen, wenn ItemEvents für diese Liste zugelassen wurden. ItemEvents sind zugelassen wenn: - ein ItemListener mit addItemListener hinzugefügt wurde - ItemEvents mit der Methode enableEvents zugelassen wurden. Parameter: e - ItemEvent
public void remove(int position)	Entfernt das Feld aus der Liste, das sich an der Position befindet. Parameter: position - Position des Feldes Exception: ArrayIndexOutOfBoundsException, wenn die Positin kleiner als 0 oder größer als getItemCount()-1 ist
public void remove(String item)	Entfernt das ein Listenfeld. Parameter: item - Feld, das entfernt werden soll Exception: IllegalArgumentException, wenn das Feld nicht existiert
public void removeActionListener(ActionListener l)	Entfernt den ActionListener, so daß er nicht länger Ereignisse der Liste verarbeitet. ActionEvents treten auf, wenn der Benutzer einen Doppelklick auf ein Feld macht. Wenn l Null ist, wird kein Exception verarbeitet und nichts ausgeführt. Parameter: l - ActionListener
public void removeAll()	Entfernt alle Listenfelder.
public void removeItemListener(ItemListener l)	Entfernt den ItemListener, so daß er nicht länger Ereignisse der Liste verarbeitet. Wenn l Null ist, wird kein Exception verarbeitet und nichts ausgeführt. Definiert durch: removeItemListener im Interface ItemSelectable Parameter: l - ItemListener
public void removeNotify()	Entfernt das Handle von der Liste. Dieses Handle ermöglicht es, das Aussehen des Labels zu ändern, ohne seine Funktionalität zu ändern. Überschreibt: removeNotify in der Klasse java.awt.Component
public void replaceItem(String newValue, int index)	Entfernt ein Listenfeld an der Position und tauscht es gegen ein neues aus. Parameter: newValue - neue Text, der gegen den alten ausgetauscht werden soll index - Position des Listenfeldes, das ausgetauscht werden soll
public void select(int index)	Markiert das Listenfeld an der Position index. Parameter: index - Position des Listenfeldes
public void setMultipleMode(boolean b)	Setzt den flag, der es ermöglicht, mehrere Listenfelder auszuwählen. Parameter: b - true = Mehrfachauswahl zugelassen, false = Mehrfachauswahl nicht zugelassen
public void setMultipleSelections(boolean b)	Deprecated = nicht mehr gültig. Wurde ersetzt durch setMultipleMode(boolean).

Indexvariablen

keine

Vererbung

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.List

Beispiel

Programmbeispiel:

import java.awt.*; import java.applet.*; public class List1 extends Applet{ public void init(){ setLayout(new FlowLayout()); List l1 = new List(3); l1.add("Auswahl1"); l1.add("Auswahl2"); l1.add("Auswahl3"); l1.add("Auswahl4"); l1.add("Auswahl5"); add(l1); List l2 = new List(3,true); l2.add("Auswahl a"); l2.add("Auswahl b"); l2.add("Auswahl c"); l2.add("Auswahl d"); l2.add("Auswahl e"); add(l2); } }

Eine Liste wird meistens mit List l1 = new List(3); definiert. Dieses Listenfeld zeigt 3 Zeilen an und läßt keine Mehrfachauswahl zu. Diese könnte man nachträglich mit l1.setMultipleMod(true); einstellen.

Die Zweite Liste läßt eine Mehrfachauswahl zu.

weiter: zurück:

TextArea   Label

© 1999-2001  Brit Schröter