Advanced   Java   Services

Label, Button, Checkbox

Label

Ein Label ist die einfachste Komponente. Die API sagt: A Label object is a component for placing text in a container. A label displays a single line of read-only text. The text can be changed by the application, but a user cannot edit it directly. Ein Label erbt die weitaus meisten Methoden von Component.

Konstanten
Typ	Name der Konstante
static int	CENTER Indicates that the label should be centered.
static int	LEFT Indicates that the label should be left justified.
static int	RIGHT Indicates that the label should be right justified.

Konstruktoren
Label()	Constructs an empty label.
Label(String text)	Constructs a new label with the specified string of text, left justified.
Label(String text, int alignment)	Constructs a new label that presents the specified string of text with the specified alignment.

Methoden
Returntyp	Name der Methode
String	getText() Gets the text of this label.
void	setText(String text) Sets the text for this label to the specified text.
int	getAlignment() Gets the current alignment of this label.
void	setAlignment(int alignment) Sets the alignment for this label to the specified alignment.

Ein Label initialisieren und in einen Container aufnehmen

Ist der Container ein Panel, so benützt man die add-Methode mit einem Parameter, da das Defaultlayout ein FlowLayout ist (siehe Layout).

Panel panel = new Panel();
Label label = new Label("Ich bin ein Label");

panel.add(label);

Ist der Container ein Frame, so benützt man die add-Methode mit zwei Parametern, da das Defaultlayout ein BorderLayout ist (siehe Layout).

Frame frame = new Frame();
Label label = new Label("Ich bin eine Statuszeile");

frame.add(label, BorderLayout.SOUTH);

Die Farbe eines Labels

Setzt man keine eigene Farbe, so übernimmt das Label die Farbe des Containers, in dem es liegt.


Button

Ein Button ist ... ein Button. Er kann einen Text tragen und: The application can cause some action to happen when the button is pushed.

Konstruktoren
Button()	Constructs a Button with no text.
Button(String text)	Constructs a Button with the specified string of text.

Methoden
Returntyp	Name der Methode
Eventhandling
void	addActionListener(ActionListener l) Adds the specified action listener to receive action events from this button.
void	removeActionListener(ActionListener l) Removes the specified action listener so that it no longer receives action events from this button.
ActionListener[]	getActionListeners() Returns an array of all the action listeners registered on this button.
weitere Methoden
String	getLabel() Gets the label of this button.
void	setLabel(String label) Sets the button's label to be the specified string.
String	getActionCommand() Returns the command name of the action event fired by this button.
void	setActionCommand(String command) Sets the command name for the action event fired by this button.

Hinweis

Die Methode, die einen Text auf den Button bringt heißt hier setLabel() und nicht setText() wie bei einem Label. Das ist schlicht ein Fehler im objektorientierten Design. In Swing heißt es einheitlich für JLabel und JButton setText().

Einen Button initialisieren und in einen Container aufnehmen

Ist der Container ein Panel, so benützt man die add-Methode mit einem Parameter, da das Defaultlayout ein FlowLayout ist (siehe Layout).

Panel panel = new Panel();
Button knopf = new Button("Drück mich");

panel.add(knopf);

Ist der Container ein Frame, so benützt man die add-Methode mit zwei Parametern, da das Defaultlayout ein BorderLayout ist (siehe Layout).

Frame frame = new Frame();
Button knopf = new Button("Mich auch !");

frame.add(knopf, BorderLayout.CENTER);

Die Farbe eines Buttons

Ein Button hat eine eigene Farbe (Color.lightGray), er übernimmt daher nicht die Farbe des Containers, in dem er liegt.

Auf einen Button reagieren

Dies fällt unter das Thema Eventhandling und wird dort gezeigt.


Checkbox

Eine Checkbox kann man anhaken und "aushaken". Sie hat also zwei Zustände was man durch eine boolesche Variable modelliert. Angehakt entspricht true, nicht angehakt false. Für jeden Zustand kann man eine Reaktion kodieren. Eine Checkbox kann einen einzeiligen Text tragen.

Konstruktoren
Checkbox()	Creates a check box with no text.
Checkbox(String text)	Creates a check box with the specified string of text.
Checkbox(String text, boolean state)	Creates a check box with the specified string of text and sets the specified state.
Checkbox(String text, boolean state, CheckboxGroup group)	Creates a check box with the specified string of text, sets the specified state, and in the specified check box group.

Methoden
Returntyp	Name der Methode
Eventhandling
void	addItemListener(ItemListener l) Adds the specified item listener to receive item events from this check box.
void	removeItemListener(ItemListener l) Removes the specified item listener so that the item listener no longer receives item events from this check box.
ItemListener[]	getItemListeners() Returns an array of all the item listeners registered on this checkbox.
weitere Methoden
String	getLabel() Gets the label of this checkbox.
void	setLabel(String label) Sets the checkbox's text to be the specified string.
boolean	getState() Determines whether this check box is in the "on" or "off" state.
void	setState(boolean state) Sets the state of this check box to the specified state.
CheckboxGroup	getCheckboxGroup() Determines this check box's group.
void	setCheckboxGroup(CheckboxGroup g) Sets this check box's group to be the specified check box group.

Hinweis

Die Methode, die einen Text auf eine Checkbox bringt heißt hier setLabel() und nicht setText() wie bei einem Label. Das ist schlicht ein Fehler im objektorientierten Design. In Swing heißt es einheitlich für JLabel und JButton und JCheckbox setText().

Eine Checkbox initialisieren und in einen Container aufnehmen

Ist der Container ein Panel, so benützt man die add-Methode mit einem Parameter, da das Defaultlayout ein FlowLayout ist (siehe Layout).

Panel panel = new Panel();
Checkbox check = new Checkbox("Ich habe einen Haken", true);

panel.add(check);

Ist der Container ein Frame, so benützt man die add-Methode mit zwei Parametern, da das Defaultlayout ein BorderLayout ist (siehe Layout).

Frame frame = new Frame();
Checkbox check = new Checkbox("Ich habe keinen Haken");

frame.add(check, BorderLayout.NORTH);

Die Farbe einer Checkbox

Setzt man keine eigene Farbe, so übernimmt die Checkbox die Farbe des Containers, in dem es liegt.

Auf eine Checkbox reagieren

Dies fällt unter das Thema Eventhandling und wird dort gezeigt.


Radiobuttons

Man kann mehrere Checkboxen zu einer Gruppe zusammenfassen. Dazu gibt es die Klasse CheckboxGroup. Man legt ein Objekt vom Typ CheckboxGroup an und teilt den Checkboxen mit, daß sie zu dieser CheckboxGroup gehören. Dadurch verändern die Checkboxen ihr Aussehen und werden zu RadioButtons. Genau einer oder keiner der Radiobuttons kann anfänglich markiert sein. Der Benutzer kann genau einen Radiobutton pro Gruppe auswählen.


CheckboxGroup

Konstruktoren
CheckboxGroup()	Creates a new instance of CheckboxGroup.

Methoden
Returntyp	Name der Methode
weitere Methoden
Checkbox	getSelectedCheckbox() Gets the current choice from this check box group.
void	setSelectedCheckbox(Checkbox box) Sets the currently selected check box in this group to be the specified check box.

Radiobuttons initialisieren und in einen Container aufnehmen

CheckboxGroup cbg = new CheckboxGroup();
box1 = new Checkbox("Hund", false, cbg);
box2 = new Checkbox("Katze", true, cbg);
box3 = new Checkbox("Hamster", false, cbg);

Panel panel = new Panel();
panel.add(box1);
panel.add(box2);
panel.add(box3);

Die Farbe von Radiobuttons

Setzt man keine eigene Farbe, so übernehmenm die Radiobuttons die Farbe des Containers, in dem sie liegen.

Auf Radiobuttons reagieren

Dies fällt unter das Thema Eventhandling und wird dort gezeigt.