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

Deklaration

Beschreibung

Methoden
public synchronized void	add(String item)
public synchronized void	addItem(String item)
public synchronized void	addItemListener(ItemListener l)
public void	addNotify()
public int	countItems()       Verworfen in Version 1.1. Ersetzt durch getItemCount().
public AccessibleContext	getAccessibleContext()
public String	getItem(int index)
public int	getItemCount()
public EventListener[]	getListeners(Class listenerType)
public int	getSelectedIndex()
public synchronized String	getSelectedItem()
public synchronized Object[]	getSelectedObjects()
public synchronized void	insert(String item, int index)
protected String	paramString()
protected void	processEvent(AWTEvent e)
protected void	processItemEvent(ItemEvent e)
public synchronized void	remove(int position)
public synchronized void	remove(String item)
public synchronized void	removeAll()
public synchronized void	removeItemListener(ItemListener l)
public synchronized void	select(String str)
public synchronized void	select(int pos)

Konstruktoren im Detail

public Choice()

Erzeugt ein neues Exemplar von Choice, das noch keine Einträge enthält.

Methoden im Detail

public synchronized void add(String item)     

Fügt den String item am Ende der Liste an.

Exception: NullPointerException

• Wenn item null ist.

public synchronized void addItem(String item)

Fügt den String item am Ende der Liste an.

Exception: NullPointerException

• Wenn item null ist.

public synchronized void addItemListener(ItemListener l)     

Registriert l bei dieser Komponente.

public void addNotify()     

Erzeugt über einen Aufruf von createChoice des Toolkits ein Peer-Objekt, das die Choice-Komponente am Bildschirm darstellt.

public int countItems()

Liefert die Anzahl der Einträge zurück.

public AccessibleContext getAccessibleContext()     

Liefert den AccessibleContext.

public String getItem(int index)

Liefert den Listeneintrag an der Position index zurück, die von null an gezählt wird.

public int getItemCount()     

Liefert die Anzahl der Einträge zurück.

public EventListener[] getListeners(Class listenerType)     

Liefert die Listener des angegebenen Typs.

public int getSelectedIndex()

Liefert den Index des selektierten Eintrags zurück. Dieser Index wird von null an gezählt. Der Rückgabewert -1 tritt auf, wenn die Liste leer ist.

public synchronized String getSelectedItem()

Liefert den selektierten Eintrag zurück. Falls die Liste leer ist, wird null zurückgegeben.

public synchronized Object[] getSelectedObjects()     

Diese Methode liefert ein einelementiges Array zurück, das selektierten Eintrag als String enthält. Wenn die Liste leer ist, wird null zurückgeliefert.

public synchronized void insert(String item, int index)     

Fügt den Eintrag item an der Position index, die von null an gezählt wird, in die Liste ein. Wenn index größer oder gleich der momentanen Anzahl der Einträge ist, wird der Eintrag am Ende angehängt.

Exception: IllegalArgumentException

• Falls index kleiner als null ist.

Exception: NullPointerException

• Wenn item null ist.

protected String paramString()

Liefert den Parameter-String des Objekts, der den momentan selektierten Eintrag enthält.

protected void processEvent(AWTEvent e)

Falls e ein ItemEvent ist, wird processItemEvent() aufgerufen, ansonsten wird das Ereignis an den Vorfahren weitergeleitet.

protected void processItemEvent(ItemEvent e)     

Falls Item-Events bei dieser Komponente aktiviert sind, wird das Ereignis e an die angeschlossenen ItemListener weitergeleitet.

public synchronized void remove(int position)     

Entfernt den Eintrag an der Position position, die von null an gezählt wird, aus der Liste. Wenn dieser Eintrag selektiert war, wird der erste Listeneintrag selektiert.

public synchronized void remove(String item)     

Entfernt den Eintrag item aus der Liste. Wenn item selektiert war, wird der erste Listeneintrag selektiert.

Exception: IllegalArgumentException

• Falls item nicht in der Liste enthalten ist.

public synchronized void removeAll()     

Entfernt alle Einträge aus der Liste.

public synchronized void removeItemListener(ItemListener l)     

Entfernt l aus der Kette der registrierten ItemListener.

public synchronized void select(String str)

Selektiert den durch str bezeichneten Eintrag, falls ein solcher Eintrag in der Liste vorhanden ist. Andernfalls bleibt diese Methode wirkungslos.

public synchronized void select(int pos)

Selektiert den Eintrag an der Position pos, die von null an gezählt wird.

Exception: IllegalArgumentException

• Falls pos größer gleich der Anzahl der Eintrage ist.