15.23 Texteingabefelder 

Das AWT und Swing bieten ganz unterschiedliche Texteingabefelder. Unter dem AWT war die Anzahl der Textkomponenten noch gering: ein Eingabefeld mit nur einer Eingabezeile (TextField) und eine Komponente, die mehrzeiligen Text (TextArea) aufnimmt. Beide Textkomponenten sind von einer gemeinsamen Oberklasse TextComponent abgeleitet.

Unter Swing sind eine Reihe von Textkomponenten hinzugekommen.

JTextField. Einzeilige Textfelder

JFormattedTextField. Einzeilge Textfelder mit Formatierungsvorgaben

JPasswordField. Einzeilige Eingabe mit verdeckten Zeichen

JTextArea. Mehrzeilige Textfelder

JEditorPane. Editor-Komponente

JTextPane. Spezialisierung der Editor-Komponente

Viele wichtige Methoden sind in der Oberklasse javax.swing.text.JTextComponent zu finden. Zwar liegt diese Klasse im Paket javax.swing.text, doch alle anderen Klassen liegen klassisch unter javax.swing.

15.23.1 Text in einer Eingabezeile 

Der Benutzer kann Eingaben in einem Textfeld machen, um etwa einen Namen einzugeben. Eine eigene Programmierung über ein Label, das Text-Ereignisse verarbeitet, können wir uns daher ersparen. Textfelder werden mit der Klasse JTextField erstellt. Unterschiedliche Konstruktoren legen einen Start-String oder die Anzahl der Zeichen fest, die ein Textfeld anzeigen kann.

JTextField wohnort = new JTextField( "Sonsbeck", 20 );

class javax.swing.  JTextField  
extends JTextComponent

JTextField() Erzeugt ein leeres Textfeld.

JTextField( int columns ) Erzeugt ein Textfeld mit einer gegebenen Anzahl Spalten.

JTextField( String text ) Erzeugt ein mit text initialisiertes Textfeld.

JTextField( String text, int columns ) Erzeugt ein mit text initialisiertes Textfeld mit columns Spalten.

15.23.2 Die Oberklasse der JText-Komponenten: JTextComponent 

Alle Texteingabefelder unter Swing sind von der abstrakten Oberklasse JTextComponent abgeleitet. Die wichtigsten Methoden sind setText(String) und getText(), mit denen sich Zeichenketten setzen und erfragen lassen.

class javax.swing.text.  JTextComponent  
extends JComponent
implements Scrollable, Accessible

String getText() Liefert den Inhalt des Textfelds.

String getText( int offs, int len ) Liefert den Inhalt des Textfelds von offs bis offs+len. Stimmen die Bereiche nicht, wird eine BadLocationException ausgelöst.

String getSelectedText() Liefert den selektierten Text. Keine Selektion ergibt die Rückgabe null.

void setText( String t ) Setzt den Text neu.

void read( Reader in, Object desc ) throws IOExceptionStores Liest den Inhalt aus dem Reader in das Textfeld. desc beschreibt den Datenstrom näher, kann aber null sein. Die read()-Methode erzeugt intern ein neues Document-Objekt und verwirft das alte.

void write( Writer out ) throws IOExceptionStores Schreibt den Inhalt des Textfelds standardmäßig als ASCII-Text in den Writer.

JTextField plz = new JTextField( 5 );
plz.setText( "47665" );

Das Caret

Der Cursor in einem Textfeld nennt sich Caret. Unterschiedliche Anfragen lassen sich an ein Textfeld stellen, um mehr über das Caret herauszufinden. Ein Listener kann an eine JTextComponent gehängt und ebenso kann das Caret frei bewegt werden.

class javax.swing.text.  JTextComponent  
extends JComponent
implements Scrollable, Accessible

int getCaretPosition(), setCaretPosition( int position ) Liefert beziehungsweise verändert die Position des Eingabe-Cursors.

Color getCaretColor(), void setCaretColor( Color c ) Liest oder ändert die Farbe des Carets.

textfield.setCaretPosition( textfield.getText().length() );

15.23.3 JPasswordField 

Das JPasswordField ist ein spezielles JTextField, welches die Zeichen nicht auf dem Bildschirm darstellt, sondern ein alternatives Zeichen zeigt, das so genannte Echozeichen. Standardmäßig ist das ein Sternchen. So lassen sich Passwort-Felder anlegen, die eine Eingabe verbergen.

JPasswordField pass = new JPasswordField( 15 );
pass.setEchoChar( ’#’ );
comp.add( pass );

Im Konstruktor geben wir die Länge der Textzeile an. Mit der Methode setEchoChar() lässt sich das Echozeichen festlegen.¹ 

Leider bleibt das Problem, dass die Sternchen auf die Anzahl der geheimen Zeichen schließen lassen.

Hier klicken, um das Bild zu Vergrößern

Abbildung 15.22   Das Passwort-Feld mit eigenem Echozeichen

15.23.4 Validierende Eingabefelder 

Textfelder, in denen Benutzer Zeichenfolgen eintragen, müssen oft die Eingabe validieren. So dürfen Zahlenfelder keine beliebigen Zeichen annehmen, sondern nur Ziffern und vielleicht Vorzeichen oder Dezimaltrenner. Komplizierte Felder wie ISBN-Nummern oder Datumsformate haben noch weitere Regeln. Eine Implementierung dieser Textfelder sieht häufig so aus, dass auf Tastatureingaben reagiert und sofort geprüft wird, ob alles in Ordnung ist, oder später nach einer actionPerformed(). Schlaue Programmierer nutzen gerne die parse()-Funktionen des Format-Objekts aus dem text-Paket, um die Beschränkungen zu prüfen.

Glücklicherweise gibt es seit Version 1.4 eine Zusammenfassung von Format und JTextField zu einer Komponente JFormattedTextField. Wollen wir eine Dezimalfeldeingabe schreiben, so geben wir im Konstruktor ein passendes DecimalFormat-Objekt an.

JFormattedTextField text = new JFormattedTextField( new DecimalFormat("#,###") );

Während der Eingabe testet der Formatter die Zeichenkette nicht auf ihre Korrektheit. Erst wenn der Benutzer zum Beispiel die Bestätigen-Taste drückt, wird die Eingabe überprüft. Nur dann, wenn die Eingabe korrekt ist, wird das ActionEvent verschickt. Das bedeutet, dass die Applikation nichts von den Fehleingaben mitbekommt und nur dann informiert wird, wenn die Eingabe richtig ist.

Listing 15.31   JFormattedTextField.java

import java.text.*;
import java.awt.*;
import java.awt.event.*;
import javax.swing.*;

public class JFormattedTextDemo
{
  public static void main( String args[] )
  {
    JFrame frame = new JFrame();
    frame.setDefaultCloseOperation( JFrame.EXIT_ON_CLOSE );
    frame.getContentPane().setLayout( new GridLayout(0,1) );

    ActionListener al =  new ActionListener() {
      public void actionPerformed( ActionEvent e ) {
        System.out.println( ((JFormattedTextField)e.getSource()).getText() );
    } };

    JFormattedTextField ftf1 = new JFormattedTextField(
                               new SimpleDateFormat("MM/dd/yy"));
    frame.getContentPane().add( ftf1 );
    ftf1.addActionListener( al );
    JFormattedTextField ftf2 = new JFormattedTextField(
                            new DecimalFormat("#,###"));
    frame.getContentPane().add( ftf2 );
    ftf2.addActionListener( al );

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

15.23.5 Mehrzeilige Textfelder 

Mit der Klasse JTextArea lassen sich mehrzeilige editierbare Textfelder erzeugen. Der Zeichensatz kann genau ein Attribut annehmen, das heißt die Schrift kann genau einer Farbe und genau einer Schriftart besitzen. Die JTextArea-Klasse stellt im Gegensatz zur AWT-Komponente TextArea keine automatischen Bildlaufleisten dar, eine Scroll-Eigenschaft muss nachträglich über ein JScrollPane realisiert werden.

Listing 15.32   JTextAreaDemo.java

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

class JTextAreaDemo
{
  static JTextArea t;
  static String    font = "SansSerif";
  static int       style = Font.PLAIN, size = 12;

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

    t = new JTextArea( "", 10, 40 );
    t.setFont( new Font(font, style, size) );
    f.getContentPane().add( t );

    ActionListener al = new ActionListener()
    {
      public void actionPerformed( ActionEvent e )
      {
        String cmd = e.getActionCommand();

        if ( cmd.equals("Ende") )
          System.exit( 0 );

        else if ( cmd.equals("fett") )
          style ^= Font.BOLD;
        else if ( cmd.equals("kursiv") )
          style ^= Font.ITALIC;

        t.setFont( new Font(font, style, size) );
      }
    };

    JPanel p = new JPanel( new GridLayout(1,3) );
    f.getContentPane().add( p, BorderLayout.NORTH );

    AbstractButton b;

    p.add( b = new JToggleButton("fett") );
    b.addActionListener( al );
    b.setFont( new Font("SansSerif", Font.BOLD, 12) );

    p.add( b = new JToggleButton("kursiv") );
    b.addActionListener( al );
    b.setFont( new Font("SansSerif", Font.ITALIC, 12) );

    p.add( b = new JButton("Ende") );
    b.addActionListener( al );

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

Die Zeile mit der Anweisung style ^= Font.BOLD dreht über den Xor-Operator das entsprechende Flag um. War in style das Bit von Font.BOLD vorher gesetzt, ist es nach der Xor-Operation gelöscht. Genauso ist es umgekehrt. War es nicht gesetzt, ist es anschließend gesetzt. Die Konstanten sind mit 1 (BOLD), 2 (ITALIC) vorbelegt. Also einmal Bit 1 und einmal Bit 2.

Hier klicken, um das Bild zu Vergrößern

Abbildung 15.23   Ein JTextArea

class javax.swing.  JTextArea  
extends JTextComponent

JTextArea() Ein neues JTextArea-Objekt wird erzeugt.

JTextArea( int rows, int columns ) Erzeugt ein neues Objekt mit gegebener Anzahl Zeilen und Spalten.

JTextArea( String text ) Erzeugt ein JTextArea-Objekt mit einem Starttext.

JTextArea( String, int rows, int columns ) Eine Kombination aus den beiden vorigen Konstruktoren.

Unterschiedliche Methoden erfragen das Layout und erlauben eine Änderung.

int getColumns(), int getRows() Gibt die Anzahl der Spalten und Zeilen an.

void setColumns( int colums ), void setRows( int rows ) Setzt die Anzahl der Spalten und Zeilen neu.

int getLineCount() Liefert die Anzahl der Zeilen.

Modifikationen des Textes sind ebenfalls möglich und gehen über die Methoden der Oberklasse JTextComponent hinaus.

void append( String str ) Hängt den String an den vorhandenen Text an. Diese Funktion steht in der Oberklasse JTextComponent nicht zur Verfügung.

void insert( String str, int pos ) Fügt den String an die Position pos ein.

void replaceRange( String str, int start, int end ) Ersetzt Text von start bis end durch den neuen Text str.

Scrolling

Wie üblich besitzt die JTextArea keine Schieberegler und muss zwecks Scrolling in eine JScrollPane eingebaut werden. Es ist praktisch zu wissen, dass sich einzelnen Schieberegler einer JScrollPane mit get[Vertical|Horinzontal]ScrollBar erfragen lassen. Denn wenn zum Beispiel am Ende etwas angehängt wird, scrollt die JTextArea nicht automatisch mit nach unten. Aber nach dem Einfügen können wir den vertikalen Schieberegler erfragen und von Hand den Wert auf das Maximum setzen:

JScrollBar bar = scrollPane.getVerticalScrollBar();
bar.setValue( bar.getMaximum() );

15.23.6 Die Editor-Klasse JEditorPane 

Die Klasse JEditorPane ist eine sehr leistungsfähige Textkomponente für verschiedene Textformate. Die Swing-Implementierung unterstützt HTML und Rich Text Format (RTF), eigene Implementierungen lassen sich ohne große Probleme ergänzen. Diese werden Editor-Kits genannt. Der Editor stellt Text dar, der ihm mit setContentType() übergeben wird. Das Editor-Kit wird dann mit setEditorKit() zugewiesen. Ohne eigene Erweiterungen sind »text/html« (Standard), »text/plain« und »text/rtf« erlaubt. Soll nur Text ohne Formatierungen und ohne Attribute dargestellt werden, lässt sich auch gleich JTextField verwenden.

Meistens wird ein JEditorPane über einen Konstruktor erzeugt, dem eine URL oder ein String mit einer URL übergeben wird. Für Programme mit Dateien auf dem lokalen Dateisystem wird dann die URL mit file:// beginnen. Wird mit dem Standard-Konstruktor gearbeitet, so kann später mit setPage() ein URL-Objekt oder ein String eine Seite neu belegen. Auch setText() erlaubt ein Setzen des Inhalts. Zu guter Letzt lässt sich der Editor auch mit einem InputStream über read() mit Inhalt füllen.

String url = "http://host/path";;
try {
  JEditorPane htmlPane = new JEditorPane( url );
  htmlPane.setEditable( false );
  container.add( new JScrollPane(htmlPane) );
} catch( IOException e ) {
  System.err.println( "Error displaying " + url );
}

class javax.swing.  JEditorPane  
extends JTextComponent

JEditorPane() Erzeugt einen neuen Editor.

JEditorPane( String url ), JEditorPane( URL url ) Erzeugt einen neuen Editor mit dem Inhalt, auf den die URL zeigt.

void setPage( String url ) , void setPage( URL page ) Zeigt eine neue Seite an.

void addHyperlinkListener( HyperlinkListener l ) Reagiert auf Aktivieren von Hyperlinks.

void removeHyperlinkListener( HyperlinkListener l ) Entfernt den Horcher.

Mit diesem Wissen lässt sich ein kleiner Web-Browser implementieren.

Listing 15.33   JBrowser.java

import javax.swing.*;
import javax.swing.event.*;
import java.io.*;
import java.net.*;

public class JBrowser extends JFrame implements HyperlinkListener
{
  JEditorPane htmlPane;

  JBrowser( String url )
  {
    htmlPane = new JEditorPane();
    htmlPane.setEditable( false );
    htmlPane.addHyperlinkListener( this );

    JScrollPane scrollPane = new JScrollPane( htmlPane );

    getContentPane().add( scrollPane );

    try
    {
      hyperlinkUpdate( new HyperlinkEvent(this,
                                          HyperlinkEvent.EventType.ACTIVATED,
                                          new URL(url) ) );
    }
    catch ( MalformedURLException e ) {}

    setSize( 600, 500 );
    setVisible(true);
  }

  public void hyperlinkUpdate( HyperlinkEvent event )
  {
    HyperlinkEvent.EventType typ = event.getEventType();

    if ( typ == HyperlinkEvent.EventType.ACTIVATED )
    {
      try
      {
        setTitle( ""+event.getURL() );
        htmlPane.setPage( event.getURL() );
      }
      catch( IOException e ) {
        JOptionPane.showMessageDialog( this,
                                      "Can’t follow link to "
                                        + event.getURL().toExternalForm(),
                                      "Error",
                                      JOptionPane.ERROR_MESSAGE );
      }
    }
  }

  public static void main( String args[] )
  {
    new JBrowser( "http://www.afu.com/intro.html"; );
  }
}

Hier klicken, um das Bild zu Vergrößern

¹   Wird das Echozeichen auf (char)0 gesetzt, erscheint die Eingabe nicht im Klartext. So macht es nur die AWT-Komponente TextField.