9.2 Beschriftungen (JLabel)

Die erste Komponente, die wir kennenlernen wollen, ist das javax.swing.JLabel. Es repräsentiert eine Zeichenkette oder ein Icon, die bzw. das der Benutzer nicht editieren kann. Zum Einsatz kommt die Beschriftung zum Beispiel in einer Dialogbox.

Wie jede andere Komponente wird auch JLabel mit der add()-Methode auf den Bildschirm gebracht. Labels lösen keine eigenen Events aus. Da aber JLabel eine Unterklasse von Component und JComponent ist, reagiert es auf Ereignisse wie das Erzeugen und auch auf Maus-Operationen.

Listing 9.4: com/tutego/insel/ui/swing/JLabelDemo.java

package com.tutego.insel.ui.swing;

import java.awt.Color;
import javax.swing.*;

public class JLabelDemo
{
  public static void main( String[] args )
  {
    JFrame frame = new JFrame();
    frame.setDefaultCloseOperation( JFrame.EXIT_ON_CLOSE );

    JLabel l = new JLabel( "Lebe immer First-Class, sonst tun es deine Erben!" );
    l.setForeground( Color.BLUE );
    frame.add( l );

    frame.pack();
    frame.setVisible( true );
  }
}

Abbildung 9.2: Ein Swing-Label

Im Nachhinein lässt sich der Text mit setText(String) ändern. Der Text wird sofort angezeigt, da das JLabel (das Gleiche gilt auch für andere Komponenten) einen Auftrag zur Neuzeichnung vergibt, sodass kurze Zeit später der neue Text – inklusive nötiger Neuausrichtung durch Größenänderungen – erscheint. Mit getText() lässt sich der aktuelle Text auslesen.

class javax.swing.JLabel
extends JComponent
implements SwingConstants, Accessible

• JLabel()
  Erzeugt ein leeres Label mit links angeordnetem Text.
• JLabel(String text)
  Erzeugt ein Label mit gegebenem Text.
• void setText(String text)
  Ändert die Aufschrift des Labels im laufenden Betrieb.
• String getText()
  Liefert den Text des Labels.

Grafik und Beschriftung

Anders als das AWT-Label kann Swings JLabel ein Bild (Icon) anzeigen. Hinzu kommt, dass sich Icon und Text auch gemeinsam verwenden lassen. Über verschiedene Möglichkeiten können horizontale und vertikale Positionen vom Text relativ zum Icon gesetzt werden. Auch die relative Position des Inhalts innerhalb der Komponente lässt sich spezifizieren. Die Voreinstellung für Labels ist eine zentrierte vertikale Darstellung im angezeigten Bereich. Enthalten die Labels nur Text, so ist dieser standardmäßig linksbündig angeordnet, und Bilder sind horizontal zentriert. Ist keine relative Position des Textes zum Bild angegeben, befindet sich der Text standardmäßig auf der rechten Seite des Bilds, und beide sind auf der Vertikalen angeordnet. Der Abstand von Bild und Text lässt sich beliebig ändern und ist im Standard-Look and Feel mit 4 Pixeln vordefiniert.

class javax.swing.JLabel
extends JComponent
implements SwingConstants, Accessible

• JLabel(Icon icon)
  Erzeugt ein Label mit links angeordnetem Icon.
• String getIcon()
  Liefert das Icon.
• void setIcon(Icon icon)
  Ändert das Icon.

Text und Ausrichtung des JLabel

Neben dem Standard-Konstruktor, der einen leeren String schreibt, existiert eine weitere Variante neben dem Konstruktor mit Textinhalt, der die Ausrichtung des Labels angibt. Diese kann LEFT – dies ist voreingestellt –, CENTER, RIGHT, LEADING oder TRAILING sein.

class javax.swing.JLabel
extends JComponent
implements SwingConstants, Accessible

• JLabel(String text, int horizontalAlignment)
  Erzeugt ein Label mit ausgerichtetem Text. horizontalAlignment ist eine der Konstanten JLabel.LEFT, JLabel.RIGHT, JLabel.CENTER, JLabel.LEADING oder JLabel.TRAILING. Wird die Größe der Komponente, auf der das Label liegt, neu berechnet, so passt sich auch die Position neu an.
• JLabel(Icon icon, int horizontalAlignment)
  Erzeugt ein Label mit Icon und horizontaler Anordnung.
• JLabel(string text, Iconicon, int horizontalAlignment)
  Erzeugt ein Label mit Text und Icon und horizontaler Anordnung.
• JLabel(String, int alignment)
  Erzeugt ein Label mit ausgerichtetem Text. alignment ist eine der Konstanten JLabel.LEFT, JLabel.RIGHT, JLabel.CENTER, JLabel.LEADING oder JLabel.TRAILING. Wird die Größe der Komponente, auf der das Label liegt, neu berechnet, so passt sich auch die Position neu an.
• int getHorizontalAlignment()
  Liefert die Ausrichtung zurück.
• void setHorizontalAlignment(int alignment)
  Setzt die Ausrichtung des Labels. Mögliche Werte entsprechen denen im Konstruktor.

Genutzter Zeichensatz des Textes *

Der gesetzte Text wird im zugewiesenen Zeichensatz des Swing-Look-and-Feels angezeigt. Um diesen zu ändern, müssen wir ein neues Font-Objekt erzeugen. Auf zwei Arten lässt sich dieser Font setzen: global für alle JLabel-Elemente oder lokal nur für dieses eine. Die erste Lösung arbeitet über das UIDefaults-Objekt, das die Einstellungen wie Zeichensätze und Farben für alle Swing-Elemente verwaltet:

UIDefaults uiDefaults = UIManager.getDefaults();
uiDefaults.put( "Label.font",
               ((Font)uiDefaults.get("Label.font")).deriveFont(30f) );

Unter dem Schlüssel »Label.font« legen wir ein neues Font-Objekt ab und überschreiben die alte Definition. Den neuen Font mit der Größe 30 leiten wir mit deriveFont() vom alten ab, sodass wir den Zeichensatz »erben«.

Die zweite Lösung kann darin bestehen, den Font direkt mit der setFont()-Methode zu setzen:

JLabel l = new JLabel( "Lebe immer First-Class, sonst tun es deine Erben!" );
l.setFont( new Font("Serif", Font.BOLD, 30) );

Einen speziellen Konstruktor, der ein Font-Objekt als Argument annimmt und dieses verwendet, gibt es nicht.

9.2.1 Mehrzeiliger Text, HTML in der Darstellung

Sporadisch tritt das Problem auf, dass ein Text mit Zeilenumbruch gesetzt werden soll, etwa bei Dialogen, die mehrzeilige Meldungen anzeigen. Eine Anweisung wie new JLabel("erste Zeile\nzweite Zeile"); führt allerdings nicht zum Ziel, weil Swing die Zeilenumbruchzeichen nicht beachtet. Eine einfache Lösung für das Problem besteht in der Nutzung von HTML; im Labeltext schreiben wir einfach:

JLabel l = new JLabel( "<html>Huhu.<p/>Jetzt bin ich hier.</html>" );

HTML kann auch über ein Cascading Stylesheet formatiert werden. Das minimiert Formatierungsanweisungen und erlaubt eine zentrale Veränderung der Darstellungsattribute.

Falls die Applikation nicht auf Swing aufbaut, besteht eine Lösung darin, die TextArea-Klasse zu nehmen und den Rahmen auszublenden. Eine andere Möglichkeit wäre, eine Hilfsmethode zu bauen, die den Text auseinandernimmt und ihn in mehrere Zeilen aufteilt.

Ihr Kommentar

Wie hat Ihnen das <openbook> gefallen? Wir freuen uns immer über Ihre freundlichen und kritischen Rückmeldungen.