JLabel

Advanced Java Services

JLabel

Grundlegende Eigenschaften

Die Voreinstellung für die Transparenz ist durchsichtig.
Das Setzen einer Farbe wirkt sich nur auf undurchsichtige JLabels aus.
Ein JLabel kann bis zu zwei Icons haben. Höchstens eines ist sichtbar.
Es gibt ein Icon für den Zustand enabled und ein Icon für den Zustand disabled.
setText() von JLabel versteht HTML.
Die Voreinstellung für die Darstellung von Text ohne Bild ist linksbündig.
Die Voreinstellung für die Darstellung von Bild ohne Text ist linksbündig.
Die Voreinstellung für die Darstellung von Bild und Text ist: Bild linksbündig, Text rechts vom Bild mittig.
Die Voreinstellung für den Abstand zwischen Text und Bild ist 4 Pixel.
Wie jede Swingkomponente ist JLabel ein Container und kann ein Layout besitzen.
Die Voreinstellung ist null, also kein Layout.

Konstruktoren
JLabel()	Creates a JLabel instance with no image and with an empty string for the title.
JLabel(Icon image)	Creates a JLabel instance with the specified image.
JLabel(Icon image, int horizontalAlignment)	Creates a JLabel instance with the specified image and horizontal alignment.
JLabel(String text)	Creates a JLabel instance with the specified text.
JLabel(String text, int horizontalAlignment)	Creates a JLabel instance with the specified text and horizontal alignment.
JLabel(String text, Icon icon, int horizontalAlignment)	Creates a JLabel instance with the specified text, image, and horizontal alignment.

Einige Methoden
Returntyp	Name der Methode
Icon	getIcon() Returns the graphic image (glyph, icon) that the label displays.
void	setIcon(Icon icon) Defines the icon this component will display.
Icon	getDisabledIcon() Returns the icon used by the label when it's disabled.
void	setDisabledIcon(Icon icon) Set the icon to be displayed if this JLabel is "disabled" (JLabel.setEnabled(false)).
int	getHorizontalAlignment() Returns the alignment of the label's contents along the X axis.
void	setHorizontalAlignment(int alignment) Sets the alignment of the label's contents along the X axis.
int	getVerticalAlignment() Returns the alignment of the label's contents along the Y axis.
void	setVerticalAlignment(int alignment) Sets the alignment of the label's contents along the Y axis.
int	getHorizontalTextPosition() Returns the horizontal position of the label's text, relative to its image.
void	setHorizontalTextPosition(int textPosition) Sets the horizontal position of the label's text, relative to its image.
int	getVerticalTextPosition() Returns the vertical position of the label's text, relative to its image.
void	setVerticalTextPosition(int textPosition) Sets the vertical position of the label's text, relative to its image.
String	getText() Returns the text string that the label displays.
void	setText(String text) Defines the single line of text this component will display.

Zaubern mit HTML

Zunächst kann ein JLabel nur einen einzeiligen Text in einer Farbe anzeigen. Viele Swingkomponenten verstehen jedoch HTML und da JLabel zu ihnen gehört ist es ein leichtes JLabels mit mehreren Zeilen und mit unterschiedlicher Farbgestaltung zu zeigen. Das nachfolgende Applet zeigt im oberen Teil eine TextArea. Sie können hier den Text eingeben, den die setText()-Methode von JLabel umsetzen soll. Ein Buttondruck auf den Button "transfer text to label" übergibt den eingegebenen Text der setText()-Methode von JLabel. Mit den beiden anderen Buttons können sie zwei Beispieltexte in die TextArea bringen (und über den dritten Button dann auf das JLabel). Der erste Button liefert den Text von einem der berühmtesten Sonette von Shakespeare, der zweite Button bringt einen Auszug aus der API.

Alignment von Text und Bild

Wie schon aus der Methodenübersicht zu sehen gibt es die Möglichkeit sowohl den Text als auch das Bild horizontal und vertikal auszurichten. Das folgende Applet zeigt alle Möglichkeiten der Positionierung an. Durch Anklicken der Radiobuttons können Sie diese Möglichkeiten realisieren. des weiteren können Sie hier einen Rand für das Label ein- und ausschalten sowie mit dem Button set enabled bzw. set disabled für das Label die entsprechenden Zustände setzen und so auch das "Disabled Icon" angezeigt bekommen.