JAVA-Doku Graphische Komponenten

JAVA - Graphische Komponenten - Choice

Startseite

Graphische Komponenten

Indexverzeichnis

JAVA - Graphische Komponenten - Choice

Die Klasse Choice erzeugt ein Aufklappmenü mit verschiedenen Auswahlpunkten.

Constructor

Methoden

Indexvariablen

Vererbung

Beispiel

Constructor

public Choice() Erzeugt ein neues Choice-Menü. Dieses Choice-Menü hat noch keine Einträge.
Standardmäßig wird der erste Eintrag selektiert, solange kein anderer ausgewält oder durch eine Methode selektiert wird.

Methoden

public void add(String item) Fügt ein Feld zum Choice-Menü hinzu.
Parameter: item - Feld, das hinzugefügt werden soll
Exception: NullPointerException, wenn der Feldwert Null ist

public void addItem(String item) Fügt ein Feld zum Choice-Menü hinzu.
Parameter: item - Feld, das hinzugefügt werden soll
Exception: NullPointerException, wenn der Feldwert Null ist

public void addItemListener(ItemListener l) Fügt den definierten ItemListener hinzu, um Ereignisse des Choice-Menüs verarbeiten zu können. Wenn l Null ist, wird kein Exception bearbeitet und nichts ausgeführt.
Definiert durch: addItemListener im Interface ItemSelectable Parameter: l - ItemListener

public void addNotify() Erzeugt ein Handle für das Choice-Menü. Dieses Handle ermöglicht es, das Aussehen des Choice-Menüs zu ändern, ohne seine Funktionalität zu ändern.
Überschreibt: addNotify in der Klasse java.awt.Component

public int countItems() Deprecated = nicht mehr gültig. Wurde ersetzt durch getItemCount().

public String getItem(int index) Gibt die Beschriftung des durch den Index definieren Feldes zurück.
Achtung! Der Index beginnt mit 0.
Parameter: index - Index, wo begonnen werden soll

public int getItemCount() Gibt die Anzahl der Felder des Choice-Menüs zurück.

public int getSelectedIndex() Gibt den Index des ausgewählten Feldes zurück.

public String getSelectedItem() Gibt die Definition des ausgewählten Feldes des Choice-Menüs als String zurück.
Rückgabe: String, der die Definition des ausgewählten Feldes des Choice-Menüs enthält.

public Object[] getSelectedObjects() Gibt ein Array mit der Länge l zurück, das das markierte Feld enthält. Wenn das Choice-Menü keine Felder hat, wird Null zurückgegeben.
Definiert durch: Methode getSelectedObjects im Interface ItemSelectable

public void insert(String item, int index) Fügt ein Feld in das Choice-Menü an der entsprechenden Stelle ein.
Parameter:

item - Bezeichnung des Feldes
index - Stelle, an der das Feld eingefügt werden soll
Exception: IllegalArgumentException, wenn index kleiner als 0 ist

protected String paramString() Gibt einen String zurück, der den Status des Choice-Menüs wiedergibt. Dieser String ist für den Debugger nützlich.
Rückgabe: Parameter-String des Choice-Menüs
Überschreibt: Methode paramString der Klasse java.awt.Component

protected void processEvent(AWTEvent e) Verarbeitet Ereignisse des Choice-Menüs. Wenn das Ereignis eine Instanz eines ItemEvent ist, ruft diese Methode die Methode processItemEvent 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 diesen Button 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 dem Choice-Menü, das sich an der Position befindet.
Parameter: position - Position des Feldes

public void remove(String item) Entfernt das Feld mit der Bezeichnung item.
Parameter: item - Feld, das aus dem Choice-Menü entfernt werden soll
Exception: IllegalArgumentException, wenn das Feld nicht existiert

public void removeAll() Entfernt alle Felder aus dem Choice-Menü.

public void removeItemListener(ItemListener l) Entfernt den definierten ItemListener, so daß er nicht weiter Ereignisse vom Choice-Menü empfangen kann. Wenn l Null ist, wird kein Exception verarbeitet und nichts ausgeführt.
Definiert durch: removeItemListener im Interface ItemSelectable
Parameter: l - ItemListener

public void select(int pos) Markiert das Feld des Choice-Menüs, das durch die Position pos definiert ist.
Parameter: pos Position des Feldes
Exception: IllegalArgumentException - wenn die Position nicht existiert

public void select(String str) Markiert das Feld des Choice-Menüs, dessen Bezeichnung mit str übereinstimmt. Haben mehrere Felder die gleiche Bezeichnung, wird das Feld markiert, das den kleinsten Index besitzt.
Parameter: str - Bezeichnung/Feld, die Markiert werden soll

Indexvariablen

keine

Vererbung

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

Beispiel

Programmbeispiel:

import java.awt.*; import java.applet.*; public class Choice1 extends Applet{ public void init(){ setLayout(new FlowLayout()); Choice c1 = new Choice(); c1.addItem("Auswahl 1"); c1.addItem("Auswahl 2"); c1.addItem("Auswahl 3"); c1.addItem("Auswahl 4"); add(c1); c1.select(2); } }

Ein Choice wird ganz einfach mit Choice name = new Choice(); definiert. Die einzelnen Felder werden mit name.addItem(String text); definiert. Zu einem Choice können beliebig viele Felder hinzugefügt werden.

weiter:

zurück:

Label

CheckboxGroup

Brit Schröter

public void add(String item)	Fügt ein Feld zum Choice-Menü hinzu. Parameter: item - Feld, das hinzugefügt werden soll Exception: *NullPointerException*, wenn der Feldwert Null ist
public void addItem(String item)	Fügt ein Feld zum Choice-Menü hinzu. Parameter: item - Feld, das hinzugefügt werden soll Exception: *NullPointerException*, wenn der Feldwert Null ist
public void addItemListener(ItemListener l)	Fügt den definierten ItemListener hinzu, um Ereignisse des Choice-Menüs verarbeiten zu können. Wenn l Null ist, wird kein Exception bearbeitet und nichts ausgeführt. Definiert durch: addItemListener im Interface *ItemSelectable* Parameter: l - ItemListener
public void addNotify()	Erzeugt ein Handle für das Choice-Menü. Dieses Handle ermöglicht es, das Aussehen des Choice-Menüs zu ändern, ohne seine Funktionalität zu ändern. Überschreibt: addNotify in der Klasse *java.awt.Component*
public int countItems()	Deprecated = nicht mehr gültig. Wurde ersetzt durch getItemCount().
public String getItem(int index)	Gibt die Beschriftung des durch den Index definieren Feldes zurück. Achtung! Der Index beginnt mit 0. Parameter: index - Index, wo begonnen werden soll
public int getItemCount()	Gibt die Anzahl der Felder des Choice-Menüs zurück.
public int getSelectedIndex()	Gibt den Index des ausgewählten Feldes zurück.
public String getSelectedItem()	Gibt die Definition des ausgewählten Feldes des Choice-Menüs als String zurück. Rückgabe: String, der die Definition des ausgewählten Feldes des Choice-Menüs enthält.
public Object[] getSelectedObjects()	Gibt ein Array mit der Länge l zurück, das das markierte Feld enthält. Wenn das Choice-Menü keine Felder hat, wird Null zurückgegeben. Definiert durch: Methode getSelectedObjects im Interface *ItemSelectable*
public void insert(String item, int index)	Fügt ein Feld in das Choice-Menü an der entsprechenden Stelle ein. Parameter: item - Bezeichnung des Feldes index - Stelle, an der das Feld eingefügt werden soll Exception: IllegalArgumentException, wenn index kleiner als 0 ist
protected String paramString()	Gibt einen String zurück, der den Status des Choice-Menüs wiedergibt. Dieser String ist für den Debugger nützlich. Rückgabe: Parameter-String des Choice-Menüs Überschreibt: Methode paramString der Klasse *java.awt.Component*
protected void processEvent(AWTEvent e)	Verarbeitet Ereignisse des Choice-Menüs. Wenn das Ereignis eine Instanz eines ItemEvent ist, ruft diese Methode die Methode processItemEvent 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 diesen Button 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 dem Choice-Menü, das sich an der Position befindet. Parameter: position - Position des Feldes
public void remove(String item)	Entfernt das Feld mit der Bezeichnung item. Parameter: item - Feld, das aus dem Choice-Menü entfernt werden soll Exception: IllegalArgumentException, wenn das Feld nicht existiert
public void removeAll()	Entfernt alle Felder aus dem Choice-Menü.
public void removeItemListener(ItemListener l)	Entfernt den definierten ItemListener, so daß er nicht weiter Ereignisse vom Choice-Menü empfangen kann. Wenn l Null ist, wird kein Exception verarbeitet und nichts ausgeführt. Definiert durch: removeItemListener im Interface *ItemSelectable* Parameter: l - ItemListener
public void select(int pos)	Markiert das Feld des Choice-Menüs, das durch die Position pos definiert ist. Parameter: pos Position des Feldes Exception: IllegalArgumentException - wenn die Position nicht existiert
public void select(String str)	Markiert das Feld des Choice-Menüs, dessen Bezeichnung mit str übereinstimmt. Haben mehrere Felder die gleiche Bezeichnung, wird das Feld markiert, das den kleinsten Index besitzt. Parameter: str - Bezeichnung/Feld, die Markiert werden soll