15.5 Ein Informationstext über die Klasse JLabel

Die Klasse javax.swing.JLabel ist eine der einfachsten Komponenten in Swing. Sie repräsentiert eine Zeichenkette, die der Benutzer nicht editieren kann. Zum Einsatz kommt das Label zum Beispiel in einer Dialogbox. Unter dem AWT repräsentiert die Klasse java.awt.Label ein Informationsfeld. Im Gegensatz zur Implementierung aus dem AWT kann unter Swing auch ein Bild (Icon) angezeigt werden. Dies sind jedoch keine Image-Objekte, sondern Objekte der Klasse Icon. Als Ergänzung kommt hinzu, dass sich auch Icon und Text gemeinsam verwenden lassen. Über verschiedene Möglichkeiten lassen sich horizontale und vertikale Positionen vom Text relativ zum Icon setzen. 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 mit vier Pixeln vordefiniert.

Hier klicken, um das Bild zu Vergrößern

Abbildung 15.3 Ein Swing-Label

Anstatt die JLabel-Klasse zu nutzen, hätten wir selbstverständlich auch mit drawString() eine Zeichenkette schreiben können. Doch Label bietet den Vorteil, dass wir von paint() befreit werden und die paint()-Methode für andere Aufgaben frei bleibt. So übernimmt das AWT das Zeichnen und passt den Text in der Breite des Containers an. Über drawString() hätten wir dann erst die Koordinaten berechnen müssen, und dies wäre besonders bei komplexeren Oberflächen umständlicher Rechenaufwand.

Wie jede andere Komponente wird auch diese 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 sie auf Ereignisse wie das Erzeugen und auch auf Maus-Operationen.

Listing 15.6 JLabelDemo.java

import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
public class JLabelDemo
{
  public static void main( String args[] )
  {
    JFrame frame = new JFrame();
    
    JLabel l = new JLabel( "Lebe immer First-Class, sonst tun es Deine Erben!" );
    l.setFont( new Font("Serif", Font.BOLD, 30) );
    l.setForeground( Color.blue );
    
    frame.getContentPane().add( l );
    
    l.addMouseListener( new MouseAdapter() {
          public void mouseClicked( MouseEvent e ) {
            if ( e.getClickCount() > 1 )
              System.exit( 0 );
          }
        } );
    
    frame.pack();
    frame.show();
  }
}

Genutzter Zeichensatz des Textes

Der gesetzte Text wird im aktuellen Zeichensatz angezeigt. Um diesen zu ändern, müssen wir ein neues Font-Objekt erzeugen und dieses mit der setFont()-Methode setzen. Wir können uns entscheiden, ob wir den Zeichensatz einer Komponente zuweisen wollen oder allen folgenden Elementen des Containers. Denn so legen wir fest, wo wir setFont() nutzen: Entweder wir rufen setFont() als Methode von Frame (und somit von Component) auf und bestimmen somit alle nachfolgenden Objekte mit einem Zeichensatz oder wir rufen label.setFont() auf und setzen dann nur den Zeichensatz des konkreten Label-Objekts. Sollen verschiedene Zeichensätze verwendet werden, sind diese immer vor dem Erzeugen des Labels zu setzen. Einen speziellen Konstruktor, der ein Font-Objekt als Parameter annimmt und diesen verwendet, gibt es nicht - eine solche Methode ist aber schnell geschrieben und ganz praktisch.

Ausrichtung des JLabels

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. Im Nachhinein lässt sich der Text mit setText(String) ändern. Der Text wird aber erst dann angezeigt, wenn die Komponente neu gezeichnet wird. Mit getText() lässt sich der aktuelle Text auch auslesen. Hier sehen wir, dass es typische Methoden für grafische Komponenten sind.

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.

JLabel( Icon icon ) Erzeugt ein Label mit links angeordnetem Icon.

JLabel( String text, int horizontalAlignment ) Erzeugt ein Label mit gewünschtem angeordnetem Text.

JLabel( Icon icon, int horizontalAlignment ) Erzeugt ein Label mit gewünschtem angeordnetem Icon.

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.

String getText() Liefert den Text des Labels.

void setText( String text ) Ändert die Aufschrift des Labels im laufenden Betrieb.

String getIcon() Liefert das Icon.

void setIcon( Icon icon ) Ändert das Icon.

int getHorizontalAlignment() Liefert die Ausrichtung zurück.

void setHorizontalAlignment( int alignment ) Setzt die Ausrichtung des Labels. Mögliche Werte entsprechen denen im Konstruktor.

15.5.1 Mehrzeiliger Text

Sporadisch tritt das Problem auf, dass ein Text mit Zeilenumbruch gesetzt werden soll, so wie es bei Dialogen vorkommt, die mehrzeilige Antworten bereithalten. Leider führt eine Anweisung wie

new JLabel( "erste Zeile\nzweite Zeile" );

sowohl bei den neuen Swing-Objekten als auch bei den alten Peer-basierten Komponenten nicht zum Ziel. Um dies zu erreichen, muss ein anderer Weg eingeschlagen werden, denn »\n« besitzt in einem Label keine Bedeutung. Falls wir Swing nutzen, kann mittels HTML-Tags auch mehrzeiliger Text gesetzt werden. Im Labeltext schreiben wir dann einfach

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

Falls wir kein Swing verwenden, besteht eine Lösung darin, die TextArea-Klasse zu nehmen. Eine andere Möglichkeit wäre, eine Hilfsfunktion zu bauen, die den Text auseinander nimmt und ihn in mehrere Zeilen aufteilt.